Etiket akışı
| Adım | İşlem | Kaynak |
|---|---|---|
| 1 | Siparişin paket numarasını bulun | Sipariş detayı, items[].packageNumber |
| 2 | Paket numarasıyla etiket isteyin | Paket etiket işlemi |
| 3 | Yanıttan dosyayı çıkarın | Base64, adres ya da dosya alanı |
| 4 | Yazdırıp kutuya yapıştırın | Termal ya da ofis yazıcısı |
Paket yoksa etiket de yoktur. "Etiket alınamadı" hatasının en sık nedeni, siparişin Hepsiburada'da henüz paketlenmemiş olmasıdır.
Biçim seçimi
| Biçim | Ne zaman | Not |
|---|---|---|
| Ofis yazıcısı, toplu yazdırma | Birden çok etiketi tek dosyada birleştirmek kolaydır | |
| ZPL | Termal etiket yazıcısı | Yazıcıya doğrudan gönderilir |
| base64 ZPL | ZPL'i JSON içinde taşımak | Kod tarafında çözülür |
| PNG, JPG | Ekranda göstermek, önizleme | Yazdırmada ölçek ayarına dikkat |
Bu biçimler Saystok'un kodunda tanımlı seçeneklerdir. Hangi biçimin hangi kargo firması için desteklendiğini resmî dokümanda kontrol edin; kodda bu işlem HepsiJet ve Aras paketleri için ortak barkod olarak not edilmiştir.
Yanıttan dosyayı çıkarmak
Etiket yanıtının biçimi her zaman aynı gelmeyebilir. Dosya doğrudan base64 metni olarak, bir indirme adresi olarak ya da bir alanın içinde dönebilir. Sağlam bir okuyucu sırayla şunlara bakar:
- Yanıtın kendisi ya da data, content, label, barcode, file, url, pdf gibi alanlar.
- Değer http ile başlıyorsa: adresten dosyayı indirin.
- Değer JVBER ile başlıyorsa: base64 kodlu PDF'tir; çözün.
- Değer %PDF ile başlıyorsa: ham PDF'tir.
Hiçbiri tutmazsa yanıtı kaydedip resmî dokümandaki örnekle karşılaştırın. Tahminle yazılmış tek bir biçim okuyucusu, ilk farklı yanıtta sessizce boş etiket üretir.
Yazdırma pratikleri
- Termal yazıcıda etiket boyutunu ve çözünürlüğü yazıcı ayarıyla eşleyin; yanlış ölçek barkodun okunmamasına yol açar.
- Toplu yazdırmada etiketleri paket sırasına göre dizin; hazırlama listesiyle aynı sırada olsun.
- Çok paketli siparişte her paketin etiketini ayrı alın. Tek etiketi iki kutuya yapıştırmak, kutulardan birinin kaybolması demektir.
- Paket bozulduysa eski etiketi kullanmayın.
Hazırlama ekibinin akışı için hızlı paketleme sayfasına bakabilirsiniz.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Etiket alınamadı | Paket henüz oluşmadı | Siparişi Hepsiburada'da paketleyin |
| Boş ya da bozuk PDF | Yanıt biçimi yanlış okundu | Base64, adres ve ham PDF olasılıklarını sırayla deneyin |
| Barkod okunmuyor | Yazdırma ölçeği yanlış | Etiket boyutunu yazıcıyla eşleyin |
| Eski etiket kullanıldı | Paket bozulup yeniden kuruldu | Yeni paket numarasıyla yeni etiket alın |
Sık sorulanlar
Hepsiburada kargo etiketini nasıl alırım?
Önce siparişin paket numarasını sipariş detayından bulun, sonra paket numarasıyla etiket isteyin. Paket yoksa etiket de yoktur.
Termal yazıcı için hangi biçim seçilmeli?
ZPL. Ofis yazıcısında ve toplu yazdırmada PDF daha pratiktir.
Etiket yanıtı neden bazen adres, bazen metin?
Yanıt biçimi değişebilir. Base64 PDF, indirme adresi ve ham PDF olasılıklarının hepsini okuyan bir kod yazın.
Paket bozulduysa eski etiket geçerli mi?
Hayır. Yeni paket numarasıyla yeni etiket alın ve eski etiketi kutudan sökün.
Birden çok etiketi tek dosyada basabilir miyim?
PDF biçiminde etiketleri tek dosyada birleştirebilirsiniz. Çok paketli siparişlerde her paketin etiketinin ayrı sayfada olduğundan ve hazırlama sırasıyla dizildiğinden emin olun.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı