n11 entegrasyonu, n11 mağazanızın ürün, stok, fiyat, sipariş, iade ve soru-cevap işlemlerini n11 servisleriyle yazılımdan yönetmektir. n11, ürün, stok-fiyat ve sipariş servislerini 2024 ve 2025 boyunca SOAP'tan REST'e taşıdı. Eski entegrasyonlar için bu geçiş önemli.
İlgili içerikler: Pazaryeri entegrasyonu rehberi · Trendyol entegrasyonu · Hepsiburada entegrasyonu
API Bilgileri
Kimlik bilgileri n11 satıcı panelinde Hesabım, API Hesapları bölümündedir. İsteklerde appKey ve appSecret başlıkta gönderilir; ayrı bir yetkilendirme türü seçilmez. Değişiklik günlüğüne göre 15 Ağustos 2025'ten beri kategori servislerinde de anahtar zorunlu.
Ana Uç Noktalar
| İşlem | Yöntem ve adres |
|---|---|
| Kategori ağacı (tamamı tek istekte) | GET https://api.n11.com/cdn/categories |
| Kategori özellikleri | GET https://api.n11.com/cdn/category/{categoryId}/attribute |
| Ürün yükleme | POST https://api.n11.com/ms/product/tasks/product-create |
| Fiyat ve stok güncelleme | POST https://api.n11.com/ms/product/tasks/price-stock-update |
| İşlem (task) sonucu | POST https://api.n11.com/ms/product/task-details/page-query |
| Sipariş listeleme | GET https://api.n11.com/rest/delivery/v1/shipmentPackages |
| Sipariş kalemi onayı | PUT https://api.n11.com/rest/order/v1/update |
Fatura bağlantısı (SellerInvoiceService), iade (ReturnService) ve soru-cevap (productService) servisleri belgede hâlâ SOAP olarak geçiyor.
Ürün Yükleme
Zorunlu alanlar: integrator, title, description, categoryId, currencyType, productMainId, preparingDay, shipmentTemplate, stockCode, quantity, images, attributes, salePrice, listPrice ve vatRate.
| Alan | Kural |
|---|---|
| categoryId | En alt kırılım kategori |
| currencyType | TL, USD veya EUR |
| shipmentTemplate | Paneldeki kargo şablonunun adı |
| stockCode | Benzersiz, en fazla 255 karakter |
| quantity | En fazla 999.999 |
| vatRate | 0, 1, 10 veya 20 |
| images | HTTPS adresi, her biri en fazla 10 MB |
| Marka | Ayrı alan yok; attributes içinde kategori özelliği olarak gönderilir |
| integrator | Tüm gönderimlerde aynı ad kullanılmalı |
- Bir istekte en fazla 1.000 ürün (SKU) gönderilir. Yanıttaki
idişlem (task) numarasıdır; istekIN_QUEUEveyaREJECTdurumunda döner. - Sonuç task sorgusuyla alınır: işlem
PROCESSED,IN_QUEUEveyaREJECT; her ürünSUCCESSveyaFAIL. - Barkod n11 kataloğundaki bir barkodla eşleşirse ürün "satıcı onayı bekliyor" durumunda açılır.
- Kategori özelliklerinde
isMandatory,isVariantveisCustomValuealanları zorunlu, varyant ve serbest değer bilgisini verir.
Sipariş Akışı
- Sipariş durumları: Created, Picking, Shipped, Cancelled, Delivered, Unpacked, UnSupplied. Her istekte yalnızca bir durum filtrelenebilir.
- Sayfa boyutu en fazla 100, sorgu penceresi 15 gün. Kasım 2024 öncesindeki siparişler bu servisten dönmez.
- Satıcı API ile yalnızca Created durumundaki kalemler için "Picking" (onay) gönderebilir.
- Sipariş listeleme sınırı dakikada 1000 istek.
SOAP'tan REST'e Geçiş
| Tarih | Değişiklik |
|---|---|
| 4 Nisan 2024 | Stok ve fiyat REST'e geçti (1000 SKU, task takibi) |
| 25 Aralık 2024 | Sipariş listeleme, onay ve bölme REST'e geçti; siparişler paket bazlı oldu |
| 25 Ocak 2025 | Eski SOAP ürün kaydetme, fiyat, stok ve satışa açma-kapatma yöntemleri kapatıldı |
| Eski SOAP durumu | REST karşılığı |
|---|---|
| 2 Ödendi | Created |
| 5 Kabul | Picking |
| 6 Kargoda | Shipped |
| 7 Teslim | Delivered |
| 8 Reddedilmiş | UnSupplied |
| 4 İptal | Cancelled |
Belgeye göre bazı iade ve değişim durumları REST'te Delivered altında görünür; ayrıntı packageHistories alanından okunur. REST'e özgü alanlar arasında cargoTrackingLink ve agreedDeliveryDate var.
İade ve Soru-Cevap
- İade talepleri SOAP iade servisinden listelenir, onaylanır veya reddedilir. Durumlar: REQUESTED, CANCELLED, DENIED, PENDING, PENDED, APPROVED, MANUAL_REFUND.
- Soru listeleme dakikada 1 istekle sınırlı. Yanıt 1 ile 2048 karakter arasında olmalı ve her soru yalnızca bir kez yanıtlanabilir.
Sık Sorulan Sorular
n11'de SOAP tamamen kapandı mı?
Hayır. Ürün, stok-fiyat ve sipariş REST'e taşındı; fatura bağlantısı, iade ve soru-cevap belgelerde hâlâ SOAP olarak geçiyor.
Ürün yükledim, sonucunu nasıl görürüm?
Dönen task numarasıyla task sorgu servisini çağırın ve her ürünün durumunu tek tek kontrol edin.
n11 webhook destekliyor mu?
Belgelerde webhook servisi geçmiyor. Siparişleri düzenli aralıklarla sorgulamanız gerekir.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.