Ortak Etiket Süreci Nedir, Ne Zaman Kullanılır?
Ortak etiket süreci, yalnızca TEX ve Aras Kargo için geçerli olan “Trendyol öder” gönderilerde kullanılabiliyor; diğer kargo firmaları veya “satıcı öder” gönderilerde bu servis çalışmaz. Amacı, kargo firmasının kendi sisteminden ayrıca bir etiket üretilmesini beklemeden, ilgili gönderinin barkodunu doğrudan Trendyol’un entegrasyon servisinden almaktır. Bu sayede paketleme sürecinde ekstra bir kargo firması entegrasyonuna gerek kalmadan, tek bir akıştan etiket çıktısı alınabilir.
İki Aşamalı Bir Süreç: Barkod Talebi ve Barkod Alma
Ortak etiket süreci tek bir istekten oluşmuyor; iki ayrı servis art arda çağrılıyor. Önce “Ortak Etiket Barkod Talebi” (createCommonLabel) servisi, ilgili kargo takip numarası için barkod oluşturulmasını talep eder; body içinde format alanı zorunludur ve şu an için yalnızca ZPL formatı destekleniyor. Barkod oluştuktan sonra, ayrı bir servis olan “Ortak Etiket Oluşan Barkodun Alınması” (getCommonLabel) ile bu barkod çekilir. Bu iki adımın ayrı olması, “etiket alınamıyor” hatalarının en sık görülen kaynağıdır: barkod talebi gönderildikten hemen sonra, barkod henüz oluşmadan alma isteği yapılırsa sistem barkodu döndüremez.
En Sık Görülen Nedenler
Pratikte “ortak kargo etiketi alınamıyor” hatasının arkasında genellikle şu dört durumdan biri yatar. Birincisi, barkod talebinin ilgili sipariş paketi PICKING veya INVOICED statüsüne geçmeden yapılması; Trendyol bu talebi paket bu statülerdeyken yapmanızı önerir, aksi halde talep başarısız olabilir. İkincisi, barkod talep ile alma isteği arasında yeterli süre bırakılmaması; barkod oluşturma anlık değildir ve hemen ardından gelen bir alma isteği henüz hazır olmayan bir barkodu bulamayabilir. Üçüncüsü, yanlış veya güncel olmayan bir kargo takip numarasının kullanılması. Dördüncüsü ise ortak etiket sürecinin TEX veya Aras Kargo dışındaki bir kargo firmasıyla ya da “satıcı öder” bir gönderi için denenmesi — bu durumda servis prensipte çalışmaz.
400, 401 ve 404 Hata Kodları Ne Anlama Gelir?
Servis üç farklı hata koduyla dönebilir ve her biri farklı bir kontrol noktasına işaret eder. 400 Bad Request, gönderilen kargo takip numarasının formatının hatalı olduğunu gösterir; bu değerin sipariş paketindeki kargo takip numarasıyla birebir eşleştiğinden emin olunmalıdır. 401 Unauthorized, API kimlik bilgilerinde (satıcı ID, API key/secret) bir sorun olduğunu gösterir. 404 Not Found ise en sık karşılaşılan koddur ve kargo takip numarasına ait bir gönderinin bulunamadığı anlamına gelir; bu genellikle paketin henüz kargo firmasına iletilmemiş olmasından veya barkod talebinin ilgili gönderi için hiç yapılmamış olmasından kaynaklanır.
Çözüm İçin Kontrol Listesi
Hata alındığında sırasıyla şu noktalar kontrol edilmeli: sipariş paketinin PICKING veya INVOICED statüsünde olup olmadığı; kullanılan kargo takip numarasının ilgili pakete ait güncel numara olup olmadığı; barkod talebi (createCommonLabel) ile barkod alma (getCommonLabel) istekleri arasında kısa bir bekleme veya otomatik yeniden deneme (retry) mekanizması bulunup bulunmadığı; format alanının ZPL olarak gönderilip gönderilmediği ve son olarak gönderinin gerçekten TEX veya Aras Kargo ile “Trendyol öder” kapsamında olup olmadığı. Bu beş noktanın hepsi doğruysa ve hata devam ediyorsa, sorun genellikle Trendyol tarafındaki geçici bir gecikmeden kaynaklanır ve kısa bir süre sonra tekrar denenmesi önerilir.
Sık Yapılan Hatalar
En sık karşılaşılan hatalar arasında şunlar öne çıkar: ortak etiket sürecinin her kargo firması için çalıştığı varsayılıp TEX/Aras Kargo dışındaki gönderilerde denenmesi; barkod talebi ile alma isteği arasında retry mantığı kurulmadan tek seferlik senkron bir çağrı yapılması; paket durumu güncellenmeden (henüz PICKING’e geçmeden) barkod talep edilmesi ve ZPL dışında bir format beklenmesi — servis şu an için yalnızca ZPL formatını destekliyor, başka bir formatta çıktı almak mümkün değil.
Pixa ile Ortak Etiket Sürecini Otomatikleştirmek
Pixa WMS’in kargolama modülü, ortak etiket sürecindeki barkod talebi ve alma adımlarını, doğru paket statüsü ve gerekli bekleme/retry mantığıyla otomatik olarak yönetir; personel manuel olarak kargo takip numarası veya statü kontrolü yapmadan, paketleme sırasında tek tuşla doğru etiketi alır. Trendyol entegrasyonu üzerinden gelen siparişlerde bu süreç, sipariş durumu senkronizasyonuyla birlikte uçtan uca işler; böylece “etiket alınamıyor” hatası nedeniyle sevkiyatın gecikmesi riski önemli ölçüde azalır.
Sık Sorulan Sorular
Ortak etiket süreci hangi kargo firmalarında çalışır?
Sadece TEX ve Aras Kargo için, “Trendyol öder” gönderilerde kullanılabilir; diğer kargo firmalarında veya “satıcı öder” gönderilerde bu servis geçerli değildir.
Barkod talebi yaptım ama hemen ardından alamıyorum, neden?
Barkod oluşturma anlık değildir; talep (createCommonLabel) ile alma (getCommonLabel) istekleri arasında kısa bir süre bırakmak veya otomatik yeniden deneme mekanizması kurmak gerekir.
404 Not Found hatası ne anlama gelir?
Girilen kargo takip numarasına ait bir gönderi bulunamadığı anlamına gelir; genellikle numaranın hatalı olmasından veya barkod talebinin hiç yapılmamış olmasından kaynaklanır.
Hangi barkod formatı destekleniyor?
Şu an için yalnızca ZPL formatı destekleniyor; talepte format alanının ZPL olarak gönderilmesi zorunludur.
Barkod talebini hangi paket statüsünde yapmalıyım?
Talebin, ilgili sipariş paketi PICKING veya INVOICED statüsüne geçtikten sonra yapılması tavsiye edilir.