Paket seviyesindeki alanlar
| Alan | Anlamı |
|---|---|
| id | Paket numarası |
| orderNumber | Sipariş numarası |
| shipmentPackageStatus | Paket durumu |
| customerfullName, customerEmail, customerId | Alıcı bilgileri; kurumsal faturada ad alanında firma unvanı |
| taxId, taxOffice, tcIdentityNumber | Vergi ve kimlik bilgileri |
| billingAddress, shippingAddress | Fatura ve teslimat adresi; invoiceType 1 bireysel, 2 kurumsal |
| cargoTrackingNumber | Kargo barkod numarası ya da kargo kampanya kodu |
| cargoSenderNumber, cargoTrackingLink | Kargo takip numarası ve takip bağlantısı |
| cargoProviderName, shipmentCompanyId | Kargo firması |
| shipmentMethod | 1 kargo, 2 diğer (dijital, hediye, online teslimat) |
| agreedDeliveryDate | En geç kargolama tarihi |
| lastModifiedDate | Son hareket tarihi |
| packageHistories | Durum geçmişi ve tarihleri |
| totalAmount, totalDiscountAmount | Toplam ve toplam indirim |
| micro, deliveryAddressType | E-ihracat işareti; teslimat noktası tipi (KTN, EASYPOINT, PUP) |
Kalem (lines) alanları ve tutar hesabı
Her kalemde orderLineId, productId, productName, stockCode, barcode, quantity, price, variantAttributes, vatRate, commissionRate ve indirim alanları bulunur. orderLineId, onay ve paket bölme servislerinde kullanılan kalem numarasıdır.
N11'in verdiği hesap formülü şudur: (price × quantity) − (sellerDiscount + sellerCouponDiscount) = sellerInvoiceAmount. Aynı sonuç (price × quantity) − totalSellerDiscountPrice ile de bulunur. Siparişin fatura tutarı, kalemlerdeki sellerInvoiceAmount değerlerinin toplamıdır. N11'in kendi indirimleri (mallDiscount) bu tutarı düşürmez.
Komisyon hesabında kampanyalı indirim de hesaba katılır: commissionRate − sellerCampaignCommissionRate, kalemin net komisyon oranını verir.
Paket durumları ve SOAP karşılıkları
REST servisinde durum yedi değerden biridir. Eski SOAP sipariş servisindeki sayısal durumların karşılığı N11'in karşılaştırma tablosunda verilir:
| REST durumu | Anlamı | Eski SOAP karşılıkları |
|---|---|---|
| Created | Yeni, onay bekliyor | 2 Ödendi, 14 Kargo Yapılması Gecikmiş |
| Picking | Onaylandı, hazırlanıyor | 5 Kabul Edilmiş, 15 Zamanında Kargoya Verilmemiş, 51 İptal Talep Edildi |
| Shipped | Kargoda | 6 Kargoda, 13 Kargoda İade |
| Delivered | Teslim edildi | 7, 9, 10, 11, 12, 16, 17, 52, 53 |
| Cancelled | İptal | 4 İptal Edilmiş |
| UnSupplied | Satıcı tedarik edemedi | 8 Reddedilmiş |
| Unpacked | Paket bölündü; yerine yeni paketler oluştu | Karşılığı yok |
Tablo bir şeyi açıkça gösterir: iade ve değişim talepleri paketin durumunu değiştirmez, paket Delivered kalır. İadeleri ayrıca iade talepleri servisinden izlemeniz gerekir.
Sık hatalar
- Sipariş tarihini lastModifiedDate'ten almak: Bu alan son hareketin tarihidir. Siparişin oluşma zamanı packageHistories içindeki Created satırındadır.
- totalAmount ile fatura kesmek: Faturaya esas tutar sellerInvoiceAmount toplamıdır.
- Teslimat noktası siparişinde adres: deliveryAddressType doluysa shippingAddress teslimat noktasının adresidir ve shippingAddress.fullName boş gelir. Alıcı bilgisini billingAddress'ten alın.
- TCKN'nin hep dolu olacağını varsaymak: Change Log'a göre 15 Ekim 2025'ten beri TCKN bilgisi olmayan alıcılarda bu alan boş dönüyor.
Sık sorulanlar
N11'de tek bir siparişin detayı nasıl alınır?
Sipariş listeleme servisine orderNumber ya da packageIds parametresi verilir. Ayrı bir sipariş detayı servisi yoktur; aynı yanıt bütün paket ve kalem bilgilerini içerir.
N11 siparişinde fatura tutarı hangi alandır?
Her kalemdeki sellerInvoiceAmount alanı. Siparişin fatura tutarı bu alanların toplamıdır; N11'in formülü (price × quantity) − (sellerDiscount + sellerCouponDiscount) şeklindedir.
Picking durumu ne anlama gelir?
Siparişin satıcı tarafından onaylandığını ve hazırlandığını gösterir. Eski SOAP servisindeki "Kabul Edilmiş" durumunun karşılığıdır.
İade edilen sipariş hangi durumda görünür?
N11'in karşılaştırma tablosuna göre iade talepleri paket durumunu değiştirmez, paket Delivered olarak kalır. İadeler ayrı bir SOAP servisinden izlenir.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı