İstek ve yanıt
Silme isteği iki alanlıdır. integrator payload seviyesinde, stockCode ise her SKU satırında yer alır.
| Alan | Zorunlu | Açıklama |
|---|---|---|
| integrator | Evet | Entegratör adı; her istekte aynı değer |
| skus.stockCode | Evet | Silinecek ürünün satıcı stok kodu |
Örnek gövde: payload içinde integrator: ENTEGRATOR_ADI ve skus: üç satır, her birinde stockCode: STOK_KODU_1 gibi bir değer.
Yanıt diğer görev servisleriyle aynıdır: id, type (PRODUCT_DELETE), status (IN_QUEUE ya da REJECT) ve reasons. Dokümandaki örnekte üç ürünlük istek "3 sku işlenmeye alındı" yanıtını alır.
Silmek mi, satıştan çekmek mi?
Silme kalıcı bir işlemdir. Ürünün N11'deki geçmişi, değerlendirmeleri ve sıralaması da etkilenebilir. Şu durumlarda silmek yerine başka bir yol daha doğrudur:
- Ürün geçici olarak bitti: Stoğu sıfırlayın; ürün sayfası durur, satış olmaz.
- Ürünü bir süre kapatmak istiyorsunuz: product-update ile status alanını Suspended yapın, sonra Active ile açın.
- Bilgi yanlış: Mümkünse güncelleyin. Katalogdan reddedilmiş ürünlerde ise N11'in önerisi silip düzeltilmiş hâliyle yeniden yüklemektir.
Silme en çok yanlışlıkla iki kez açılmış ürünlerde, yanlış kategoriye yüklenip düzeltilemeyen ürünlerde ve kalıcı olarak satılmayacak ürünlerde gerekir.
Silme sonrası kontrol
Görev numarasıyla task detayını sorgulayıp her stok kodu için sonucu okuyun. Ardından ürünün listeden çıktığını ürün sorgulama servisiyle doğrulayın.
Silme görevinin sonucu da ürün bazında gelir. On stok kodundan biri mağazada bulunmuyorsa yalnız o satır FAIL döner, diğerleri işlenir. Bu yüzden sonucu görev bazında değil, stok kodu bazında okuyun ve FAIL olan satırların reasons metnini ayrıca inceleyin.
Silinen bir stok kodunu yeniden kullanmadan önce ürünün gerçekten kalktığından emin olun. N11'in hata listesinde, mağazada zaten kullanılan bir stok koduyla yükleme yapıldığında "seller stock code tarafınızdan kullanılmaktadır" hatası döndüğü yazar.
Sık hatalar
- Yanlış stok kodu: Servis stok koduyla çalışır; N11 ürün numarasını (n11ProductId) göndermek işe yaramaz.
- Kendi kaydını unutmak: N11'den silinen ürünü kendi sisteminizde de pasife alın. Aksi hâlde stok senkronu olmayan bir ürüne güncelleme göndermeye devam eder.
- Toplu silmeyi denemeden yapmak: Önce tek bir ürünle deneyin. Yanlış listeyle yapılan toplu silmenin geri alma adımı yoktur.
- Açık siparişi unutmak: Kargoya verilmemiş siparişi olan bir ürünü silmeden önce o siparişleri tamamlayın. Kendi raporlarınızda sipariş ile ürün arasındaki bağı da korumuş olursunuz.
Sık sorulanlar
N11'de ürün API ile nasıl silinir?
POST /ms/product/tasks/product-delete isteğiyle. Gövdede integrator ve silinecek ürünlerin stockCode listesi bulunur; sonuç task detayından okunur.
Silinen ürün geri getirilebilir mi?
Dokümanda silinen ürünü geri getiren bir servis yok. Ürünü yeniden yüklemeniz gerekir. Geçici kapatma için product-update ile Suspended kullanmak daha güvenlidir.
Tek istekte kaç ürün silinebilir?
N11 dokümanına göre en fazla 1.000 SKU. Her istek ayrı bir PRODUCT_DELETE görevi açar.
Yanlışlıkla iki kez açılan ürünü nasıl temizlerim?
Hangi kaydın kalacağına karar verin, fazla olanın stok kodunu product-delete ile silin ve sonucu task detayından kontrol edin. Kalan ürünün stok kodunu kendi sisteminizdeki eşleştirmeyle karşılaştırmayı unutmayın.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı