Kalemleri onaylamak
Onay isteği lines dizisi ve tek bir status alanından oluşur. lineId değeri sipariş listesindeki orderLineId'dir. Örnek gövde: lines içinde lineId: KALEM_NO satırları, status: Picking.
- Yalnız durumu Created olan kalemler onaylanabilir.
- Birden fazla lineId aynı istekte gönderilebilir; status tektir.
- Hatalı ya da uygun durumda olmayan lineId için hata döner, kalanlar işlenir.
- Yanıtta her lineId için status (SUCCESS) ve reasons ("Başarıyla tamamlandı.") gelir.
Servisi kullanmadan siparişlerin otomatik onaylanmasını isteyen satıcılar, dokümana göre sellerintegration@n11.com adresine e-posta gönderebilir.
Reddetme ve iptal yolları
Siparişin hangi aşamada olduğuna göre iptal yolu değişir:
| Durum | Ne yapılabilir | Nasıl |
|---|---|---|
| Created (yeni) | Siparişi reddetmek | Satıcı panelindeki Reddet düğmesi |
| Picking (onaylı) | Paketi kalemlere bölmek | POST /rest/delivery/v1/splitCombinePackage |
| Picking (onaylı) | Adet bazlı bölmek ve ürün iptal etmek | POST /rest/delivery/v1/splitPackageByQuantity |
| Onaylandı ya da Geciken Kargolama | Kalem ve adet bazlı iptal | SOAP ClaimCancelPartial (ClaimCancelService.wsdl) |
Parçalı iptal dokümanı bunu açıkça yazar: Yeni Sipariş statüsündeki siparişler bu servisle iptal edilemez, satıcı panelinden reddedilir.
Paket bölme ve miktar bazlı iptal
splitCombinePackage, Picking durumundaki bir paketi kalemlere ayırır. Gövdede splitGroups dizisi ve her grupta orderLineIds listesi bulunur. Gönderilmeyen kalemler otomatik olarak ayrı bir pakette toplanır. Bölünen ana paket Unpacked olur, yeni paketler Picking durumunda, aynı orderNumber ama farklı paket numarası ve farklı kargo kampanya koduyla oluşur. Yanıt, splitPackageOrderItems altında yeni paketlerin orderNumber, packageId, orderLineId, stockCode ve quantity bilgilerini verir.
splitPackageByQuantity aynı işi adet bazında yapar ve iptali de destekler. Her siparişe ayrı istek atılır, yeni paketler packageDetails ile tarif edilir. İptal edilen kısım UnSupplied olur. Servis yalnız iptal için kullanılamaz; iptal bir bölme işlemiyle birlikte yapılır. İptal nedeni kodları şunlardır: 61 Stok Tükendi, 62 Kusurlu/Defolu/Bozuk Ürün, 63 Hatalı Fiyat, 64 Mücbir Sebep, 65 Diğer.
Dikkat edilecekler
- Müşteri iptali: Ocak 2025 güncellemesine göre alıcı, sipariş kargoya verilene kadar doğrudan iptal edebilir ve iptalde kargo kampanya numaraları geçersiz olur. Onayladığınız siparişin durumunu kargolamadan önce yeniden okuyun.
- Kısmi iptalde yeni kod: Tek siparişteki ürünlerden biri iptal edilirse kargo kampanya kodu güncellenir. Kalan ürünü yeni kodla gönderin.
- Gecikmiş onay: Onaylanıp zamanında kargoya verilmeyen kalemler eski sistemde ayrı bir durumda izlenirdi; REST'te Picking olarak kalır. agreedDeliveryDate alanını takip edin.
- Stok iadesi: İptal edilen ürünün stoğunu kendi sisteminizde geri eklemeyi unutmayın.
Sık sorulanlar
N11 siparişi API ile nasıl onaylanır?
PUT /rest/order/v1/update isteğinde onaylanacak kalemlerin orderLineId değerleri lines dizisinde, status alanında Picking gönderilir. Yalnız Created durumundaki kalemler onaylanabilir.
N11'de yeni siparişi API ile reddedebilir miyim?
Dokümana göre hayır. Yeni Sipariş statüsündeki siparişler satıcı panelindeki Reddet düğmesiyle iptal edilir. Onaylanmış siparişlerde paket bölme ya da parçalı iptal servisleri kullanılır.
Stokta olmayan bir ürün için hangi iptal kodu kullanılır?
Miktar bazlı paket bölme ve ürün iptali servisinde cancelReasonId 61, yani Stok Tükendi kullanılır.
Siparişler otomatik onaylanabilir mi?
N11 dokümanına göre servisi kullanmadan otomatik sipariş onayı isteyen satıcılar sellerintegration@n11.com adresine e-posta gönderebilir.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı