Parametreler
| Parametre | Değer | Açıklama |
|---|---|---|
| startDate | Zaman damgası (ms), GMT+3 | Bu tarihten sonraki siparişler |
| endDate | Zaman damgası (ms), GMT+3 | Bu tarihe kadar olan siparişler |
| status | Created, Picking, Shipped, Cancelled, Delivered, Unpacked, UnSupplied | İstek başına tek değer |
| orderNumber | Sipariş numarası | Tek siparişi getirir |
| packageIds | Paket numarası | Tek paketi getirir |
| orderByDirection | ASC ya da DESC | Son güncelleme tarihine göre sıralama |
| orderByField | true ya da false | true ise tarihler paketin son güncelleme tarihine uygulanır |
| page, size | Sayfalama | size en fazla 100 |
| sender | SELLER, N11 ya da ALL | Varsayılan SELLER; n11depom kullananlar için gerekli |
status birden fazla değer almaz. Örneğin hem yeni hem onaylanmış paketleri istiyorsanız Created ve Picking için ayrı istek atın ya da status vermeden çekip kendi tarafınızda süzün.
Tarih aralığı kuralları
Bu servisin en çok gözden kaçan kısmı tarih davranışıdır. Dokümana göre:
- Yalnız startDate verilirse o tarihten sonraki 15 günün kayıtları gelir.
- Yalnız endDate verilirse o tarihten önceki 15 günün kayıtları gelir.
- İki tarih arasında çok büyük fark varsa (örnekler: 6 ay, 2 yıl) servis endDate'ten önceki son 15 günü döndürür.
- orderByField verilmezse ya da false ise tarih aralığı sipariş oluşturma tarihine uygulanır; true ise paketin son güncelleme tarihine uygulanır.
- Kasım 2024 öncesi sipariş verisi bu servisten verilmez.
Uzun bir dönemi eksiksiz çekmek istiyorsanız aralığı 15 günlük pencerelere bölün ve pencereleri sırayla isteyin. Yalnız değişen siparişleri izlemek içinse orderByField true ile son güncelleme tarihine göre sorgu yapın.
Sayfalama ve yanıt
Yanıt totalElements, totalPages, page, size ve content alanlarını içerir. content dizisindeki her eleman bir pakettir. N11'in önerisi page 0'dan başlamak, totalPages'e göre ilerlemek ve content boş dönen sayfayı son sayfa saymaktır.
Bir sipariş birden fazla paket olabilir. Aynı orderNumber'a sahip paketler farklı id (paket numarası) ve farklı cargoTrackingNumber taşır. Paket bölme sonrası ana paket Unpacked durumuna geçer. Bu yüzden sipariş tablonuzu paket numarasıyla tutun. Alanların ayrıntısı için N11 sipariş detayı ve durumları sayfasına bakın.
Sık hatalar
- Saniye cinsinden tarih: startDate ve endDate milisaniyelik zaman damgasıdır.
- Geniş aralık: 6 aylık bir aralık isteyip tamamını aldığınızı sanmak. Servis yalnız son 15 günü döndürebilir.
- Tek sayfada kalmak: size en fazla 100 olduğu için yoğun günlerde birden fazla sayfa gerekir.
- Paketi sipariş sanmak: Bölünmüş siparişler birden fazla paket olarak gelir; Unpacked paketi ikinci kez işlemeyin.
- Alan uzunluğu: Dokümana göre orderNumber gibi alanlar 12 haneden 13 haneye çıkabilir.
Sık sorulanlar
N11 siparişleri API ile nasıl çekilir?
GET https://api.n11.com/rest/delivery/v1/shipmentPackages isteğiyle. startDate ve endDate milisaniyelik zaman damgası olarak verilir, sayfa başına en fazla 100 paket gelir.
N11 sipariş servisinde tarih aralığı sınırı var mı?
Evet. Yalnız bir tarih verilirse 15 günlük kayıt gelir; iki tarih arasında çok büyük fark varsa endDate'ten önceki son 15 gün döner. Uzun dönemleri 15 günlük parçalara bölün.
Birden fazla durumdaki siparişi tek istekte alabilir miyim?
Hayır. status parametresi istek başına tek değer alır. Her durum için ayrı istek atın ya da durum vermeden çekip kendi tarafınızda süzün.
Eski N11 siparişleri neden gelmiyor?
REST sipariş servisi Kasım 2024 öncesi sipariş verisini vermez. Daha eski siparişler için mağaza panelindeki raporları kullanın.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı