Kargo Barkodu Oluşmuyor Hatası Nasıl Çözülür?

Kargo barkodu neden oluşmaz?

Kargo barkodu; sipariş paketi, taşıyıcı seçimi, kargo takip numarası ve paket statüsü hazır olmadan üretilemez. Bazı pazaryerlerinde barkod platform tarafından üretilir, bazı taşıyıcı modellerinde etiket doğrudan kargo firmasından alınır. Bu nedenle “barkod yok” hatasının çözümü kullanılan pazaryeri, kargo firması ve gönderim modeline göre değişir.

İlk ayrım şudur: Etiket hiç oluşturulmamış mı, yoksa oluşturulan etiket yazdırılamıyor mu? API cevabında ZPL/PDF verisi varsa sorun etiket üretiminde değil; görüntüleme, dönüştürme veya yazıcı yapılandırmasındadır.

Barkod oluşturma ile yazdırma sorununu ayırın

Panelde “etiket alınamadı” şeklinde tek bir mesaj göstermek teşhisi zorlaştırır. API HTTP kodu, platform hata mesajı, istenen format ve yazdırma sonucu ayrı alanlarda gösterilmelidir.

Sipariş paketi ve kargo takip numarasını doğrulayın

Barkod çoğu zaman ana sipariş numarasıyla değil, paket kimliği veya kargo takip numarasıyla üretilir. Paket bölündüğünde eski paket iptal olabilir ve yeni paket kimliği ile yeni takip numarası oluşabilir. Entegrasyon eski kimliği kullanırsa servis gönderiyi bulamaz.

• Siparişin aktif paket kimliği nedir?
• Kargo takip numarası boş mu?
• Paket bölme veya kısmi iptal sonrası kimlik değişti mi?
• Yanlış mağazaya ait takip numarası mı kullanılıyor?
• Takip numarasında boşluk veya format dönüşümü var mı?

Trendyol’un resmî sipariş süreci akışı, paket bölme veya iptal sonrasında yeni shipmentPackageId ve cargoTrackingNumber oluşabileceğini gösterir. Barkod talebi güncel paket bilgileriyle yapılmalıdır.

Paket statüsü barkod talebine uygun olmalıdır

Bazı entegrasyonlarda sipariş paketi hazırlık aşamasına alınmadan etiket üretilemez. Trendyol’un Ortak Etiket Barkod Talebi dokümanı, barkod talebinin paket Picking veya Invoiced statüsüne geçirildikten sonra yapılmasını önerir.

Panel yalnızca kendi iç durumunu “Hazırlanıyor” yapmış olabilir; fakat bu statü pazaryerine başarıyla gönderilmemişse barkod servisi paketi uygun aşamada görmez. Statü güncelleme isteğinin cevabı ve güncel paket verisi tekrar okunmalıdır.

Taşıyıcı ve kargo ödeme modeli etiketi belirler

Her sipariş için platformdan etiket dönmesi beklenmemelidir. Trendyol ortak etiket süreci belirli taşıyıcı ve gönderim modelleri için kullanılabilir. Başka kargo firmalarında etiket satıcının kendi taşıyıcı entegrasyonundan alınabilir. Kargo firması sözleşme numarası, müşteri kodu veya şube kodu eksikse takip numarası üretimi başarısız olabilir.

ZPL ve PDF aynı format değildir

ZPL, termal etiket yazıcılarının anlayabildiği komut dilidir. Tarayıcıda doğrudan açıldığında anlamsız metin gibi görünebilir. PDF ise görüntülenebilir belge biçimidir. Uygulama ZPL verisini PDF dosyası adıyla kaydederse belge bozuk görünür; PDF etiketini ham ZPL gibi yazıcıya gönderirse çıktı alınamaz.

Trendyol ortak etiket barkod talebinde güncel dokümana göre format ZPL olarak sunulur. getCommonLabel servisi tek koli için tek, çoklu koli için birden fazla etiket döndürebilir.

• ZPL destekli termal yazıcı kullanılıyor mu?
• Yazıcı DPI ve etiket ölçüsü doğru mu?
• ZPL verisi base64 veya JSON kaçış karakterleriyle bozulmuş mu?
• PDF gerekiyorsa güvenilir bir dönüştürme katmanı var mı?
• Tarayıcı baskısı ölçeği yüzde 100 mü?

API hata kodunu kullanıcıya açık gösterin

Çoklu koli ve paket bölme işlemlerini kontrol edin

Bir sipariş iki koliye bölündüğünde tek barkod beklemek yanlış olabilir. Koli sayısı etiket talebinde doğru gönderilmeli ve dönen tüm etiketler sipariş paketiyle ilişkilendirilmelidir. Paket bölme sonrası eski etiketi tekrar kullanmak sevkiyat eşleşmesini bozabilir.

Her etiket kaydında paket kimliği, takip numarası, koli sıra numarası, format, oluşturulma zamanı ve son yazdırma sonucu bulunmalıdır.

Kargo barkodu hataları neden–çözüm tablosu

Adım adım kargo barkodu teşhisi

1. Kaynak panelde sipariş paketini ve aktif takip numarasını açın.
2. Paket statüsünün barkod talebine uygun olduğunu doğrulayın.
3. Etiket kaynağını belirleyin: pazaryeri mi, kargo API’si mi?
4. Etiket oluşturma isteğini ham HTTP kodu ve cevapla kaydedin.
5. Etiket oluştuysa formatın ZPL mi PDF mi olduğunu kontrol edin.
6. Veriyi dosyaya kaydedip yazıcıdan bağımsız olarak doğrulayın.
7. Termal yazıcı dili, DPI, ölçü ve bağlantıyı test edin.
8. Çoklu koli varsa bütün etiketlerin işlendiğini doğrulayın.
9. Başarısız talebi kontrollü yeniden deneyin; çift gönderi oluşturmayın.

Hangi durumda teknik destek gerekir?

• Takip numarası olduğu hâlde servis sürekli 404 döndürüyorsa
• Paket statüsü pazaryerine gönderilemiyorsa
• ZPL etiketi oluşuyor fakat hiçbir yazıcıda basılamıyorsa
• Çoklu kolilerde etiketler eksik veya yanlış paketle eşleşiyorsa
• Etiket üretimi yoğun saatlerde sık sık zaman aşımına uğruyorsa
• Yanlış barkodla kargoya teslim riski oluştuysa

Sık sorulan sorular

Kargo barkodu ile ürün barkodu aynı şey midir?

Hayır. Ürün barkodu ürünü, kargo barkodu ise gönderi veya paketi tanımlar.

Etiket ZPL ise normal yazıcıdan basılır mı?

ZPL doğrudan ZPL destekli termal yazıcılar içindir. Normal yazıcı için önce uygun biçimde PDF veya görsele dönüştürülmesi gerekir.

Barkodu tekrar oluşturmak yeni takip numarası üretir mi?

Servise göre değişir. Yeniden deneme yapmadan önce işlemin yalnızca etiketi tekrar getirip getirmediği veya yeni gönderi oluşturup oluşturmadığı doğrulanmalıdır.