Bölme ile bozma farkı
| Konu | Paket bölme | Paket bozma |
|---|---|---|
| Sonuç | Bir paket ikiye ayrılır | Paket ortadan kalkar |
| Kalemler | Bir kısmı yeni pakete geçer | Hepsi paketlenecek listesine döner |
| Kalem durumu | Paketli kalır | Unpacked |
| Paket numarası | Yeni paket için yeni numara | Eski numara geçersizleşir |
| Ne zaman | Ürünler farklı zamanlarda hazır olacaksa | Paket yanlış kurulduysa ya da kalem değişecekse |
Bozulan paketin etiketi ve kargo barkodu artık kullanılmamalıdır. Kutunun üstünde eski etiket kaldıysa sökün; yeni paket için yeni etiket alın.
İstekte ne gönderilir?
Bölme isteği paket numarasıyla ve yeni pakete alınacak kalemlerin kimliği ile adediyle yapılır. Saystok'un kodunda bölme isteği paket oluşturmayla aynı yapıda, lineItemRequests dizisi içinde id ve quantity alanlarıyla kurgulanmıştır. Bozma isteği ise yalnız paket numarasıyla yapılır.
- Bölme: paket numarası ve kalemler (id, quantity).
- Bozma: paket numarası.
Bu iki çağrının yolu canlıda doğrulanmadı. Güncel yollar için resmî dokümandaki paket bölümüne bakın.
Unpack bildirimi
Paket bozulduğunda Hepsiburada webhook adresinize bir bildirim gönderir. Bu bildirim diğer olaylardan farklı olarak POST değil PUT yöntemiyle gelir. Bildirim alıcınız yalnız POST kabul ediyorsa Unpack olaylarını hiç görmezsiniz.
| Olay | Yöntem | Ne yapılmalı |
|---|---|---|
| Unpack | PUT | Sipariş listesini tazeleyin; kalemler yeniden paketlenecek |
| CreatePackages | POST | Yeni paket numarasını alın |
Unpack geldiğinde eski paket numarasını kendi kaydınızda geçersiz sayın. Etiket ya da fatura linki gibi işlemleri eski numarayla göndermeye çalışmak hata üretir.
Çok paketli siparişleri yönetmek
Bölme sonrası aynı sipariş numarası altında birden çok paket olur. Her paketin kendi numarası, kargo barkodu ve durumu vardır. Bir paket kargodayken diğeri hâlâ hazırlanıyor olabilir.
- Arayüzde her paketi ayrı satırda gösterin.
- Durumu paket düzeyinde tutun.
- Stok düşümünü sipariş düzeyinde, bir kez yapın. Paket satırları yalnız gösterim içindir; her paket için ayrı düşüm aynı ürünü iki kez düşürür.
- Etiketleri paket başına alın ve kutulara karıştırmadan yapıştırın.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Bozulan paketler fark edilmiyor | Webhook alıcısı PUT kabul etmiyor | Aynı adreste PUT isteğini de kabul edin |
| Bölünmüş siparişte stok iki kez düştü | Düşüm paket satırı başına yapıldı | Düşümü sipariş düzeyinde bir kez yapın |
| Eski numarayla işlem hatası | Bozulan paketin numarası kullanıldı | Unpack sonrası paket numarasını tazeleyin |
| Yanlış kutuya yanlış etiket | Paketler tek satırda gösterildi | Her paketi ayrı satırda gösterin |
Sık sorulanlar
Hepsiburada'da paket nasıl bozulur?
Paket numarasıyla bozma isteği gönderilir ya da işlem panelden yapılır. Kalemler paketlenecek listesine Unpacked durumunda döner.
Paket bölme ne işe yarar?
Bir paketteki kalemlerin bir kısmını ayrı pakete alır. Ürünler farklı zamanlarda hazır olacaksa kullanılır.
Unpack bildirimi neden gelmiyor?
Bu bildirim PUT yöntemiyle gelir. Webhook alıcınızın aynı adreste PUT isteğini de kabul ettiğinden emin olun.
Bölünmüş siparişte stok nasıl düşmeli?
Sipariş düzeyinde bir kez. Paket başına düşüm aynı ürünü iki kez düşürür.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı