Shopify Order Printer'a Kargo Barkodu Entegrasyonu

Bu doküman, Shopify Order Printer uygulamasıyla hazırladığınız irsaliye ve paketleme fişlerine KargoEntegrator üzerinden dinamik olarak kargo barkodu eklemenizi anlatır. Böylece tek bir belge hem paketleme fişi hem de kargo firmasının okutabileceği geçerli bir kargo etiketi olarak kullanılabilir.

Ne İşe Yarar?

Kendi tasarladığınız paketleme fişi veya irsaliye şablonuna KargoEntegrator'ın ürettiği barkodu gömerek:

Ayrı ayrı kargo etiketi bastırma ihtiyacını ortadan kaldırırsınız.
Paketleme ve sevkiyat sürecini tek bir çıktı üzerinden yönetirsiniz.
Kargo firmasının barkod okuyucusuyla doğrudan işlem yapabilecek bir belge elde edersiniz.

API Uç Noktaları

İhtiyacınıza göre iki farklı barkod uç noktası sunuyoruz:

1. Standart Barkod — Çoğu kargo firması için yeterli olan sade barkod görselidir.

https://app.kargoentegrator.com/api/helpers/barcode-image/TEAM_ID/{{ order.id }}

2. Tam Kargo Etiketi — Hepsijet gibi barkodun yanında gönderici, alıcı, ürün gibi ek bilgi bloklarını da içeren kapsamlı etiket yapısıdır. API anahtarı gerektirir.

https://app.kargoentegrator.com/api/helpers/barcode-full-image/TEAM_ID/{{ order.id }}?api_key=APIKEY

Not: Hepsijet ve benzeri firmalarla çalışıyorsanız barcode-full-image uç noktasını kullanmanız, kargo firmasının sistemleriyle uyumlu bir çıktı almanız için gereklidir.

Adım Adım Kurulum

1. Order Printer'da şablonu açın

Shopify yönetim panelinden Order Printer uygulamasına girin ve düzenlemek istediğiniz şablonu seçin (örneğin Packing Slip). Şablonlar Liquid tabanlıdır ve tamamen özelleştirilebilir.

2. Barkod kodunu şablona ekleyin

Barkodun görünmesini istediğiniz yere, kullandığınız kargo firmasına göre aşağıdaki iki koddan uygun olanı yapıştırın.

Standart barkod için:

<img src="https://app.kargoentegrator.com/api/helpers/barcode-image/TEAM_ID/{{ order.id }}" width="300">

Tam kargo etiketi (Hepsijet vb.) için:

<img src="https://app.kargoentegrator.com/api/helpers/barcode-full-image/TEAM_ID/{{ order.id }}?api_key=APIKEY" width="400">

3. Team ID ve API Key değerlerini girin

Yapıştırdığınız kodda TEAM_ID (ve gerekiyorsa APIKEY) alanlarını kendi bilgilerinizle değiştirin. Sipariş numarası ({{ order.id }}) Shopify tarafından her sipariş için otomatik doldurulur — bu değere dokunmanıza gerek yoktur.

4. Kaydedin ve test edin

Şablonu kaydedip bir siparişin çıktısını aldığınızda, barkod otomatik olarak fişin üzerinde görünecektir. width değerini değiştirerek barkodun boyutunu ve şablon içindeki yerleşimini istediğiniz gibi ayarlayabilirsiniz.

Parametreler

Parametre	Açıklama	Nereden alınır?
`TEAM_ID`	KargoEntegrator hesabınıza özel ekip kimlik numarası	app.kargoentegrator.com/user/profile
`{{ order.id }}`	Shopify'ın her siparişe otomatik atadığı benzersiz kimlik	Otomatik — dokunmayın
`APIKEY`	`barcode-full-image` uç noktası için gereken güvenlik anahtarı	app.kargoentegrator.com/integration/api

Sık Karşılaşılan Durumlar

Barkod görünmüyor: TEAM_ID değerinin doğru girildiğinden ve URL'de TEAM_ID yazısının kaldığı bir yer olmadığından emin olun.
Hepsijet barkodu okunmuyor: Standart barkod uç noktasını değil, barcode-full-image uç noktasını kullandığınızdan emin olun.
barcode-full-image boş dönüyor: API anahtarının geçerli olduğunu ve URL sonuna ?api_key=... olarak eklendiğini kontrol edin.

Sorun devam ederse destek ekibiyle iletişime geçebilirsiniz.