n11 bağlama

n11 bağlantısı için satıcı panelinizden iki anahtar almanız gerekir.

Bilgileri nereden alacaksınız?

n11 Mağaza Paneli > Entegrasyonlar / API İşlemleri bölümünden:

• API Key (appkey)
• API Secret (appsecret)

Panelde Entegrasyonlar > N11 > Bağla deyip iki değeri girin.

Bağlandıktan sonra

1. Ürünlerinizi Ürünler > İçe aktar ile panele indirin.
2. Yeni ürün göndermek istiyorsanız kategori eşlemesi yapın.
3. Kategori eşleme ekranının altındaki n11 ayarlarını doldurun:
   • Kargo şablonu adı — n11 panelinizde tanımlı şablonun birebir adı. Yanlış yazılırsa ürün gönderimi reddedilir.
   • Hazırlık günü — siparişi kargoya vermek için kaç gününüz olduğu.

Bilinmesi gerekenler

• Yalnız değişen gider. Ürünü kaydettiğinizde açıklama ya da KDV oranı yalnız panelde değiştiyse n11'e gönderilir; değişmeyen bilgi için n11'e istek atılmaz.
• Ürün gönderimi asenkrondur: n11 isteği alır, işlem sonucunu sonra üretir. Panel gönderim numarasını (task) kaydeder; ürün birkaç dakika içinde n11'de görünür.
• Stok ve fiyat güncellemesi de asenkrondur — anında yansımayabilir.
• "Bu stok koduyla mağazanızda ürün yok" cevabı: ilan n11'de hiç açılamamış ya da silinmiş demektir. Panel ilanı kanalda yok işaretler ve stok/fiyat göndermeyi durdurur; ürün kartından Kanala gönder deyip ilanı yeniden açtığınızda işaret kalkar. Bkz. Kanala gönderme.
• Sipariş durumu: n11'de satıcının bildirebildiği ilk adım "Hazırlanıyor"dur; kargo bildirimi takip numarası oluştuğunda yapılır.
• Komisyon oranları sipariş paketlerinden okunur. n11'de fiili oran, komisyon oranından satıcıya özel kampanya indirimi düşülerek bulunur; panel bu hesabı kendisi yapar. Bkz. Komisyon ve kâr.
• n11 geriye dönük sorguları sınırlar (yaklaşık 14 gün); çok eski siparişler çekilemez.

Siparişler ne sıklıkla gelir?

n11 anlık sipariş bildirimi (webhook) sunmuyor — resmî entegrasyon dokümanında böyle bir uç yer almıyor. Bu yüzden panel n11'ı düzenli olarak kendisi yoklar: 5 dakikada bir yeni siparişler çekilir.

Pratikte fark şu: bir satış panele en geç 5 dakika içinde düşer. Aynı ürünün son adedini o aralıkta başka bir kanal da satarsa stok eksiye düşebilir. Bunu azaltmak isterseniz Ürünler > ürün kartında emniyet payı verebilirsiniz (kanallara gösterilmeyen tampon adet).

n11 ileride bildirim desteği verirse panel kendiliğinden kullanmaya başlar.

Siparişler ne sıklıkla gelir?

n11 satıcı servislerinde anlık sipariş bildirimi (webhook) yoktur; panel n11'i 5 dakikada bir yoklar ve saatte bir daha geniş bir pencereyle tarayarak iptal/iade gibi sonradan değişen durumları da yakalar.