Ne değişti: getShipmentPackage (sipariş paket listeleme) API'sı artık tek sorguda maksimum 10.000 kayıt döndürüyor.
Ne zaman: 8 Haziran 2026 itibarıyla geçerli.
Kaynak: Trendyol Geliştirici Değişiklik Günlüğü (changelog), 2 Haziran 2026.
Büyük veri için: Yeni toplu tarama servisi kullanılmalı.
Ne Değişti, Tam Olarak Ne Anlama Geliyor?
Trendyol'un getShipmentPackage API'sı, satıcıların ve entegrasyon yazılımlarının sipariş paketlerini listelemek için kullandığı temel servislerden biri. Daha önce bu servisten tek sorguda teorik olarak sınırsız (ya da çok yüksek limitli) kayıt çekmek mümkündü.
8 Haziran 2026 itibarıyla bu sınır 10.000 kayıt olarak netleştirildi. Yani bir tarih aralığında 10.000'den fazla sipariş paketi oluşmuşsa, tek sorguda tamamını alamazsınız. Gerisi sessizce atılır — hata vermez, eksik veri döner.
Limit aşıldığında API hata kodu döndürmez — sadece 10.000 kayıt gelir, kalanları almaz. Entegrasyon bunu fark etmeden devam ederse sipariş takibi eksik kalır. Günlük 300+ sipariş alan satıcılar haftalık taramalarda bu durumla karşılaşabilir.
Kim Etkileniyor?
| Satıcı Profili | Günlük Sipariş | Durum | Aksiyon |
|---|---|---|---|
| Küçük satıcı | 0–30 | Etkilenmiyor | Değişiklik gerekmez |
| Orta ölçekli satıcı | 30–300 | Dikkat | Haftalık tarama yapanlar kontrol etmeli |
| Büyük satıcı / mağaza grubu | 300+ | Etkileniyor | Tarih aralığı bölünmeli veya yeni servis kullanılmalı |
| ERP / entegrasyon firmaları | Toplu tarama | Kritik | Sayfalama (pagination) ve tarih bölme zorunlu |
Ne Yapmalısınız?
1. Tarih Aralığını Bölün (En Hızlı Çözüm)
Büyük tarih aralığı yerine günlük ya da 6 saatlik dilimler halinde sorgu yapın. Her dilimde 10.000 altında kalıyorsanız tüm verileri alırsınız:
Eski yaklaşım (sorunlu):
GET /orders?startDate=2026-06-01&endDate=2026-06-30
→ 10.000 kayıt gelir, 8.000 kayıt sessizce atılır
Doğru yaklaşım:
GET /orders?startDate=2026-06-01T00:00&endDate=2026-06-01T23:59
GET /orders?startDate=2026-06-02T00:00&endDate=2026-06-02T23:59
... (her gün için ayrı sorgu)
2. Sayfalama (Pagination) Kullanın
Trendyol API'sı sayfalama destekliyorsa page ve size parametreleri ile toplam kayıt sayısını parça parça çekebilirsiniz. Entegrasyon yazılımınızın dönen totalCount değerini kontrol ettiğinden emin olun.
3. Büyük Veri için Yeni Servis
Trendyol, 10.000 üzeri kayıt taraması için ayrı bir toplu veri servisi duyurdu. Changelog'a göre bu servis özellikle ERP entegrasyonları ve büyük satıcı operasyonları için tasarlandı. Trendyol Seller API belgelerini ve geliştirici portalını kontrol edin.
4. Entegrasyon Sağlayıcınıza Danışın
Entegrasyon yazılımı (ERP, depo yönetim sistemi, sipariş yönetim paneli) kullananlar için yapılması gereken ilk adım sağlayıcınızı aramak. Çoğu entegrasyon firması bu güncellemeyi zaten uygulamış durumda ya da yakında yayınlayacak.
- Entegrasyon yazılımınız sayfalama veya tarih bölme yapıyor mu? → Yapıyorsa sorun yok.
- Son haftalarda sipariş sayısında beklenmedik düşüş var mı? → Veri kaybı olabilir.
- Toplu tarih aralığı sorgulama yapıyorsanız → 10.000 limiti aşıp aşmadığınızı test edin.
- Entegrasyon sağlayıcınız bu değişikliği uyguladı mı? → Teyit edin.
Neden Bu Değişiklik Yapıldı?
Trendyol'un bu tür kısıtlamaları genellikle iki nedene dayanır: API sunucusu üzerindeki yükü dengelemek ve kötüye kullanımı önlemek. Binlerce satıcının eşzamanlı büyük veri çekimi altyapıya ciddi yük bindirebilir.
Limit, aynı zamanda satıcıları daha iyi veri yönetimi pratiklerine yönlendirme amacı da taşıyor. Büyük tarih aralıklarında toplu tarama yerine near-realtime (anlık benzeri) küçük sorguların sistem için daha sağlıklı olduğu bilinmektedir.