İstek yapısı
Gövde, diğer görev servisleri gibi payload altında integrator ve skus alanlarından oluşur. Stok güncellemesinde kullanılan alanlar şunlardır:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| integrator | Evet | Entegratör adı; bütün gönderimlerde aynı değer |
| stockCode | Evet | Ürünü seçen satıcı stok kodu |
| quantity | Hayır | Yeni stok adedi (tam sayı) |
| salePrice, listPrice | Hayır | Fiyat da değişecekse ikisi birlikte |
| currencyType | Hayır | TL, USD ya da EUR |
Örnek satır: stockCode: STOK_KODU, quantity: 7. İstekte olmayan alanlar için güncelleme yapılmaz. Yani yalnız quantity gönderirseniz fiyat değişmez.
Yanıt şu alanları döndürür: id (görev numarası), type: SKU_UPDATE, status: IN_QUEUE ya da REJECT ve reasons. Kabul edilen bir istekte reasons alanında "X sku işlenmeye alındı" yazar.
Sonucu doğrulamak
IN_QUEUE stok değişti demek değildir. Görev numarasıyla task detayını sorgulayın. Her stok kodu için itemCode, status (SUCCESS ya da FAIL), reasons ve sku bloğundaki stock alanı döner. FAIL olan satırların stoğu değişmemiştir.
En sık FAIL nedeni, stok kodunun mağazada bulunmamasıdır. Ürün hiç yüklenmemişse ya da stok kodu panelde farklı yazılmışsa güncelleme eşleşmez. Büyük-küçük harf ve baştaki sıfır gibi farklara dikkat edin.
Çok kanallı satışta stok güncelleme
N11'i başka pazaryerleri ya da kendi sitenizle birlikte kullanıyorsanız stok güncellemesi bir senkron sorunudur. Bir kanaldaki satış diğer kanallara ne kadar geç yansırsa olmayan ürünü satma riski o kadar artar.
- Mutlak adet gönderin: Servis artırma ya da azaltma değil, yeni adet alır. Her seferinde ürünün güncel toplam stoğunu gönderin.
- Tek stok kaynağı belirleyin: Adedi hangi sistemin doğru kabul edeceğini netleştirin. Aksi hâlde iki sistem birbirinin yazdığını ezer.
- Paketleri büyütmeyin: Görev 1.000 SKU alır ama çok büyük paketlerde yanıt süresi uzayabilir. Zaman aşımı görürseniz paketi küçültün.
- Sıfır stok gönderimini ayrıca izleyin: Yanlışlıkla gönderilen sıfır, ürünü satılamaz hâle getirir. Toplu sıfırlamalarda önce listeyi kontrol edin.
Konuyu satıcı gözüyle anlatan yazımız: N11 ve Çiçeksepeti stok güncelleme.
Sık hatalar
- REJECT'i görmemek: HTTP 200 alındığında görev reddedilmiş olabilir; status alanını okuyun.
- N11 ürün numarasını göndermek: Servis n11ProductId değil, stockCode ister.
- Ondalıklı adet: quantity tam sayıdır.
- Fiyatı yarım göndermek: Aynı istekte fiyat da güncellenecekse salePrice ve listPrice birlikte gitmelidir. Ayrıntı: N11 fiyat güncelleme.
- Eski SOAP metodunu aramak: UpdateStockByStockSellerCode gibi SOAP stok metotları Ocak 2025'te kapatıldı.
Sık sorulanlar
N11'de stok API ile nasıl güncellenir?
POST /ms/product/tasks/price-stock-update isteğinde her ürün için stockCode ve quantity gönderilir. Yanıttaki görev numarasıyla sonuç task detayından kontrol edilir.
Yalnız stok gönderirsem fiyat değişir mi?
Hayır. N11 dokümanına göre istekte olmayan alanlar güncellenmez. Yalnız quantity gönderdiğinizde fiyat olduğu gibi kalır.
Tek istekte kaç ürünün stoğu güncellenir?
En fazla 1.000 SKU. Çok büyük paketlerde yanıt süresi uzayabileceği için daha küçük paketlerle göndermek pratikte daha güvenlidir.
Stok güncellemesi neden FAIL döner?
En sık neden, gönderilen stok kodunun mağazada bulunmamasıdır. Task detayındaki reasons alanı nedeni yazar; kodu paneldeki stok koduyla karşılaştırın.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı