Bu teknik doküman, Shopify Print uygulaması üzerinden hazırladığınız gönderi dökümanlarına ve paketleme fişlerine kargo barkodlarını dinamik olarak nasıl ekleyebileceğinizi açıklamaktadır. Bu entegrasyon ile kargo operasyonlarınızı tek bir döküman üzerinden yönetebilir ve süreçlerinizi hızlandırabilirsiniz.
API Uç Noktaları (Endpoints)
Kargo barkodlarını dökümanlarınıza çekmek için iki farklı API kanalı sunulmaktadır. İhtiyacınıza göre aşağıdaki uç noktalardan uygun olanı seçebilirsiniz:
Kullanım AmacıAPI EndpointStandart Kargo Barkodu
http://app.kargoentegrator.com/api/helpers/barcode-image/{team_id}/{order_id}
Tam Barkod Görseli (Hepsijet vb.)
https://app.kargoentegrator.com/api/helpers/barcode-full-image/{team_id}/{order_id}?api_key=API_KEY
Önemli Not: Hepsijet gibi kargo firmaları, barkodun yanı sıra ek gönderi bilgilerini içeren özel bir etiket yapısı kullanmaktadır. Bu tür firmalarla çalışıyorsanız, daha sağlıklı bir çıktı almak için barcode-full-image kanalını kullanmanız önerilir.
Şablon Entegrasyon Kodları
Shopify Print şablonunuzda (Liquid template) barkodun görünmesini istediğiniz bölüme aşağıdaki HTML kod bloklarını yerleştirebilirsiniz.
1. Standart Barkod Kullanımı
Standart kargo barkodunu dökümana yerleştirmek için bu yapıyı kullanınız:
2. Tam Kargo Etiketi Kullanımı (API Key Gerekli)
Hepsijet ve benzeri kapsamlı etiket yapısı gerektiren firmalar için bu yapıyı kullanınız:
Parametre Açıklamaları
-
EKIP_ID: Kargo Entegratör panelinizde size özel tanımlanan ekip kimlik numarasıdır.
-
{{ order.id }}: Shopify tarafından her sipariş için otomatik atanan benzersiz kimliktir; sistem bu kod sayesinde doğru barkodu anlık olarak eşleştirir.
-
API_KEY:
barcode-full-imagekullanımında gerekli olan güvenlik anahtarınızdır.