Filtre parametreleri
Parametrelerin hiçbiri zorunlu değildir. Kullanılabilenler şunlardır:
| Parametre | Anlamı | Not |
|---|---|---|
| id | N11 ürün numarası | Tek ürün |
| productMainId | Model (grup) kodu | Bir modelin bütün seçenekleri |
| stockCode | Satıcı stok kodu | İstek başına tek değer |
| saleStatus | Satış durumu | On_Sale ya da Out_Of_Stock |
| productStatus | Onay durumu | Aşağıdaki tabloya bakın |
| brandName | Marka adı | Paneldeki marka adına göre |
| categoryIds | Kategori numaraları | Liste |
| page, size | Sayfalama | size en fazla 250 |
| sender | Gönderici tipi | SELLER (varsayılan), N11 ya da ALL |
stockCode tek değer aldığı için birden fazla stok kodunu sorgulamak üzere her kod için ayrı istek atmanız gerekir. Toplu kontrolde bütün ürünleri sayfalayarak çekmek çoğu zaman daha az istekle biter.
Ürün onay durumları
productStatus alanı ürünün N11 tarafındaki onay durumunu verir:
- Active: Onaylı
- InCatalogApproval: Katalog onay sürecinde
- Suspended: Beklemede
- CatalogRejected: Katalogdan reddedildi; ret bilgisi rejectInfo alanında gelir
- Prohibited: Yasaklı
- Unlisted: Limit dışı
- InApproval: Aksiyon bekleyen
Satış tarafında ise saleStatus alanı On_Sale (satışta) ya da Out_Of_Stock (stokta yok) değerini alır.
Yanıttaki önemli alanlar
Yanıt, content dizisi ve sayfalama alanlarından (totalElements, totalPages, number, numberOfElements, size) oluşur. Her üründe şu bilgiler bulunur: n11ProductId, sellerId, sellerNickname, stockCode, title, description, categoryId, productMainId, status, saleStatus, preparingDay, shipmentTemplate, maxPurchaseQuantity, customTextOptions, catalogId, barcode, groupId, currencyType, salePrice, listPrice, quantity, attributes, imageUrls, vatRate, commissionRate ve sender.
imageUrls düz bir URL listesidir. attributes ise attributeId, attributeName ve attributeValue alanlarından oluşur. commissionRate, ürünün komisyon oranını gösterdiği için kâr hesabında işe yarar.
Sayfalama ve sık hatalar
N11'in önerisi: page 0'dan başlayın, totalPages alanına göre ilerleyin ve content boş dönen sayfayı son sayfa kabul edin.
- Varsayılan boyutta kalmak: size vermezseniz sayfa başına 20 ürün gelir; büyük mağazada gereksiz istek sayısı artar.
- Alan uzunluğunu sabitlemek: Dokümana göre n11ProductId gibi alanlar 9 haneden 10 haneye çıkabilir. Veritabanında geniş tip kullanın.
- Stoğu yalnız buradan okumak: Siparişlerle düşen stok bu listede gecikmeyle görünebilir. Stok kararlarını sipariş akışıyla birlikte verin.
- sender'ı unutmak: n11depom kullanan mağazalarda depodan gönderilen ürünler için sender parametresi gerekir.
Sık sorulanlar
N11'de bütün ürünleri nasıl çekerim?
GET /ms/product-query isteğini page 0'dan başlatıp size değerini en fazla 250 yapın. totalPages alanına göre sayfaları dolaşın; content boş dönen sayfa son sayfadır.
Birden fazla stok koduyla tek istekte sorgu yapılır mı?
Hayır. stockCode parametresi istek başına tek değer alır. Birden çok kod için ayrı istekler atmanız gerekir.
Katalogdan reddedilen ürünün nedenini nereden görürüm?
Ürünün status değeri CatalogRejected olduğunda yanıtta rejectInfo alanı gelir. Ayrıntılı neden satıcı panelinde de görünür.
Ürün sorgulamada komisyon oranı da gelir mi?
Evet. Yanıttaki commissionRate alanı ürünün komisyon oranını gösterir. vatRate alanı da KDV oranını verdiği için iki alan birlikte ürün bazlı kâr hesabında kullanılabilir.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı