# 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:** ``` ``` **Tam kargo etiketi (Hepsijet vb.) için:** ``` ``` ### 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](https://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](https://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.