Geçiş takvimi
N11, REST'e geçişi parça parça yaptı. Geliştirici sitesindeki Change Log sayfasına göre önemli adımlar şunlardır:
| Tarih | Değişiklik |
|---|---|
| 4 Nisan 2024 | Stok-fiyat güncelleme ve ürün güncelleme REST'e geçti; işlem sonucu için task servisleri açıldı |
| 25 Aralık 2024 | Sipariş listeleme, sipariş onaylama ve sipariş bölme REST'e geçti; siparişler paket mantığına taşındı |
| 25 Ocak 2025 | Eski SOAP ürün, stok ve satış durumu metotları kapatıldı |
| 17 Temmuz 2025 | Kategori servislerinin 15 Ağustos 2025'ten itibaren anahtarsız çalışmayacağı duyuruldu |
| 8 Haziran 2026 | E-ihracat için sipariş listeleme ve fatura linki servislerine yeni alanlar eklendi |
Kapatılan SOAP metotları
Ocak 2025 duyurusunda kapatılan metotlar üç servis altında toplanır. Bu metotları çağıran eski bir entegrasyon artık çalışmaz:
- ProductService: SaveProduct, UpdateProductBasic, UpdateProductPriceById, UpdateProductPriceBySellerCode, UpdateDiscountValueByProductId, UpdateDiscountValueBySellerCode
- ProductStockService: GetProductStockByProductId, GetProductStockByProductSellerCode, UpdateStockByStockId, UpdateStockByStockSellerCode, IncreaseStockByStockId, IncreaseStockByStockSellerCode, DeleteAndUpdateStockByStockAttributes, IncreaseStockByStockAttributes
- ProductSellingService: StartSellingProductByProductId, StartSellingProductBySellerCode, StopSellingProductByProductId, StopSellingProductBySellerCode
Bunların yerine ürün yükleme için product-create, güncelleme için product-update, stok ve fiyat için price-stock-update REST görevleri kullanılır. Satıştan çekme işi de product-update içindeki status alanıyla (Active ya da Suspended) yapılır.
Bugün hangi işlem hangi teknolojiyle yapılır?
| İşlem | Teknoloji | Adres |
|---|---|---|
| Kategori ağacı ve özellikler | REST | /cdn/categories, /cdn/category/{id}/attribute |
| Ürün yükleme, güncelleme, silme | REST görev | /ms/product/tasks/... |
| Stok ve fiyat | REST görev | /ms/product/tasks/price-stock-update |
| Ürün sorgulama | REST | /ms/product-query |
| Sipariş listeleme ve onay | REST | /rest/delivery/v1/shipmentPackages, /rest/order/v1/update |
| Ürün soruları | SOAP | ProductService.wsdl |
| İade talepleri | SOAP | ReturnService.wsdl |
| Parçalı iptal | SOAP | ClaimCancelService.wsdl |
| Fatura linki | SOAP | SellerInvoiceService.wsdl |
| Katalog arama | SOAP | CatalogService.wsdl |
Bütün adresler https://api.n11.com ile başlar. SOAP servislerinin WSDL dosyaları /ws/ altındadır.
Tasarım için pratik notlar
İki teknolojiyi aynı kodda yönetmek için tek bir kimlik katmanı kurun. REST istemcisi başlık ekler, SOAP istemcisi aynı değerleri auth bloğuna yazar. Böylece anahtar değiştiğinde tek yeri güncellersiniz.
Hata kontrolünü de ayırın. REST görevlerinde status ve reasons alanlarına, SOAP'ta result.status alanına bakılır. SOAP yanıtlarında eleman adları ad alanı öneki taşıyabilir (örneğin ns3:); ayrıştırıcınız öneki yok sayabilmelidir.
Eski SOAP sipariş servisinden REST'e geçiyorsanız alan eşleşmesi için N11'in karşılaştırma tablosunu kullanın: N11 sipariş detayı ve durumları.
Sık sorulanlar
N11 SOAP API kapandı mı?
Tamamen değil. Ürün, stok ve satış durumu SOAP metotları Ocak 2025'te kapatıldı. Ürün soruları, iade talepleri, parçalı iptal, fatura linki ve katalog arama SOAP ile çalışmaya devam ediyor.
SaveProduct yerine ne kullanılmalı?
REST ürün yükleme görevi kullanılmalı: POST https://api.n11.com/ms/product/tasks/product-create. Tek istekte en fazla 1.000 SKU gönderilir, sonuç task detayından okunur.
Sipariş servisleri ne zaman REST'e geçti?
N11 Change Log'una göre 25 Aralık 2024'te sipariş listeleme, onaylama ve bölme servislerinin REST geçişi tamamlandı. Siparişler artık paket olarak listeleniyor.
N11 SOAP servislerinin WSDL adresleri nerede?
Hepsi https://api.n11.com/ws/ altındadır. Örneğin ürün soruları için ProductService.wsdl, iade talepleri için ReturnService.wsdl, parçalı iptal için ClaimCancelService.wsdl, fatura linki için SellerInvoiceService.wsdl ve katalog arama için CatalogService.wsdl kullanılır.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı