Üç uç ve anlamları
| Uç | Paketin durumu | Sipariş listesinde |
|---|---|---|
| /packages/merchantid/SATICI_ID/shipped | Kargoya verildi, yolda | Kargoda |
| /packages/merchantid/SATICI_ID/delivered | Müşteriye teslim edildi | Teslim edildi |
| /packages/merchantid/SATICI_ID/undelivered | Teslim edilemedi | Teslim edilemedi |
Bu uçlar, paketlenecek sipariş listesinden çıkan siparişleri yakalamanın yoludur. Yalnız paketlenecek listesini okuyan bir entegrasyon, kargoya verilen her siparişi gözden kaybeder.
Yanıt ve alan adı farkları
Yanıt totalCount ve items alanlarını taşır. items boş olduğunda null gelebilir; kodunuz boş diziyle aynı biçimde davransın.
Paket satırlarında alan adlarının yazımı değişkendir. Aynı bilgi bazen büyük harfle (PackageNumber, OrderNumber), bazen küçük harfle (packageNumber, orderNumber) gelir. Bir pakette birden çok sipariş birleşmişse tekil alan yerine çoğul alan (OrderNumbers ya da orderNumbers) kullanılır.
| Bilgi | Görülen yazımlar |
|---|---|
| Paket numarası | PackageNumber, packageNumber |
| Tek sipariş numarası | OrderNumber, orderNumber |
| Birden çok sipariş numarası | OrderNumbers, orderNumbers |
Dört yazımın hepsini okuyan küçük bir yardımcı işlev yazın. Yalnız birine bakan kod, bazı paketlerdeki siparişleri sessizce kaybeder.
Tarih filtresi yok: sayfa sayfa gezin
Bu uçlar tarih parametresi almaz; yalnız limit ve offset ile sayfalanır. Eski bir ayın siparişine ulaşmak için listeyi baştan gezmek gerekir. Sayfa sayısını sabit küçük bir değerde tutmak, eski ayların hiç okunmamasına yol açar; kâr-zarar raporunda bazı aylar eksik görünür.
- Sayfa boyutunu sabit tutun ve offset değerini her turda artırın.
- Gelen kayıt sayfa boyutundan azsa durun.
- İstenen döneme göre bir üst sınır koyun; tüm geçmişi her seferinde okumayın.
- Okunan sipariş numaralarını kaydedin; detayı yalnız yeni gelenler için çağırın.
Detayla zenginleştirmek
Paket satırı müşteri adını, ürünleri ve tutarı taşımaz. Bu bilgiler için her sipariş numarasıyla sipariş detayı ucu çağrılır. Akış şöyledir:
- Üç uçtan sipariş numaralarını toplayın.
- Elinizdeki listede zaten olanları ayıklayın.
- Kalanların detayını sınırlı eşzamanlılıkla çekin.
- Durumu, numarayı hangi uçtan aldığınıza göre atayın.
Aynı sipariş numarası birden çok listede görünebilir. Paket numaralarını sipariş başına toplayın. İki ya da daha fazla paket varsa siparişin tüm kalemlerini detaydan alın; kalemlerdeki paket numarası, kargo barkodu ve durum her paketi ayrı göstermeye yeter.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Kargodaki siparişler hiç görünmüyor | Yalnız paketlenecek listesi okunuyor | packages uçlarını da okuyun |
| Bazı paketlerin siparişi kayıp | Yalnız tek bir alan yazımı okunuyor | Tekil, çoğul, büyük ve küçük harfli yazımların hepsini okuyun |
| Eski aylar raporda eksik | Sayfalama erken kesiliyor | Döneme göre yeterli sayfa okuyun |
| Teslim edilemeyen siparişler yok | undelivered ucu hiç çağrılmıyor | Üç ucu birlikte okuyun |
Sık sorulanlar
Hepsiburada kargoya verilen siparişleri nasıl çekerim?
OMS servisinde GET /packages/merchantid/SATICI_ID/shipped ucundan. Teslim edilenler için /delivered, teslim edilemeyenler için /undelivered kullanılır.
Paket listelerinde tarih filtresi var mı?
Yok. Uçlar yalnız limit ve offset alır; eski kayıtlara sayfa sayfa ilerleyerek ulaşılır.
Paket satırında müşteri adı neden yok?
Bu uçlar yalnız paket ve sipariş numarasını taşır. Müşteri ve ürün bilgisi sipariş detayı ucundan alınır.
Alan adları neden bazen büyük harfle geliyor?
Paket uçlarında yazım değişkendir. Hem büyük hem küçük harfli yazımı ve çoğul sipariş alanını birlikte okuyun.
Aynı sipariş iki farklı listede görünebilir mi?
Evet, sipariş birden çok pakete bölündüyse. Bir paket teslim edilmişken diğeri hâlâ kargoda olabilir. Paketleri sipariş başına toplayın ve her paketi kendi durumuyla gösterin.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı