Anlaşmalı kargoyla gönderim adımları
N11 Mağaza Destek Merkezi'ndeki kargo süreci sayfası akışı şöyle anlatır:
| Adım | Ne yapılır | Sonuç |
|---|---|---|
| 1 | Teslimat şablonu tanımlanır (Hesabım > Teslimat Bilgileri) | Ürünler bu şablonla yüklenir |
| 2 | Sipariş onaylanır | Paket Picking durumuna geçer |
| 3 | Kargo şablonu çıktısı alınıp pakete konur | Kampanya numarası paketin üzerindedir |
| 4 | Paket kampanya numarasıyla kargo firmasına teslim edilir | Firma bu numarayla kargo faturasını keser |
| 5 | Takip numarası güncellenir | Sipariş otomatik Kargolandı (Shipped) olur |
Aynı sayfa önemli bir uyarı içerir: siparişler kargo şablonundaki kampanya numarasıyla gönderilmezse geciken kargolama durumuna geçer.
Siparişteki kargo alanları
Sipariş listeleme servisi kargo bilgisini şu alanlarla verir:
- cargoTrackingNumber: Kargo barkod numarası ya da kargo kampanya kodu.
- cargoSenderNumber: Kargo takip numarası.
- cargoTrackingLink: Takip bağlantısı.
- cargoProviderName ve shipmentCompanyId: Kargo firması.
- shipmentMethod: 1 kargo, 2 diğer (dijital, hediye, online teslimat).
- agreedDeliveryDate: En geç kargolama tarihi.
Paket bölündüğünde ya da kısmi iptal olduğunda kampanya kodu değişir. Kargo etiketini her zaman siparişin güncel hâlinden basın.
Lojistik firmalarıyla toplama talebi
Büyük hacimli ürünlerde lojistik firması ürünü depodan alır. Bunun için PUT https://api.n11.com/rest/delivery/v1/collectionRequest servisi kullanılır. Yalnız Picking durumundaki kalemler için talep açılır ve paketteki bütün kalemler aynı istekte gönderilmelidir; eksik gönderimde "Eksik ya da uygun olmayan sipariş öğesi bulunmaktadır" hatası döner.
Her satırda id (paket ya da kampanya kodu), orderLineId, boxQuantity (koli adedi), desi ve shipmentCompany bulunur. Firma kısa kodları: HLZ (Horoz Lojistik), CEVA (Ceva Lojistik), BL (Ceva Tedarik Zinciri, Borusan). Destek sayfasına göre bu kapsamda yalnız "Mağaza Öder" siparişler gönderilebilir.
Fatura linki ve sık hatalar
Kargo öncesi ya da sonrası, kestiğiniz faturanın bağlantısını siparişe ekleyebilirsiniz. Bu iş SOAP SellerInvoiceService üzerinden yapılır: url ve orderNumber zorunludur, bağlantı https olmalı, dosya pdf, png ya da jpeg olmalı ve 2.048 karakteri aşmamalıdır. Aynı sipariş için tek aktif bağlantı tutulur; yeni yükleme eskisinin yerine geçer. E-ihracat siparişlerinde invoiceDateTime ve invoiceNumber da zorunludur.
- Kampanya numarasız gönderim: Sipariş geciken kargolamaya düşer.
- Eski kodla etiket: Kısmi iptal ya da bölme sonrası eski kampanya kodu geçersiz olabilir.
- Teslimat noktası siparişleri: deliveryAddressType doluysa paket müşteri adresine değil teslimat noktasına gider.
Sık sorulanlar
N11'de kargo takip numarası API ile mi girilir?
Anlaşmalı kargoda hayır. Paket kampanya numarasıyla kargoya verilir; kargo firması faturayı kesince takip numarası otomatik güncellenir ve sipariş Kargolandı durumuna geçer.
Kampanya numarası nerede yazar?
Sipariş listeleme servisindeki cargoTrackingNumber alanında ve paneldeki kargo şablonu çıktısında. Paket bölme ya da kısmi iptal sonrası numara değişebilir.
Horoz ya da Ceva Lojistik ile gönderim nasıl yapılır?
Picking durumundaki kalemler için PUT /rest/delivery/v1/collectionRequest ile toplama talebi açılır. Koli adedi, desi ve firma kodu (HLZ, CEVA, BL) gönderilir.
Kargo şablonunda kampanya numarası yoksa ne olur?
N11'in kargo süreci sayfasına göre siparişlerin kargo şablonundaki kampanya numarasıyla gönderilmesi gerekir. Aksi hâlde sipariş geciken kargolama durumuna geçer; teslimat şablonunuzu ve anlaşmalı kargo seçiminizi kontrol edin.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı