Hata nerede görünür?
Bir görev isteği iki yerde hata verebilir. İstek hiç kabul edilmezse yanıttaki status REJECT olur ve reasons listesi nedeni söyler. İstek kabul edilirse status IN_QUEUE döner; asıl sonuç her SKU için task detayında yazar. Orada status FAIL olan satırın reasons alanı hatayı içerir.
Bu yüzden "istek 200 döndü" demek "ürün yüklendi" demek değildir. Sonucu her zaman task detayından kontrol edin.
Ürün yükleme hataları
| Mesajın özü | Neden | Çözüm |
|---|---|---|
| Girdiğiniz seller stock code tarafınızdan kullanılmaktadır | Stok kodu mağazada zaten var | Farklı bir stok kodu kullanın ya da mevcut ürünü güncelleyin |
| Marka bilgisi girilmelidir / marka özellik değeri boş geçilemez | Marka özelliği yok ya da null | Marka özelliğini (id 1) değerle gönderin |
| attributeId'li kategori özelliklerini kontrol edin | Zorunlu özellik eksik | Kategori özelliklerini yeniden çekip zorunluları doldurun |
| Sadece valueId ile ürün girişi yapılabilir | Serbest değere kapalı özellik | Listedeki valueId'yi gönderin |
| vatRate alanı boş olamaz / 0, 1, 10, 20 olmalı | KDV yok ya da geçersiz | 0, 1, 10 veya 20 gönderin |
| 15 karakter altında ürün adları | Başlık çok kısa | Başlığı en az 15 karaktere çıkarın |
| title boyut 0 ile 255 arasında olmalı | Başlık çok uzun | 255 karakteri aşmayın |
| shipmentTemplate alanı geçersiz / boş olamaz | Şablon adı yanlış | Paneldeki teslimat şablonu adını birebir yazın |
| All Images are invalid / İlk görsel boş olamaz | Görsel erişilemiyor | Herkese açık https bağlantısı verin |
| Kategori ... mainId girişi zorunludur | Slicer özellikli kategori | productMainId gönderin |
Fiyat, içerik ve tekrar hataları
- listPrice salePrice'tan küçük olamaz: Liste fiyatı (üstü çizili fiyat) satış fiyatına eşit ya da ondan yüksek olmalıdır.
- Virgülden sonra 2 haneden fazla: Fiyatlarda en fazla iki ondalık hane kullanın ve ondalık ayıracı olarak nokta yazın.
- Fahiş fiyat düşüklüğü ya da artışı: N11 bazı ürünlerde minimum ve maksimum fiyat uygular. Mesajda yazan sınırın dışına çıkamazsınız; gerekirse mağaza destek merkezinden talep açın.
- Yasaklı kelime: Başlıkta ya da açıklamada yasaklı bir sözcük varsa ürün reddedilir. Mesaj kelimeyi söyler; metinden çıkarın.
- description alanı geçersiz: Açıklamada çok sayıda kapanmamış HTML etiketi olabilir. HTML'i sadeleştirin.
- Aynı barkod, catalogId, stok kodu ya da özellik seti: Bir istekteki iki ürün aynı değeri paylaşıyorsa mükerrer kayıt oluşmaz. Her ürüne benzersiz değer verin.
- Seçtiğiniz kategoriye ya da markayla ürün yükleyemezsiniz: Orijinallik kontrolü olan kategori veya markadır. Tedarik faturalarıyla N11 destek talebi açmanız gerekir.
Ürün güncelleme hataları
- Girilen SellerStockCode ile ürün bulunamamaktadır: Güncellenen stok kodu mağazada yok. Önce ürünü yükleyin.
- Yalnızca onaylı ve beklemede statüleri güncellenebilir: Ürün "Katalog Onay Sürecinde" iken güncelleme kabul edilmez. Onayın bitmesini bekleyin.
- Ürün katalog tarafından reddedildi: Ret nedenini satıcı panelinde görün. N11'in önerisi, ürünü silip nedene göre düzeltip yeniden göndermektir.
Sık sorulanlar
N11 "shipmentTemplate alanı geçersiz" hatası neden çıkar?
Gönderilen kargo şablonu adı mağazanızdaki teslimat şablonlarıyla eşleşmiyordur. Satıcı panelinde Hesabım > Teslimat Bilgileri'ndeki şablon adını birebir yazın.
Ürün başlığı en az kaç karakter olmalı?
N11'in hata listesine göre 15 karakterin altındaki başlıklar işlenmez. Üst sınır 255 karakterdir.
"Sadece valueId ile ürün girişi yapılabilir" ne demek?
O kategori özelliği serbest metin kabul etmez. Kategori özellikleri servisinden dönen değer listesinden uygun valueId'yi seçip göndermeniz gerekir.
Görev IN_QUEUE döndü ama ürün yok, hata nerede?
IN_QUEUE yalnız görevin sıraya alındığını söyler. Ürün bazlı sonuç task detayında yazar; FAIL olan satırın reasons alanı hatayı verir.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı