Paketleme akışı
| Adım | Ne olur | Doğrulama |
|---|---|---|
| 1. Kalemleri seçin | Paketlenecek listesinden kalem kimlikleri (id) alınır | Kalem Open ya da Unpacked durumda |
| 2. Paketleyin | Kalemler adetleriyle pakete konur | İstek başarılı döner |
| 3. Paket numarası | Paket oluşur, numara atanır | Sipariş detayında packageNumber |
| 4. Gönderime hazır | Sipariş fatura bekleyenlere geçer | missing-invoice listesi |
| 5. Kargo | Kargo firması paketi teslim alır | shipped listesi |
Paketleme isteği başarılı dönse bile paketin gerçekten oluştuğunu sipariş detayından ya da gönderime hazır paketler listesinden doğrulayın.
İstekte ne gönderilir?
Paketleme kalem düzeyinde yapılır. Her kalem için kalemin kimliği ve pakete konacak adet gönderilir. Saystok'un kodunda bu istek lineItemRequests adlı bir dizi içinde id ve quantity alanlarıyla kurgulanmıştır; isteğe bağlı olarak kargo firması da eklenebilir.
- id: paketlenecek listesindeki kalem kimliği.
- quantity: pakete konacak adet.
- Kargo firması: isteğe bağlı; kısa adla.
Bu çağrının yolu canlıda doğrulanmadı. Güncel yol, alan adları ve hangi kalemlerin aynı pakete konabileceğini gösteren yardımcı uç için resmî dokümandaki paket bölümüne bakın.
Aynı pakete hangi kalemler konabilir?
Her kalem her kalemle aynı pakete girmeyebilir. Hepsiburada, bir kalemle aynı pakete konabilecek kalemleri listeleyen yardımcı bir işlem sunar; Saystok'un kodunda bu işlem kalem kimliğiyle çağrılır. Paketlemeden önce bu listeye bakmak, reddedilen istekleri önler.
Aynı siparişin kalemleri farklı paketlere bölünebilir. Bu durumda tek sipariş numarası altında birden çok paket numarası ve kargo barkodu olur. Arayüzde her paketi ayrı satır göstermek, hazırlayan ekibin hangi barkodu hangi kutuya yapıştıracağını karıştırmasını önler.
Paket oluşunca gelen bildirim
Hepsiburada paket oluştuğunda CreatePackages adlı bir bildirim gönderir. Bildirimin gövdesinde packageNumber alanı bulunur. Webhook kullanıyorsanız bu bildirim, siparişin durumunu ekranda "hazırlanıyor"a çekmenin en hızlı yoludur. Bildirimleri kaçırırsanız durum, bir sonraki düzenli okumada fatura bekleyenler listesinden yakalanır.
Bildirim kurulumunun ayrıntısı webhook bildirimleri sayfasında.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Paketlenen sipariş listeden kayboldu | Fatura bekleyenler listesi okunmuyor | missing-invoice ucunu okuyun |
| Paket numarası bulunamıyor | Sipariş henüz paketlenmedi | Paketleme sonrası detayı yeniden sorgulayın |
| Paketleme reddedildi | Kalemler aynı pakete uygun değil | Uygun kalemleri dokümandaki yardımcı uçla kontrol edin |
| Kalem kimliği yerine sipariş numarası gönderildi | Kimlikler karıştırıldı | Kalemin id alanını kullanın |
Sık sorulanlar
Hepsiburada'da paket numarası ne zaman oluşur?
Sipariş kalemleri pakete konduğunda. Öncesinde sipariş detayında packageNumber alanı bulunmaz.
Paketleme için hangi kimlik gerekir?
Sipariş numarası değil, kalem kimliği (id). Kimlik paketlenecek sipariş listesindeki her kalemde yer alır.
Paketlenen sipariş API'de nerede görünür?
Fatura bekleyen paketler listesinde (missing-invoice). Kargo teslim alınca kargodakiler listesine geçer.
Bir sipariş birden çok pakete bölünebilir mi?
Evet. Bu durumda aynı sipariş numarası altında farklı paket numaraları ve kargo barkodları olur.
Paketlemeden sonra stok yeniden düşer mi?
Düşmemeli. Stok sipariş geldiğinde (Open) bir kez düşer. Paketleme yalnız siparişin aşamasını değiştirir; paketleme olayında stok düşüren bir kural çift düşüm üretir.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı