Güncellenebilen alanlar
Her SKU için yalnız stockCode zorunludur. Göndermediğiniz alanlar değişmez.
| Alan | Ne yapar | Değerler |
|---|---|---|
| stockCode | Güncellenecek ürünü seçer | Zorunlu |
| status | Satış durumunu değiştirir | Active (satışta) ya da Suspended (satıştan çek) |
| preparingDay | Kargoya verme süresi | 0'dan büyük gün sayısı |
| shipmentTemplate | Kargo şablonu | Paneldeki şablon adı |
| productMainId | Model kodu; seçenekleri gruplar | Metin |
| deleteProductMainId | Model kodunu siler | true ya da false |
| maxPurchaseQuantity | Alıcı başına en fazla adet | Tam sayı |
| deleteMaxPurchaseQuantity | Adet sınırını kaldırır | true ya da false |
| description | Ürün açıklaması | Metin |
| vatRate | KDV oranı | 0, 1, 10, 20 |
| attributes | Ürün güvenliği ve besin değeri özellikleri | id, valueId, customValue |
Satıştan çekme ve yeniden açma
Eski SOAP servislerindeki StopSelling ve StartSelling metotları Ocak 2025'te kapatıldı. Bugün aynı iş product-update içindeki status alanıyla yapılır: ürünü satıştan çekmek için Suspended, yeniden satışa açmak için Active gönderilir.
Stoğu sıfırlamak da ürünü satılmaz hâle getirir ama ürün satışta görünmeye devam eder. Geçici olarak tamamen kapatmak istiyorsanız Suspended daha net bir sonuç verir. Stok sıfırlama için N11 stok güncelleme sayfasına bakın.
attributes alanı ve ürün güvenliği bilgileri
Güncelleme servisinde attributes alanı, ürünün temel özelliklerini değiştirmek için değil, ürün güvenliği ve besin değeri bilgilerini eklemek içindir. N11 dokümanı bu özelliklerin listesini verir. Örnekler:
- 1000000: Kayıtlı Ticari Unvan
- 1000002: İletişim Adresi
- 1000003: E-posta
- 1000004: Menşei
- 1000005: Sağlayıcı Tipi
- 1000006 ile 1000010 arası: Ürün Güvenliği Görseli 1 ile 5 arası
attributes gönderildiğinde her satırda id, valueId ve customValue alanları bulunmalıdır. Kategori özellik servisinde isCustomValue false olan özellikler için valueId, true olanlar için serbest değer yazılır.
Kısıtlar ve sık hatalar
- Ürün mağazada yok: "Girilen X SellerStockCode ile mağazanızda ürün bulunamamaktadır" hatası, stok kodunun yanlış olduğunu ya da ürünün hiç yüklenmediğini gösterir.
- Ürün onay sürecinde: Yalnız Onaylı ve Beklemede durumundaki ürünler güncellenebilir. Katalog Onay Sürecinde olan ürüne gönderilen güncelleme reddedilir.
- Katalogdan reddedilmiş ürün: Güncelleme yerine ürünü panelden silip düzeltilmiş hâliyle yeniden yüklemek gerekir.
- Temel özellik değiştirmeye çalışmak: Marka, renk ve beden gibi özellikleri yalnız N11 günceller.
- Sonucu kontrol etmemek: Yanıttaki IN_QUEUE yalnız sıraya alındığını gösterir; ürün bazlı sonuç task detayındadır.
Sık sorulanlar
N11'de ürün satıştan nasıl çekilir?
product-update isteğinde ilgili stockCode için status alanına Suspended yazılır. Yeniden satışa açmak için Active gönderilir.
N11'de ürün başlığı ya da markası API ile değişir mi?
Dokümana göre marka, renk, beden gibi temel özellikleri yalnız N11 güncelleyebilir. product-update servisi bu alanları değiştirmez.
Fiyatı product-update ile değiştirebilir miyim?
Hayır. Fiyat ve stok için ayrı bir görev servisi vardır: price-stock-update. product-update fiyat alanı almaz.
Model kodunu (productMainId) nasıl silerim?
İlgili stockCode için deleteProductMainId alanını true gönderin. false gönderilirse model kodu silinmez.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı