1. adım: SearchCatalog ile arama
Katalog araması SOAP servisidir; WSDL adresi https://api.n11.com/ws/CatalogService.wsdl. Arama parametreleri ve kuralları şunlardır:
| Parametre | Açıklama | Kural |
|---|---|---|
| productTitles | Ürün adları | Virgülle en fazla 10 değer; en az 10 karakter; categoryId ile birlikte |
| categoryId | Kategori | Tek değer; marka ya da ürün adından biriyle birlikte |
| uscs | GTIN ya da barkod | Virgülle en fazla 10 değer |
| brandName | Marka | Tek değer |
| catalogIds | Katalog numaraları | Virgülle en fazla 10 değer |
| currentPage | Sayfa | 0'dan başlar |
Öncelik sırası önemlidir. catalogIds girilmişse servis yalnız ona bakar. catalogIds yok ama barkod varsa yalnız barkoda bakar. İkisi de yoksa diğer parametrelerin kesişimi döner.
Yanıtta ne gelir?
Her eşleşen katalog ürünü için catalogId, categoryId, categoryName, productTitle ve usc (GTIN ya da barkod) alanları döner. Yanıtta hangi arama değerinin hangi sonuçla eşleştiğini gösteren searchRequest bloğu da bulunur. Böylece on barkodu tek istekte aratıp her birinin karşılığını ayırabilirsiniz.
2. adım: catalogId ya da barkodla yükleme
Hızlı yükleme ayrı bir adres değildir; normal product-create servisine daha az alan gönderilir. Zorunlu alanlar şunlardır:
- integrator, description, categoryId, productMainId, preparingDay, shipmentTemplate
- stockCode, quantity (en fazla 999.999), salePrice, listPrice, currencyType, vatRate
- barcode ya da catalogId: en az biri dolu olmalı
Başlık, görsel ve özellik alanları bu senaryoda zorunlu listede yer almaz; ürün bilgileri katalogdan gelir. maxPurchaseQuantity isteğe bağlıdır. İstek başına en fazla 1.000 SKU gönderilir ve yanıt yine bir görev numarasıdır.
Kurallar ve sık hatalar
- Açıklama önceliği: Katalogda kayıtlı bir açıklama varsa ürüne N11'in açıklaması eklenir. Katalog açıklaması yoksa sizin gönderdiğiniz description kullanılır.
- Kategori uyuşmazlığı: Barkodla gönderimde barkodun N11 kategorisi ile isteğinizdeki categoryId farklıysa ürün panelde Aksiyon Bekleyenler > Satıcı Onayı Bekliyor durumunda kaydedilir.
- Reddedilmiş katalog ürünü: "Girilen catalogId katalog tarafından reddedildi" hatası, katalog kaydının onaylı olmadığını söyler. Onaylı bir catalogId kullanın ya da catalogId olmadan normal yüklemeye geçin.
- Geçersiz catalogId: "catalogId alanı geçersizdir" hatası değerin yanlış olduğunu gösterir.
- Aynı catalogId iki üründe: Bir istekteki iki SKU aynı catalogId'yi kullanamaz.
Katalogda bulunmayan ürünlerde normal ürün yükleme yolunu izleyin; bu durumda görsel ve özellikler zorunludur.
Sık sorulanlar
N11 katalogda ürün nasıl aranır?
SOAP CatalogService içindeki SearchCatalog ile. Ürün adı, kategori, barkod, marka ya da catalogId ile arama yapılır; ürün adı, barkod ve catalogId için istek başına en fazla 10 değer gönderilir.
Hızlı yüklemede görsel göndermek zorunlu mu?
Hızlı yükleme dokümanındaki zorunlu alan listesinde görsel ve özellik yer almaz; ürün bilgileri katalogdan gelir. barcode ya da catalogId alanlarından biri ise zorunludur.
Hem barkod hem catalogId gönderirsem hangisi geçerli olur?
N11 dokümanına göre ikisi de doluysa catalogId öncelikli kabul edilir.
Katalog araması REST ile yapılabilir mi?
Dokümanda katalog araması yalnız SOAP olarak anlatılır: CatalogService içindeki SearchCatalog metodu. Bulunan catalogId ya da barkodla yapılan yükleme ise REST product-create servisinden gider.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı