Sorgu parametreleri
| Parametre | Değer | Açıklama |
|---|---|---|
| startDate / endDate | Milisaniye zaman damgası, GMT+3 | Aralık en fazla iki hafta |
| page / size | size en fazla 200 | Sayfalama sıfırdan başlar |
| status | Created, Picking, Invoiced, Shipped, Cancelled, Delivered, UnDelivered, Returned, AtCollectionPoint, UnPacked, UnSupplied, Awaiting, Verified | Paket statüsüne göre filtre |
| orderNumber | Sipariş numarası | Tek siparişin paketleri |
| shipmentPackageIds | Paket kimlikleri | Paket numarasıyla sorgu |
| orderByField | PackageLastModifiedDate | Son güncelleme tarihine göre sıralama |
| orderByDirection | ASC ya da DESC | Eskiden yeniye ya da yeniden eskiye |
Trendyol'un önerdiği örnek sorgu: status=Created, startDate ve endDate ile birlikte orderByField=PackageLastModifiedDate, orderByDirection=DESC ve size=50. İptal edilenleri bulmak için status=Cancelled ve UnSupplied, bölünmüş paketler için status=UnPacked kullanılır.
Önemli yanıt alanları
| Alan | Açıklama |
|---|---|
| shipmentPackageId | Paket kimliği; statü, etiket ve fatura işlemleri bu kimlikle yapılır |
| orderNumber | Trendyol'daki ana sipariş numarası; bir siparişin birden çok paketi olabilir |
| status, shipmentPackageStatus | Paketin güncel statüsü |
| orderDate / createdDate | orderDate GMT+3, createdDate GMT olarak milisaniye cinsinden gelir |
| lines | Kalemler: lineId, barcode, stockCode, quantity, productName, lineUnitPrice, vatRate, productOrigin |
| shipmentAddress / invoiceAddress | Teslimat ve fatura adresi; kurumsal siparişte company, taxNumber, taxOffice, eInvoiceAvailable |
| commercial | true ise kurumsal faturalı sipariş |
| cargoTrackingNumber, cargoProviderName, cargoTrackingLink | Kargo bilgileri |
| paymentMethod | Ödeme yöntemi; Eylül 2026'da eklendi |
| micro | true ise mikro ihracat siparişi; ülke koduyla eşleştirilmemeli |
| identityNumber | Altın, gübre ve 5000 TL üzeri siparişlerde müşterinin TCKN bilgisi |
| createdBy | order-creation, cancel, split ya da transfer |
Tutar alanları zamanla genişledi. Doküman örneğinde paket tutarı packageGrossAmount, kalem fiyatı lineUnitPrice ve lineGrossAmount gibi alanlarla gelir. Hangi alanı kullandığınızı güncel örnek yanıtla doğrulayın.
10.000 kayıt sınırı
v2 servisi tek bir filtreyle en fazla 10.000 paket kimliğine erişim verir. Sınır paket bazındadır: bölünmüş bir siparişin her paketi ayrı sayılır. size=200 ile güvenli sayfa aralığı page=0 ile page=49'dur.
Yanıttaki totalElements 10.000'den büyükse aynı filtreyle bütün kayıtlara ulaşamazsınız. Üç çözüm vardır: tarih aralığını küçültmek, statü ya da sipariş numarası gibi filtreleri daraltmak veya akış servisine geçmek. Doküman ayrıca erişilebilir veri kapsamının son 1 ayla sınırlanacağını belirtir.
Sık hatalar ve çözümleri
| Belirti | Neden | Çözüm |
|---|---|---|
| 426 ya da brownout mesajı | Eski /orders yolu kullanılıyor | /v2/orders yoluna geçin |
| Uzun aralıkta sonuç boş | Aralık iki haftayı aşıyor | Sorguyu iki haftalık pencerelere bölün |
| Saatler bir gün kayıyor | orderDate GMT+3, createdDate GMT | Saat dilimini alan bazında çevirin |
| Paket kimliği değişti | Kısmi iptal ya da bölme yeni paket üretti | Aynı orderNumber'ın paketlerini yeniden çekin |
| 429 | En düşük kademede dakikada 30 istek | İstekleri yayın; webhook ile tamamlayın |
Awaiting statüsündeki paketleri yalnız stok ayırmak için kullanın. Doküman bu paketleri kargoya vermemenizi, iptal olabileceklerini söyler.
Sık sorulanlar
Trendyol siparişlerini API ile nasıl çekerim?
GET /integration/order/sellers/{sellerId}/v2/orders servisine startDate, endDate, status ve size parametreleriyle istek atın. Yanıt paket bazında döner; bir sayfada en fazla 200 paket gelir.
Tarih vermezsem hangi siparişler gelir?
Tarih parametresi olmadan son bir haftadaki siparişler döner. startDate ve endDate verirseniz aralık en fazla iki hafta olabilir.
orderNumber ile shipmentPackageId farkı nedir?
orderNumber müşterinin siparişidir; shipmentPackageId bu siparişten oluşan pakettir. Bir sipariş bölünürse ya da kısmen iptal edilirse aynı orderNumber altında yeni paket kimlikleri oluşur.
10.000'den fazla sipariş paketim varsa ne yapmalıyım?
Tarih aralığını küçültün, filtreleri daraltın ya da cursor tabanlı getShipmentPackagesStream servisini kullanın. v2 servisi bir filtreyle en fazla 10.000 kayda erişim verir.
Kurumsal siparişi nasıl anlarım?
Paketteki commercial alanı true ise sipariş kurumsaldır. Firma adı, vergi numarası ve vergi dairesi invoiceAddress altında; e-fatura mükellefiyeti eInvoiceAvailable alanında gelir.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı