Zorunlu ve isteğe bağlı alanlar
Her SKU için aşağıdaki alanlar gönderilir. Tablo N11'in ürün yükleme dokümanından özetlenmiştir.
| Alan | Zorunlu | Not |
|---|---|---|
| integrator | Evet | Entegratör adı; payload seviyesinde, her istekte aynı değer |
| title | Evet | Ürün adı; 15 ile 255 karakter arası |
| description | Evet | HTML içerebilir |
| categoryId | Evet | En alt kırılım kategori |
| currencyType | Evet | TL, USD ya da EUR |
| productMainId | Evet | Aynı modelin bütün seçeneklerinde aynı değer |
| preparingDay | Evet | Kargoya verme süresi (gün) |
| shipmentTemplate | Evet | Paneldeki teslimat şablonu adı |
| stockCode | Evet | Benzersiz satıcı kodu; en fazla 255 karakter |
| quantity | Evet | Stok; en fazla 999.999 |
| images | Evet | url ve order alanlı liste; https zorunlu |
| attributes | Evet | id, valueId, customValue |
| salePrice, listPrice | Evet | Satış ve liste fiyatı |
| vatRate | Evet | 0, 1, 10 ya da 20 |
| barcode | Hayır | Yalnız ulusal barkodlar kaydedilir |
| catalogId | Hayır | N11 katalog numarası |
| maxPurchaseQuantity | Hayır | Alıcı başına en fazla adet |
Görsel, barkod ve fiyat kuralları
- Görseller: Bağlantılar SSL sertifikalı https adresi olmalıdır. Her görsel en fazla 10 MB olabilir. order alanı sırayı belirler. İlk görsel boşsa ya da hiçbir bağlantı açılmıyorsa ürün reddedilir.
- Barkod: Gönderilen barkod N11 kataloğundaki bir barkodla eşleşirse ürün, özelliklerine bakılmadan "satıcı onayı bekliyor" durumunda açılır. Barkodu yalnız gerçekten o ürüne aitse gönderin.
- Fiyat: Liste fiyatı satış fiyatından düşük olamaz; ikisi eşit olabilir. Ondalık ayıracı nokta olmalı ve virgülden sonra en fazla iki hane bulunmalıdır.
- Para birimi: USD ve EUR fiyatlar Merkez Bankası kuruna göre güncellenir.
- Kargo şablonu: Şablon adı her ürün için ayrı gönderilir ve panelde tanımlı bir şablonla birebir eşleşmelidir.
Varyantlı ürün göndermek
Renk ve beden seçenekli bir ürünü tek sayfada toplamak için her seçeneği ayrı SKU olarak, aynı productMainId ile gönderin. Seçenekleri ayıran özellikler (örneğin Renk, Beden) kategori özellik servisinde isVariant true olarak işaretlidir. Dokümandaki örnekte dört elbise seçeneği aynı productMainId ile, farklı stockCode değerleriyle tek istekte gönderilir ve yanıt "4 sku işlenmeye alındı" der.
Aynı istek içinde iki ürünün stok kodu, barkodu, catalogId'si ya da başlık ve özellik seti aynıysa N11 mükerrer kayıt hatası verir.
Yanıt ve sonraki adım
Başarılı bir istek şu alanları döndürür: id (görev numarası), type (PRODUCT_CREATE), status (IN_QUEUE ya da REJECT) ve reasons. IN_QUEUE, görevin sıraya alındığını gösterir; ürünlerin açıldığını göstermez.
Görev numarasıyla task detayını sorgulayın. Her ürün için SUCCESS ya da FAIL ve bir neden metni görürsünüz. FAIL olan ürünleri hata mesajları listesine göre düzeltip yeniden gönderin. Başarılı ürünler de katalog onayından geçebilir; durumunu ürün sorgulama servisindeki productStatus alanından izlersiniz.
Sık sorulanlar
N11'e API ile tek seferde kaç ürün yüklenir?
product-create isteği başına en fazla 1.000 SKU. Daha fazla ürününüz varsa birden fazla istek gönderirsiniz; her istek ayrı bir görev numarası alır.
Ürün yükledim ama N11'de görünmüyor, neden?
Servis ürünü görev olarak sıraya alır. Task detayında ürünün SUCCESS mi FAIL mi olduğunu kontrol edin. Başarılı ürünler katalog onayı sürecinde bekliyor olabilir.
N11 ürün yüklemede barkod zorunlu mu?
Hayır, barcode isteğe bağlıdır ve yalnız ulusal barkodlar kaydedilir. Barkod N11 kataloğundaki bir ürünle eşleşirse ürün "satıcı onayı bekliyor" durumunda açılır.
shipmentTemplate alanına ne yazılır?
Satıcı panelinde Hesabım > Teslimat Bilgilerim bölümünde oluşturduğunuz kargo şablonunun adı. Ad birebir eşleşmezse "shipmentTemplate alanı geçersiz" hatası alınır.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı