Yanıttaki alanlar
Servis kök seviyede kategorinin id ve name alanlarını, ardından categoryAttributes dizisini döndürür. Her özellikte şu alanlar bulunur:
| Alan | Anlamı |
|---|---|
| attributeId | Özellik numarası; ürün yüklemede attributes.id |
| attributeName | Özellik adı, örneğin Marka ya da Renk |
| isMandatory | true ise ürün yüklemede zorunlu |
| isVariant | true ise aynı productMainId'li ürünler aynı sayfada seçenek olur |
| isSlicer | true ise kategoride model kodu (productMainId) zorunlu olabilir |
| isCustomValue | true ise listede olmayan serbest değer gönderilebilir |
| isN11Grouping | N11'in gruplama bayrağı |
| attributeOrder | Özelliğin sıralama değeri |
| attributeValues | İzinli değerler: id ve value çiftleri |
Dokümandaki örnekte Makyaj Çantası kategorisinde Marka (attributeId 1) zorunlu ve serbest değere açıktır. Renk (attributeId 429) ise zorunlu, varyant ve slicer özelliğidir.
attributes alanı nasıl doldurulur?
Ürün yükleme isteğindeki her özellik üç alanla gönderilir: id, valueId ve customValue. Hangisini dolduracağınız isCustomValue bayrağına bağlıdır.
- isCustomValue false: Yalnız listedeki değerler kabul edilir. valueId alanına attributeValues içinden seçtiğiniz değerin id'sini yazın.
- isCustomValue true: Listeden bir valueId gönderebilir ya da customValue alanına kendi değerinizi yazabilirsiniz.
- isMandatory true: Bu özellik gönderilmezse ürün yüklenmez.
Örnek bir özellik satırı: id: 1, valueId: null, customValue: MARKA_ADI. Listeden değer seçilen bir satır ise şöyle olur: id: 911, valueId: 444058.
Varyant ve slicer mantığı
N11'de aynı modelin renk ve beden seçenekleri aynı ürün sayfasında toplanabilir. Bunun yolu, varyant özelliklerinde farklı değer verip bütün seçeneklere aynı productMainId'yi yazmaktır. Örneğin üç bedenli bir elbisenin her bedeni ayrı stockCode ile, ama aynı productMainId ile gönderilir.
isSlicer true olan kategorilerde model kodu zorunluluğu doğar. N11'in hata listesinde bu durum "kategorisinde mainId girişi zorunludur" mesajıyla geçer. Bu mesajı görürseniz productMainId alanını doldurun.
Sık hatalar ve öneriler
- Eski değer listesi: N11 değer listelerini güncelleyebilir. "X idli özellik değeri" türü bir hata görürseniz listeyi yeniden çekin ve eşleştirmeyi tazeleyin.
- Marka boş: Marka çoğu kategoride zorunludur. Null ya da boş marka "marka özellik değeri boş geçilemez" hatası verir.
- Serbest değere kapalı özelliğe metin yazmak: "Sadece valueId ile ürün girişi yapılabilir" hatası döner.
- Kategoriye ait olmayan özellik: Özellik ya da değer id'si o kategoriye ait değilse ürün reddedilir.
Özellik eşleştirmesini ürün yüklemeye başlamadan önce yapın. N11'in yardım merkezi de ürün aktarımından önce kategori ve özelliklerin kendi sisteminizle eşleştirilmesini öneriyor.
Sık sorulanlar
N11'de zorunlu özellikler nasıl öğrenilir?
GET https://api.n11.com/cdn/category/{categoryId}/attribute isteğiyle. Yanıtta isMandatory değeri true olan özellikler ürün yüklemede zorunludur.
valueId mi customValue mu göndermeliyim?
Özelliğin isCustomValue değeri false ise yalnız listedeki valueId kabul edilir. true ise valueId ya da customValue alanında serbest bir değer gönderebilirsiniz.
Varyantlı ürün nasıl açılır?
isVariant değeri true olan özelliklerde her seçeneğe farklı değer verin ve bütün seçenekleri aynı productMainId ile gönderin. Her seçeneğin stockCode değeri ise farklı olmalıdır.
Kategori özellik listesi ne sıklıkla güncellenmeli?
N11 değer listelerini güncelleyebildiği için listeyi düzenli aralıklarla yeniden çekmek gerekir. Özellikle bir özellik değeri hatası aldığınızda o kategorinin listesini hemen tazeleyin ve eşleştirmenizi buna göre düzeltin.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı