N11 entegrasyonu
Sipariş, stok ve fiyat N11 ile akar. N11’in hakediş satırı kalem kalem okunur — komisyon oranı, kesintiler ve ayrı gelen kargo bedeli — ve defterinizdeki faturayla karşılaştırılır.
N11 hakediş satırı · nasıl okunur
paymentAmount- 1.050,00
- Satış tutarı
commission- 14
- Oran: %14 → 147,00 ₺ · tutar değil, oran
deductionAmount- 181,20
- Komisyon + hizmet + stopaj
cargoPrice- 38,40
- Kargo, kesintinin dışında · ayrı kalem
settlementAmount- 830,40
- Hesabınıza yatan
1.050,00 − 181,20 − 38,40 = 830,40 Kargo kendi kaleminde karşılaştırılır; hakediş kargo kadar fazla görünmez.
Hakediş mutabakatı
Komisyon oranla, kargo kendi kaleminde
N11 hakediş satırındaki komisyon bir tutar değil, orandır. Senkro tutarı satış tutarından hesaplar ve siparişin kendi komisyon oranıyla ayrıca sağlar. Kargo bedeli kesinti toplamının dışında geldiği için ayrı bir kalem olarak okunur.
Sonuç, defterinizdeki faturayla satır satır yan yana gelir; tutmayan satır kalemi ve sebebiyle görünür.
N11 sipariş #N11-20417
komisyon sağlaması
| Kalem | N11 hakedişi | Karşılaştırma | Siparişe göre |
|---|---|---|---|
| Satış tutarı | 1.200,00 | tutuyor | 1.200,00 |
| Komisyon oranı | %16 | tutmuyor | %14 |
| Komisyon | −192,00 | tutmuyor | −168,00 |
| Kargo, ayrı kalem | −38,40 | tutuyor | −38,40 |
| Hesabınıza yatan | 969,60 | tutmuyor | 993,60 |
24,00 ₺ fazla kesildi: hakedişteki komisyon oranı siparişin kendi oranından 2 puan yüksek. Kargo kendi kaleminde tutuyor.
Ne senkronlanır?
Aşağıdaki alan adları N11 tarafının kendi adlarıdır; hangi verinin hangi adla taşındığı burada görünür.
N11’den okunanlar
- Ürün ve varyantlar
-
n11ProductIdstockCodebarcodetitlequantitysalePricelistPriceBarkod ve stok kodu, ürünü defterdeki stok kartıyla eşleştirir. - Siparişler
-
orderNumbershipmentPackageStatustotalAmountcommissionRatesellerInvoiceAmountSipariş satırındaki komisyon oranı, hakedişteki kesintinin bağımsız sağlamasıdır. - İade talepleri
-
claimReturnIdorderNumberrequestDatereturnReasonType - Hakediş
-
paymentAmountcommissiondeductionAmountcargoPricesettlementAmountsettlementDateKarşılaştırmanın kaynağı bu. Tanınmayan yeni bir kesinti alanı gelirse sessizce yutulmaz, kayda geçer.
N11’e yazılanlar
- Stok ve fiyat
-
stockCodequantitysalePricelistPriceStok ve fiyat tek istekte, en çok 1.000 kalem gider. N11 sonucu hemen değil, verdiği taskId üzerinden bildirir; yalnız işlenmiş sonuç geçerli sayılır. - Fatura bağlantısı
-
orderNumberurlDefterinizde kesilen faturanın bağlantısı siparişe iliştirilir.
Kurulum dört adımda
Kurulumu birlikte yaparız: ekranı birlikte açar, adım adım ilerleriz. Anahtarlar sizde kalır.
Gözlem modu
yeni N11 bağlantısının başlangıç hâli
- Siparişi, stoğu, fiyatı ve hakedişi okuma
- Açık
- Hakedişi defterinizle karşılaştırma
- Açık
- Pazaryerine stok, fiyat ve durum gönderme
- Kapalı
- Siparişin faturasını defterinize kesme
- Kapalı
Yazmayı siz açarsınız — pazaryeri ve defter için, her bağlantıda ayrı ayrı. Açana kadar Senkro hiçbir kaydınızı değiştirmez.
-
N11 API anahtarınızı siz üretirsiniz
Mağaza panelinizden API anahtarı ve şifresini üretirsiniz. N11’de yeni anahtar eskisini iptal eder; mevcut programınız aynı anahtarı kullanıyorsa sırayı birlikte planlarız.
-
Bağlantı kurulur, test görülür
Bilgileri Senkro’ya girdiğinizde bağlantı testi çalışır. Anahtar çalışmıyorsa bunu kurulum anında görürsünüz.
-
İlk tarama kataloğu ve siparişleri çeker
Siparişler 14 günlük dilimlerle okunur; sonrasında yalnız değişenler alınır. Yarıda kalan tarama tamamlanmış sayılmaz.
-
Defter bağlanınca karşılaştırma başlar
Defter bağlantısı kurulduğunda N11 hakedişi ile defteriniz yan yana gelir.
Bunları yapmıyoruz
Aşağıdakiler bugünün ölçülmüş sınırlarıdır; değiştiğinde bu satırlar da güncellenir.
-
N11’de ürün açılmaz
Var olan ürünlerin stoğu ve fiyatı yönetilir; yeni ürünü N11 panelinden açarsınız.
-
Sipariş durumu N11’e yazılmaz
Kargo ve teslim adımlarını N11 panelinden yürütürsünüz; Senkro durumu okur ve izler. N11 bildirim göndermediği için değişiklikler düzenli aralıklarla sorulur.
-
14 günden uzun aralık tek seferde okunmaz
N11 sipariş ucu 14 günü aşan aralıkta hata değil boş cevap döndürür. Senkro aralığı 14 günlük dilimlere böler; boş cevabı “sipariş yok” saymaz.
-
Kapsamın eksiksiz olduğu iddia edilmez
Okunamayan dönem size bildirilir. Okunan dönemlerin eksiksiz olduğu ise kanıtlanamaz: eksik gösterilebilir, tamlık kanıtlanamaz.
Şu an kullandığım entegratörü bırakmam gerekiyor mu?
Hayır. Bağlantı gözlem modunda açılır: Senkro yalnızca okur, N11’e hiçbir şey göndermez. Tek dikkat noktası anahtar: N11’de yeni anahtar üretmek eskisini iptal eder. Mevcut programınız aynı anahtarı kullanıyorsa geçişin sırasını kurulumda birlikte planlarız.
N11 hakedişindeki komisyon neden ayrıca hesaplanıyor?
Hakediş satırındaki komisyon alanı bir tutar değil, orandır. Senkro tutarı satış tutarından hesaplar ve siparişin kendi komisyon oranıyla karşılaştırır; iki kaynak birbirini tutmazsa fark görünür.
Kargo bedeli nerede görünüyor?
N11 kargo bedelini kesinti toplamının dışında, ayrı bir alanda verir. Senkro onu siparişin kargo kalemi olarak okur; hakediş kargo kadar fazla ya da eksik görünmez.
İadeler nasıl takip ediliyor?
İade talepleri N11’den okunur ve siparişle eşleştirilir. N11 iade onayını kalem kalem değil talep bazında verdiği için onay N11 panelinden yapılır.
Bunlarla birlikte çalışır
Siparişten hakedişe rakamın tutması için satış tarafı ile defter tarafının birlikte bağlı olması gerekir; N11 zincirin bir halkasıdır.