RestAPI Sipariş Listeleme
Sipariş Listeleme (GetShipmentPackages)
GET https://api.n11.com/rest/delivery/v1/shipmentPackages
- Authorization no auth seçiniz.
- Headers alanına appkey ve appsecret bilgisini eklemeniz gerekir.
- Servise 1 dakika içerisinde maksimum 1000 adet istek atılabilir.
- HTTP isteğinizi 'GET' methoduyla ilgili endpoint'e gönderin.
Dikkat Edilmesi Gerekenler;
- Status parametresi her istekte tek bir değer alabilmektedir, birden fazla statü listelemek için statü bazlı istek atmanız gerekmektedir.
- 2024 Kasım öncesi sipariş datası bu servisten verilmemektedir.
- Pagination yapısı kullanıyorsanız page 0 başlatarak responsede dönen totalPages alanını dikkate alarak content boş dönen sayfayı son sayfa olarak belirleyebilirsiniz.
- Bu servisten dönen sonuçlar son güncelleme tarihine göre sıralanacaktır, sıralamayı orderByDirection parametresini kullanarak DESC ( Yeniden eskiye ) ya da ASC ( Eskiden yeniye ) değeriyle listeleme yapabilirsiniz.
- Response Body içerisindeki parametre değerleri karakter sayısı ve veri tipleri sipariş sayısının doğal artışıyla beraber değişebilmektedir ( Örneğin orderNumber alanı 12 haneden 13 haneye çıkabilir, entegratör üzerinde tanımlama yapılırken bu durumlar göz önünde bulundurulması sağlıklı olacaktır ).
- Yalnızca startDate alanı girildiyse, girilen startDate'den sonraki 15 günlük kayıtlar listelenir.
- Yalnızca endDate alanı girildiyse, girilen endDate'den önceki 15 günlük kayıtlar listelenir.
- StartDate ve endDate alanları girilmiş fakat iki tarih arasında çok fazla fark varsa ( Örnek olarak 6 ay ya da 2 yıl gibi ) girilen endDate'den önceki son 15 günlük kayıtlar listelenecektir.
- Fatura edilecek toplam tutar için lines bloğundaki sellerInvoiceAmount alanını baz alabilirsiniz, bu alan ürün bazlı döneceğinden ürün sayısına göre dönen sellerInvoiceAmount alanlarını toplayarak sonuca ulaşabilirsiniz.
- Sipariş hesaplama denklemi için line bazlı (price * quantity) - (sellerDiscount + sellerCouponDiscount) = sellerInvoiceAmount ya da (price * quantity) - totalSellerDiscountPrice = sellerInvoiceAmount formüllerini kullanabilirsiniz.
- Response body alanında, lines bloğunda ürün bazlı detaylar dönmektedir, aşağıda yer alan cevap parametrelerine lines alanı bold olarak belirtilmiştir.
- Siparişleri paket güncelleme tarihine göre listelemek istiyorsanız orderByField parameterisin true göndererek tarih parametrelerini kullanabilirsiniz, örneğin startDate alanında başlangıç tarihi ve orderByField true göndererek belirttiğiniz tarih itibariyle paketleri son güncelleme tarihine göre listeleyebilirsiniz.
- Konuma Özel Teslimat siparişlerinde Paket Numarası ( id parametresi ) null dönmektedir. Kargolama süreci satıcıya ait olup, n11 satıcı paneli üzerinden yönetilebilmektedir.
- Satıcı özelinde kampanya dahilinde komisyon indirimi yer alabilmektedir, ürün komisyon tutarı hesaplıyorsanız commissionRate - sellerCampaignCommissionRate formülünden kalan değer üzerinden ürün komisyon oranına ulaşabilirsiniz.
- Content altında yer alan micro parametresinin true olması, siparişin e-ihracat kapsamında olduğunu göstermektedir. Parametre null olan siparişler yurt içi siparişleridir.
- e-İhracat kapsamındaki siparişlerde micro parametresi true olarak dönecektir. Bu siparişler için faturaların ihracat faturası olarak düzenlenmesi ve ilgili fatura bilgilerinin servisler aracılığıyla n11'e iletilmesi gerekmektedir.
| Parametre | Parametre Değer | Açıklama | Tip |
| startDate | Timestamp (milliseconds) ve GMT +3 olarak gönderilmelidir. | Belirtilen tarihten sonraki siparişleri getirir. | long ( timestamp ) |
| endDate | Timestamp (milliseconds) ve GMT +3 olarak gönderilmelidir. | Belirtilen tarihe kadar olan siparişleri getirir. | long ( timestamp ) |
| page | Sadece belirtilen sayfadaki bilgileri döndürür | int | |
| size | Maksimum 100 | Bir sayfada listelenecek maksimum adeti belirtir. | int |
| orderNumber | Sipariş numarası ile sorgulama yapılır. | string | |
| packageIds | Paket numarası ile sorgulama yapılır. | string | |
| status | Created, Picking, Shipped, Cancelled, Delivered, Unpacked, UnSupplied | Belirtilen statülere göre siparişleri getirir. | string |
| orderByDirection | ASC | Eskiden yeniye doğru sıralar. | string |
| DESC | Yeniden eskiye doğru sıralar. | string | |
| orderByField | true, false | true değer girildiğinde, paketin lastModifiedDate alanına göre sorgulama yapabilirsiniz. | string |
| sender | SELLER : Satıcı gönderir N11 : n11 depo gönderir ALL : Tümü |
Sorgulamada kullanılabilecek gönderici tipi, gönderilmediği taktirde default değer "SELLER" olarak alınır. | string |
| Parametre (Cevap) | Açıklama |
| billingAddress | Fatura adresi |
| billingAddress.countryCode | Alıcı ülke kodu |
| billingAddress.invoiceType | Fatura tipi, 1: Bireysel 2: Kurumsal |
| shippingAddress | Teslimat adresi |
| orderNumber | Sipariş numarası |
| id | Paket numarası |
| customerEmail | Alıcı mail adresi |
| customerfullName | Alıcı ad soyad ( invoiceType:2 ise Firma Ünvanı bu alandan dönecektir ) |
| customerId | Alıcı ID bilgisi |
| taxId | Vergi no |
| taxOffice | Vergi dairesi |
| tcIdentityNumber | TC kimlik numarası |
| cargoSenderNumber | Kargo takip numarası |
| cargoTrackingNumber | Kargo barkod numarası / Kargo kampanya kodu |
| cargoTrackingLink | Kargo takip linki |
| shipmentCompanyId | Kargo firma id ( GetShipmentCompanies metodu ile listelenebilir ) |
| cargoProviderName | Kargo firma ünvanı ( GetShipmentCompanies metodu ile listelenebilir ) |
| shipmentMethod | Kargo yöntemi, 1: Kargo 2: Diğer ( dijital, hediye, online teslimat ) |
| installmentChargeWithVATprice | KDV dahil vade farkı |
| lines | Sipariş ürün satırları ( Sipariş ürün bilgilerinin tamamını görüntüleyebilirsiniz ) |
| quantity | Sipariş ürün adedi |
| productId | n11 ürün kodu |
| productName | Ürün adı |
| stockCode | Satıcı ürün kodu |
| variantAttributes | Ürün varyant özellikleri |
| customTextOptionValues | Müşteriye özel ürün seçeneği |
| price | Sipariş ürün birim fiyatı ( indirimler hariç ) |
| dueAmount | Tahsil edilecek tutar |
| installmentChargeWithVAT | KDV dahil vade farkı ( ürün bazlı ) |
| sellerCouponDiscount | Mağaza kupon indirimi |
| sellerDiscount | Mağaza indirimi |
| sellerCampaignCommissionDiscount | Kampanyalı komisyon indirim tutarı |
| sellerInvoiceAmount | Mağaza fatura tutarı |
| totalSellerDiscountPrice | Mağaza indirim toplamı |
| mallDiscount | Ürün ile ilgili n11 indirimi |
| totalMallDiscountPrice | n11 indirimleri toplamı |
| orderLineId | Sipariş ürün ID |
| orderItemLineItemStatusName | Sipariş ürün statüsü |
| vatRate | Sipariş ürün KDV oranı |
| commissionRate | Sipariş ürün komisyon oranı |
| sellerCampaignCommissionRate | Kampanyalı komisyon indirim oranı |
| taxDeductionRate | Sipariş ürün vergi kesinti oranı |
| totalLaborCostExcludingVAT | Sipariş ürün işçilik ücreti |
| netMarketingFeeRate | Pazarlama hizmet bedeli oranı |
| netMarketplaceFeeRate | Pazaryeri hizmet bedeli oranı |
| barcode | Ürün barkodu |
| deliveryFeeType | Kargo Ödeme Tipi, 1: Şartlı Kargo ( n11 Öder ) 3: Mağaza Öder 5: Şartlı Kargo ( Mağaza Öder ) |
| sellerDiscountedPrice | Mağaza indirimli fiyat |
| sender | Gönderici tipi, SELLER: Satıcı gönderir N11: n11 depo gönderir |
| productOrigin | Sipariş ürün menşei bilgisi |
| lastModifiedDate | Sipariş son hareket tarihi |
| agreedDeliveryDate | Maksimum kargolama tarihi |
| totalAmount | Toplam tutar |
| totalDiscountAmount | Toplam indirim tutarı |
| packageHistories | Paket geçmişi ( Paketin geçmiş statülerini tarih bazlı görüntüleyebilirsiniz ) |
| shipmentPackageStatus | Sipariş statüsü |
| sellerId | Satıcı ID bilgisi |
| micro | true : e-İhracat siparişi, null : Yurt içi siparişi |
| hsCode | Ürünün uluslararası gümrük sınıflandırma kodu |
| invoiceLink | Sipariş Fatura Linki ( Yalnızca e-İhracat siparişlerinde kullanılmaktadır ) |
| invoiceDate | Sipariş Fatura Tarihi ( Yalnızca e-İhracat siparişlerinde kullanılmaktadır ) |
| etgbNo | Elektronik Ticaret Gümrük Beyanname Numarası |
| etgbDate | Elektronik Ticaret Gümrük Beyanname Tarihi |
Sipariş listeleme
Örnek Request:
GET : https://api.n11.com/rest/delivery/v1/shipmentPackages?orderNumber={orderNumber}&packageIds={id}&startDate={startDate}&endDate={endDate}&status=Created&orderbyField=true&orderByDirection=ASC&page=0&size=100Yukarıdaki isteği orderNumber ve packageIds parametrelerini kaldırarak GET metodunda çağırdığınızda, startDate ve endDate parametrelerinde girilen tarih aralığındaki paket güncelleme tarihine göre Created statülü 1. sayfadaki hareket tarihi eskiden yeniye 100 adet sipariş listelenecektir.
orderByField parametresi kaldırıldığında ya da false olduğunda girilen tarih aralığı sipariş oluşturma tarihi olarak baz alınacaktır.
orderNumber (Sipariş Numarası) ve packageIds (Paket Numarası) parametrelerini birlikte ya da ayrı ayrı kullanarak sipariş çağırabilirsiniz.
Dökümandaki request parametrelerine göre özelleştirmeler yapabilirsiniz.
Örnek Response
{ "pageCount": 1, "totalPages": 1, "page": 0, "size": 100, "content": [ { "billingAddress": { "address": "Reşitpaşa Mah İstanbul Teknik Üniversitesi Teknokent Arı 3 4/a-3 D:8-9, 34485 Sarıyer/İstanbul", "city": "İstanbul", "district": "Sarıyer", "neighborhood": "Reşitpaşa", "fullName": "n11 müşteri", "gsm": "5xxxxxxxxx", "tcId": "11111111111", "postalCode": "34000", "taxId": null, "taxHouse": null, "invoiceType": 1,"countryCode": "TR" }, "shippingAddress": { "address": "Reşitpaşa Mah İstanbul Teknik Üniversitesi Teknokent Arı 3 4/a-3 D:8-9, 34485 Sarıyer/İstanbul", "city": "İstanbul", "district": "Sarıyer", "neighborhood": "Reşitpaşa", "fullName": "n11 müşteri", "gsm": "5xxxxxxxxx ", "tcId": "11111111111", "postalCode": "34000" }, "orderNumber": "203872347637", "id": "112999455244259", "customerEmail": "n11@n11.com", "customerfullName": "n11 müşteri", "customerId": 12345678, "taxId": null, "taxOffice": null, "tcIdentityNumber": "11111111111", "cargoSenderNumber": null, "cargoTrackingNumber": "112999455244259", "cargoTrackingLink": "", "shipmentCompanyId": 342, "cargoProviderName": "MNG Kargo", "shipmentMethod": 1, "installmentChargeWithVATprice": 0.00, "lines": [ { "quantity": 2, "productId": 123456789, "productName": "Erkek Spor Ayakkabı Bordo 45", "stockCode": "20242024", "variantAttributes": [ { "name": "Numara", "value": "45" }, { "name": "Renk", "value": "Bordo" } ], "customTextOptionValues": [], "price": 292.8, "dueAmount": 536.20, "installmentChargeWithVAT": 0, "sellerCouponDiscount": 0, "sellerCampaignCommissionDiscount": 0, "sellerDiscount": 2.9, "mallDiscount": 43.60, "sellerInvoiceAmount": 579.8, "totalMallDiscountPrice": 43.60, "orderLineId": 415490391, "orderItemLineItemStatusName": "Picking", "totalSellerDiscountPrice": 5.8, "vatRate": 10, "commissionRate": 9, "sellerCampaignCommissionRate": 0, "taxDeductionRate": 1, "totalLaborCostExcludingVAT": 0, "netMarketingFeeRate": 1.2, "netMarketplaceFeeRate": 0.8, "barcode": "8684811136999", "deliveryFeeType": 3, "sellerDiscountedPrice": 289.90, "sender": "SELLER", "productOrigin": "TR" }, { "quantity": 3, "productId": 123456799, "productName": " Erkek Klasik Ayakkabı Kahverengi 42", "stockCode": "202420241", "variantAttributes": [ { "name": "Numara", "value": "42" }, { "name": "Renk", "value": "Kahverengi" } ], "customTextOptionValues": [], "price": 250, "dueAmount": 693.60, "installmentChargeWithVAT": 0, "sellerCouponDiscount": 0, "sellerCampaignCommissionDiscount": 0, "sellerDiscount": 0, "mallDiscount": 28.20, "sellerInvoiceAmount": 750, "totalMallDiscountPrice": 56.40, "orderLineId": 415490390, "orderItemLineItemStatusName": "Picking", "totalSellerDiscountPrice": 0, "vatRate": 10, "commissionRate": 9, "sellerCampaignCommissionRate": 0, "taxDeductionRate": 1, "totalLaborCostExcludingVAT": 0, "netMarketingFeeRate": 1.2, "netMarketplaceFeeRate": 0.8, "barcode": null, "deliveryFeeType": 3, "sellerDiscountedPrice": 0, "sender": "SELLER", "productOrigin": "TR" } ], "lastModifiedDate": 1724323386203, "agreedDeliveryDate": 1725310828346, "totalAmount": 1479.79, "totalDiscountAmount": 62.3, "packageHistories": [ { "createdDate": 1724274054460, "status": "Created" }, { "createdDate": 1724274255751, "status": "Picking" }, { "createdDate": 1724274492082, "status": " Shipped" }, { "createdDate": 1724396400000, "status": " Delivered" } ], "shipmentPackageStatus": "Delivered", "sellerId": 9876543, "micro": null, "hsCode": "null", "invoiceLink": "https://extfatura.faturaentegratoru.com/324523-34523-52345-3453245.pdf", "invoiceDate": 1780903800000, "etgbNo": "null", "etgbDate": null } ] }