Sipariş yolculuğundaki boşluk
Bir sipariş paketlendiği anda paketlenecek listesinden çıkar. Kargo firması paketi teslim alana kadar da kargodakiler listesine girmez. Bu aradaki süre, yani "gönderime hazır" aşaması, yalnız bu uçla görülebilir.
| Aşama | Görüldüğü uç |
|---|---|
| Yeni, paketlenecek | /orders/merchantid/SATICI_ID |
| Paketlendi, fatura bekliyor | /packages/merchantid/SATICI_ID/missing-invoice |
| Kargoya verildi | /packages/merchantid/SATICI_ID/shipped |
| Teslim edildi | /packages/merchantid/SATICI_ID/delivered |
Bu boşluğu kapatmayan entegrasyonlarda sipariş, satıcı "Paketle" dediği anda listeden kaybolur ve ancak kargo hareketi başlayınca geri gelir. Bu süre içinde siparişi hazırlayan ekip onu ekranda göremez.
Yanıt ve çoğul alan tuzağı
Uç limit ve offset alır; yanıt totalCount ve items taşır. Asıl tuzak alan adındadır: bu uç sipariş numarasını yalnız çoğul alanla (orderNumbers ya da OrderNumbers) döndürdü. Tekil orderNumber alanına bakan kod, bu paketlerdeki siparişlerin hepsini sessizce atladı.
- Her paket satırında önce tekil sipariş alanına, yoksa çoğul alana bakın.
- Çoğul alan bir dizidir; bir pakette birden çok sipariş birleşmiş olabilir.
- Paket numarasını da saklayın; fatura linki gönderimi paket numarasıyla yapılır.
Fatura bekleyen paketle ne yapılır?
Uç adından da anlaşılacağı gibi bu paketlerin faturası henüz yüklenmemiştir. İş akışında bu liste bir "yapılacaklar" listesidir:
- Faturayı kesin; e-arşiv ya da e-fatura.
- Fatura bağlantısını pakete iletin; ayrıntı fatura linki gönderme sayfasında.
- Kargo etiketini paketin üstüne yapıştırın; ayrıntı kargo etiketi sayfasında.
- Kargo teslim alınca paket kargodakiler listesine geçer.
Fatura kesimi tarafında e-arşivin temelleri e-ticarette fatura ve vergi yazısında anlatılıyor.
Durumu nasıl göstermeli?
Bu listeden gelen siparişleri "hazırlanıyor" ya da "gönderime hazır" gibi bir durumla gösterin. Detay bilgisi (müşteri, ürün, tutar) için sipariş numarasıyla sipariş detayı ucunu çağırın.
Paket bu listeden düştüğünde ya kargoya verilmiştir ya da bozulmuştur. Bir sonraki okumada siparişi kargodakiler listesinde ya da paketlenecekler listesinde (Unpacked) arayın. İkisinde de yoksa iptal listesine bakın.
Bazı entegrasyonlar bu boşluğu, daha önce gördükleri açık sipariş numaralarını bir süre hatırlayarak kapatmaya çalışır. Bu yöntem yalnız sipariş paketlenecek listesinde en az bir kez görüldüyse işe yarar. missing-invoice ucunu okumak hem daha basit hem daha sağlamdır.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Paketlenen sipariş listeden kayboldu | missing-invoice ucu okunmuyor | Bu ucu sipariş okumasına ekleyin |
| Uç kayıt döndürüyor ama sipariş eklenmiyor | Yalnız tekil orderNumber okunuyor | Çoğul orderNumbers alanını da okuyun |
| Aynı sipariş iki kez listede | Paketlenecek ve gönderime hazır listeleri birleştirilirken tekilleştirilmedi | Sipariş numarasıyla tekilleştirin |
Sık sorulanlar
Hepsiburada missing-invoice ucu ne döndürür?
Paketlenmiş ama faturası yüklenmemiş, kargo firmasının henüz teslim almadığı paketleri.
Paketlediğim sipariş API'de neden görünmüyor?
Paketlenecek listesinden çıkmış, kargodakilere henüz girmemiştir. missing-invoice ucunu okuyun.
Bu uçta sipariş numarası hangi alanda?
Çoğul orderNumbers alanında. Tekil alana bakan kod bu siparişleri kaçırır.
Paket bu listeden ne zaman çıkar?
Kargoya verildiğinde ya da paket bozulduğunda. Siparişi kargodakiler ya da paketlenecekler listesinde arayın.
Fatura bağlantısını iletince paket bu listeden çıkar mı?
Uç faturası yüklenmemiş paketleri listeler. Bağlantıyı ilettikten sonra paketin listede kalıp kalmadığını kontrol edin; kalıyorsa bağlantının doğru paket numarasına gittiğini doğrulayın.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı