Kargo firmanızın ZPL etiketini herhangi bir yazıcıda basın

Yayın tarihi: 2026-11-10

Pek çok kargo firması ve gönderi platformu etiketi ZPL olarak verir: Zebra sınıfı termal yazıcıların komut dili. Böyle bir yazıcı yoksa ofisteki lazer yazıcı ya da tarayıcı ZPL'i satır satır metin olarak basar. Zebra almanız gerekmez: ZPL'i PDF ya da PNG'ye çevirip elinizdeki yazıcıda basın; günde onlarca, yüzlerce etiket olduğunda çeviriyi API üzerinden bir betiğe bırakın. Bu sayfa her firmanın belgesine göre ZPL'in nereden geldiğini, ardından hepsi için aynı üç adımı anlatır.

Aşağıdaki firma alanları 2026-11-10'da her firmanın kendi geliştirici belgesinden okundu (Türk firmaları, belirtildiği gibi 2026-10-31 ve 2026-11-02'de). Alan adları API sürümleri arasında değişir; üzerine bir şey kurmadan önce güncel referansa bakın.

Her kargo firması için aynı üç adım

1. Firmadan ZPL isteyin: firmanın aşağıdaki bölümünde adı geçen ayarla etiketi isteyin ve bir dosyaya kaydedin. API etiketi base64 kodlu döndürüyorsa önce çözün: dosya ^XA ile başlamalı.
2. Önizleyin, PDF ya da PNG indirin: ZPL'den PDF'e dönüştürücüde firmanın etiketi yazdığı baskı yoğunluğunu (203 dpi = 8 nokta/mm, 300 dpi = 12) ve etiket ölçüsünü seçip indirin. Dosyadaki bütün etiketler PDF'e girer.
3. Otomatikleştirin: aynı dosyayı sipariş ya da gönderi betiğinizden API'ye gönderin ve dönen PDF'i ya da PNG'yi basın — Zebra gerekmez, ZPL anlayan bir sürücü gerekmez.

API ile otomatikleştirin: etiket dosyası başına tek istek

Render ucu ZPL'i istek gövdesi olarak alır. Yol, yoğunluğu ve inç cinsinden etiket ölçüsünü taşır; son parça dosyadaki etiketin sırasıdır.

# ilk etiket PNG olarak (203 dpi = 8 nokta/mm, 4x6 inç)
curl -X POST "https://api.labelixa.com/v1/printers/8dpmm/labels/4x6/0" \
     -H "X-API-Key: $LABELIXA_KEY" --data-binary @label.zpl -o label.png

Sırayı yazmaz ve PDF isterseniz dosyadaki bütün etiketler sayfa başına bir etiketle gelir — firma çok kolili gönderiyi tek dosyada döndürdüğünde işe yarar:

base64 -d label.b64 > label.zpl     # firma base64 döndürüyorsa
curl -X POST "https://api.labelixa.com/v1/printers/8dpmm/labels/4x6/" \
     -H "X-API-Key: $LABELIXA_KEY" -H "Accept: application/pdf" \
     --data-binary @label.zpl -o labels.pdf

300 dpi için yazılmış etikette 12dpmm kullanın. URL şeması Labelary'ninkiyle aynıdır; ona göre yazılmış kod çoğunlukla yalnız host değişikliği ister — bkz. Labelary uyumlu uç. Bozuk etiketi basılmadan durdurmak için /v1/diagnostics bulguları JSON olarak döndürür; tam referans API belgesinde.

Her gün etiket çeviriyorsanız: erişilebilirlik ve fiyat

Gönderdiğiniz her etiketi bir betik çeviriyorsa çeviri servisi sevkiyat hattınızın parçasıdır: cevap vermezse koliler bekler. Bizimki dahil hangi servise güvenecekseniz önce iki şeye bakmaya değer:

• Erişilebilirlik yayımlanıyor mu? Durum sayfası servisin içinden ve saatlik dış kontrolle ölçülen erişilebilirliği yuvarlamadan gösterir. 2026-11-10'da %100,00 okunuyordu: son 60 günde 4.248 dış kontrolün 4.248'i geçti. Bu bir ölçümdür, hizmet seviyesi taahhüdü (SLA) değildir; servis kredili uptime SLA'sı Business ve Enterprise planlarıyla gelir (SLA koşulları).
• Ücretli plan ne kadar? Starter, kendi API anahtarınızla ayda 25.000 etiket için aylık 9 dolardır; SLA'sı yoktur. Karşılaştırma için: Labelary'nin kendi fiyat tablosu (2026-11-10'da okundu) ücretsiz planında erişilebilirlik SLA'sı göstermiyor; SLA'lı ilk planı Plus, aydan aya ayda 99 dolar (yıllık taahhütle 90 dolar). Bkz. Labelary karşılaştırması ve fiyatlar.
• Önce denenebilir mi? Dönüştürücü ve önizleme hesapsız çalışır; kodunuzu değiştirmeden önce kendi kargo etiketlerinizi deneyebilirsiniz.

4×6 etiketi A4'e ya da ofis lazer yazıcısına basmak

Kargo ZPL'i neredeyse her zaman 4×6 inç (yaklaşık 100×150 mm) etiket için yazılır. Dönüştürücü ve API bugün bununla ne yapıyor, 2026-11-10'da ölçüldü:

• Varsayılan: sayfa = etiket. Sayfa ölçüsü verilmezse her PDF sayfası tam etiket ölçüsündedir. A4 ya da Letter kâğıda yazdırma penceresinde gerçek boyut (%100) seçerek basın ve etiketi kesin.
• Bir sayfada birden çok etiket. API başlıkları X-Page-Size: A4 ve X-Page-Layout: 2x2 her A4 sayfaya dört etiket koyar; her biri hücresine sığacak şekilde yaklaşık %90'a (91×137 mm) küçülür; 2×3 ızgara yaklaşık %60'tır. 1x1 düzeninde (sayfa ölçüsü verilince varsayılan) etiket gerçek boyutunda ortalanır, hiç büyütülmez; A6'da 4×6 etiket sığmak için yaklaşık %89'a küçülür. Dönüştürücü A4, Letter, A5, A6 ve Legal kâğıt sunar.
• Ölçek ve okutma. Izgaralı düzenler %100 ölçekte değildir. Kargo firmaları asgari barkod ölçüsü belirler; küçültülmüş düzeni gerçek kolilerde kullanmadan önce bir deneme sayfası basıp okutun. Sayfalar, etiketin kendi yoğunluğunda raster görüntüdür.

Her firma ZPL'i nereden veriyor

Burada yalnız kendi belgesini okuyabildiğimiz firmalar var. Labelixa etiket satın almaz ve kargo firmalarıyla konuşmaz; elinize geçmiş ZPL'i render eder.

UPS

Shipping API, POST /shipments/{version}/ship: LabelSpecification.LabelImageFormat.Code = ZPL, LabelStockSize 4×6 ya da 4×8 inç. Şartnamede çözünürlük alanı yok; yoğunluğu dosyadan okuyun. İstek alanları ve yanıt yolları: UPS ZPL etiketleri.

FedEx

Ship API: labelSpecification.imageType = ZPLII, labelStockType örneğin STOCK_4X6, resolution 203 ya da 300 (300 yalnız ZPLII ile; varsayılan 203). Ayrıntı: FedEx ZPL etiketleri.

USPS

Domestic Labels 3.0 API (POST /labels/v3/label): USPS etiket biçimlerini PDF, TIFF, SVG, JPG, ZPL203DPI ve ZPL300DPI olarak sayar — yoğunluk biçimin adındadır. Güncel şemadaki etiket ölçüsü alanını okuyamadık.

DHL Express

MyDHL API 3.4.0: imageOptions → encodingFormat, epl, lp2 ve pdf'in yanında zpl kabul eder; DHL fatura ve makbuzun her zaman PDF döndüğünü belirtir. 2026-10-31'de okundu; yoğunluk alanı okumadık.

Amazon Shipping

Shipping API v2 (Buy Shipping): istenen belge tanımı PDF, PNG ya da ZPL değerli format, bir size, bir dpi ve sayfa düzeni alır; bir gönderi için izin verilen değerler getRates yanıtındakilerdir (supportedDPIs). Etiket paket belgelerinde base64 kodlu döner.

ShipStation

ShipStation API: label_format = zpl. ZPL etiketler yalnız 4×6 inçtir; yanıt bir label_download.zpl bağlantısı verir ya da o indirme türünü isterseniz base64'ü satır içinde döndürür.

Shippo

İşlemi (transaction) oluştururken label_file_type değerini ZPLII yapın; verilmezse Shippo panelindeki varsayılan biçim kullanılır. Shippo ZPL için ölçü belirtmiyor.

EasyPost

Gönderi seçenekleri: label_format = ZPL; ZPL için belgelenen label_size 4x6'dır, firma rehberleri firmaya özgü ölçüleri sayar.

Shopify Shipping

GraphQL Admin API'de (2026-10) bir gönderi etiketinin belgeleri PDF ya da ZPL değerli bir format ve bir url taşır. Bunların ölçüsünü ya da yoğunluğunu okumadık.

Canada Post

ZPL seçildiğinde Get Artifact çağrısı ZPL II komutları döndürür ve çıktı biçimi 4x6 olmalıdır. Canada Post metni kırpabilen bir yazıcı istiyor, yoksa PDF öneriyor.

Australia Post

Shipping and Tracking API, etiket oluşturma: ZPL etiketli bir istek 50 koliyle sınırlıdır, termal düzen THERMAL-LABEL-A6-1PP'dir. Australia Post'un uluslararası CN22 etiketleri için yardım sayfası ZPL'in yalnız CN22 etiketinde açık olduğunu söylüyor; ürünlerinizden hangisini kapsadığını kontrol edin.

DPD

DPD'nin ShipmentService 3.5'i (DPD İsviçre'nin belgesi): printOptions.printerLanguage = ZPL, paperFormat A6 ve printerResolution 203, 300 ya da 600 (ayrıca 150 ve 200); değer yazıcı kafasıyla aynı olmalı. DPD ülke başına ayrı web servisi işletiyor; kendi ülkenizin belgesine bakın.

PostNL

Labelling web servisi: yazıcı türü Zebra|Generic ZPL II, 200, 300 ya da 600 dpi. PostNL PDF etiketleri doğrudan Zebra yazıcıya göndermemeyi öneriyor.

Türk kargo firmaları ve pazaryerleri

2026-10-31 ve 2026-11-02'de okundu: Trendyol ortak etiketi ("format": "ZPL"), HepsiJet (zplBarcode), Yurtiçi (docCargoZpl), Aras (ZebraZpl), UPS Türkiye (CreateShipment_Type3_ZPL), Kolay Gelsin ve Sendeo (BarcodeZpl) ile PTT AVM ("type": "zpl"). Servisler ve alanlar: Trendyol ve HepsiJet ZPL etiketleri.

ZPL vermeyen ya da doğrulayamadığımız firmalar

• Okuduğumuz belgede ZPL yok: Royal Mail Click & Drop API etiketi PDF olarak döndürür; PTT Kargo EPL döndürür, dönüştürücü önizler ama yalnız EPL yazıcılar basar; Sürat Kargo'nun güncel Web API'sinde etiket alanı yok; Pazarama etiket dosyası vermez, yalnız gönderi kodu verir.
• Doğrulanmadı (resmî belge bizim tarafımızdan okunamadı, yalnız onaylı geliştiricilere açık ya da etiket servisi bulunamadı): Evri, GLS, Deutsche Post / DHL Paket, eBay, Etsy, MNG Kargo, Hepsiburada pazaryeri etiketi, doğrudan Trendyol Express hesapları ve DHL eCommerce Türkiye. Hesabınız bunlardan birinden ZPL alıyorsa yukarıdaki üç adım aynen geçerlidir.

Labelixa'nın bu sayfada adı geçen kargo firmaları ve platformlarla bir bağı yoktur; adlar yalnız hangi belgenin okunduğunu söylemek için kullanılır.

Sık sorulan sorular

Kargo firmasının ZPL etiketini Zebra yazıcı olmadan basabilir miyim?

Evet. ZPL'i PDF ya da PNG'ye çevirip herhangi bir yazıcıda basın. Her PDF sayfası varsayılan olarak etiket ölçüsündedir; gerçek boyutta (%100) basın.

Günde yüzlerce etiket için otomatikleştirebilir miyim?

Evet. Gönderi betiğinizden her ZPL dosyasını render ucuna gönderin ve dönen PDF'i ya da PNG'yi basın. Starter ayda 25.000 etiket için aylık 9 dolardır.

4x6 etiket A4'e tam boyutta sığar mı?

Etiket ölçüsündeki PDF %100 basıldığında sayfa başına bir etiket tam boyutta çıkar. A4 ızgara düzenleri sayfaya dört ya da altı etiket koyar ve yaklaşık %90 ya da %60'a küçültür.

İlgili yazılar

Kendi ZPL kodunuzu deneyin →