N11 REST API’de fiyat ve stok güncelleme: kurallar ve tuzaklar
N11’in yeni REST servisinde fiyat ve stok güncelleme: uç nokta, appKey/appSecret başlıkları, 1.000 SKU sınırı ve isteği sessizce FAIL’e düşüren ondalık kuralları.
N11 dokümantasyonunu yeni bir platforma taşıdı ve REST servisleri eski SOAP arayüzünün yanına geçti. Yeni entegrasyon yazıyorsanız REST tarafını kullanacaksınız. Bu yazı fiyat ve stok güncellemesinin tam akışını ve en sık hata üreten üç kuralını anlatıyor.
Kimlik doğrulama: Authorization başlığı yok
Trendyol’a alışkınsanız burada şaşırırsınız. N11 REST servislerinde Basic auth kullanılmaz; kimlik bilgileri doğrudan başlık olarak gönderilir:
appKey: <API anahtarınız>
appSecret: <API şifreniz>Dokümanda bu durum “Authorization: no auth seçiniz” diye geçer — yani Postman gibi araçlarda yetkilendirme sekmesini boş bırakıp değerleri Headers alanına yazarsınız. Authorization başlığı kurmaya çalışmak gereksizdir.
Kategori ağacı gibi bazı okuma servisleri yalnızca appKey ister; fiyat-stok gibi yazma servisleri ikisini birden bekler.
Uç nokta ve sınır
POST https://api.n11.com/ms/product/tasks/price-stock-updateTek istekte en fazla 1.000 SKU gönderebilirsiniz — Trendyol’un stok/fiyat servisiyle aynı sınır. Gövde JSON olarak gönderilir.
| Alan | Zorunlu | Açıklama |
|---|---|---|
integrator | Evet | Entegratör / API kullanıcısı için verdiğiniz özel ad. Tüm gönderimlerde aynı değer kullanılmalı. |
stockCode | Evet | Ürünün tedarikçi tarafındaki tekil kodu (SKU). |
listPrice | Koşullu | Liste fiyatı — indirimliyken üstü çizilen tutar (PSF). |
salePrice | Koşullu | Satış fiyatı. |
İsteği FAIL’e düşüren üç kural
Dokümanın “Dikkat Edilmesi Gerekenler” bölümü kısa ama her maddesi pratikte hata üretiyor.
1. Fiyat güncellerken iki alanı birlikte gönderin
Yalnızca salePrice göndermek yetmez. Fiyat güncellemelerinde listPrice ve salePrice birlikte gönderilmelidir. Yalnızca stok güncelleyecekseniz ikisini de hiç göndermeyin — eksik gönderilen alanlar güncellenmez, ama fiyat alanlarından yalnızca birini göndermek hata üretir.
2. Ondalık ayracı nokta olmalı, virgül değil
Türkçe yerel ayarlarla çalışan bir uygulamada bu tuzağa düşmek çok kolaydır. "salePrice": "1299,90" hata verir; doğrusu 1299.90‘dır.
Sayıyı metne çevirirken yerel ayara duyarlı bir biçimlendirici kullanıyorsanız (C#’ta ToString(), Python’da locale etkinken, JavaScript’te toLocaleString) çıktı sunucunun diline göre virgüllü olabilir. Serileştirmeyi daima değişmez (invariant) kültürle yapın.
3. Küsurat tam iki hane olmalı
Noktadan sonra iki hane bekleniyor. 1299.9 ya da 1299.905 gönderirseniz istek FAIL olur. Yuvarlamayı gönderimden önce yapın.
Ayrıca listPrice değeri salePrice‘tan düşük olamaz. İkisi eşit olabilir, ama liste fiyatı satış fiyatının altındaysa istek başarısız olur. İndirim hesabı yapan kodlarda bu sıralama kolayca ters dönebiliyor.
İstek kabul edildi, peki sonuç?
Başarılı her istek bir taskId döner. Bu kimlik işlemin tamamlandığını değil, kuyruğa alındığını gösterir. Gerçek sonucu Task Detail Sorgulama servisinden öğrenirsiniz.
Yapı, Trendyol’un batchRequestId akışıyla aynı mantıkta: gönder, kimliği sakla, biraz sonra sorgula, kalem bazındaki sonuçlara bak. Trendyol tarafındaki ayrıntıları ilgili yazıda anlattık; oradaki “COMPLETED ama kalemler başarısız” uyarısı buraya da uyarlanabilir — üst seviyedeki duruma bakıp geçmeyin.
SOAP’tan REST’e geçiyorsanız
N11’in eski SOAP servisleri hâlâ anlatılıyor, ancak doküman platformu yenilendi ve REST karşılıkları yayında. N11 ayrıca sipariş listeleme için SOAP ve REST servislerini karşılaştıran ayrı bir sayfa yayınlamış — geçiş yapıyorsanız alan eşleşmelerini oradan doğrulayın.
Pratik tavsiye: geçişi tek seferde yapmayın. Önce okuma servislerini REST’e taşıyıp çıktıları eski SOAP yanıtlarıyla karşılaştırın; yazma servislerini en son taşıyın.
Fiyatı değiştirmeden önce
Yeni fiyatın gerçekten kâr bırakıp bırakmadığını görmek için komisyon ve kâr hesabı yazısına ya da doğrudan kâr hesaplayıcıya bakabilirsiniz. Üç pazaryerinin kimlik doğrulama modellerini yan yana görmek isterseniz karşılaştırma yazısı işinizi görür.
Kaynak
Uç nokta, başlıklar, 1.000 SKU sınırı, alan tanımları ve ondalık kuralları N11’in Ürün Fiyat-Stok Güncelleme dokümanından; appKey kullanımı Kategori Ağacı Listeleme sayfasından alınmıştır.
Son kontrol: 6 Ekim 2026.
Bir yanıt yazın