Veröffentlicht:
Viele Versanddienstleister und Versandplattformen liefern das Etikett als ZPL — die Befehlssprache von Thermodruckern der Zebra-Klasse. Ohne einen solchen Drucker gibt ein Bürolaserdrucker oder ein Browser ZPL als Textzeilen aus. Sie müssen keinen Zebra kaufen: Rendern Sie das ZPL als PDF oder PNG und drucken Sie es auf dem vorhandenen Drucker; sobald es Dutzende oder Hunderte Etiketten am Tag sind, übernimmt ein Skript die Umwandlung über die API. Diese Seite zeigt, woher das ZPL laut Dokumentation des jeweiligen Dienstleisters kommt, und danach dieselben drei Schritte für alle.
Die Felder der Dienstleister wurden am 2026-11-10 in deren eigener Entwicklerdokumentation gelesen (türkische Dienstleister wie angegeben am 2026-10-31 und 2026-11-02). Feldnamen ändern sich zwischen API-Versionen; prüfen Sie die aktuelle Referenz, bevor Sie darauf aufbauen.
^XA beginnen.Der Render-Endpunkt nimmt das ZPL als Anfragekörper. Der Pfad trägt die Dichte und die Etikettengröße in Zoll; der letzte Teil ist der Index des Etiketts in der Datei.
# erstes Etikett als PNG (203 dpi = 8 Punkte/mm, 4x6 Zoll)
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
Ohne Index und mit PDF-Anforderung kommen alle Etiketten der Datei, eines pro Seite — praktisch, wenn ein Dienstleister eine Sendung mit mehreren Paketen in einem Puffer liefert:
base64 -d label.b64 > label.zpl # wenn der Dienstleister base64 liefert
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
Für ein Etikett, das für 300 dpi geschrieben ist, 12dpmm
verwenden. Das URL-Schema ist das von Labelary; dafür geschriebener Code
braucht meist nur einen neuen Host — siehe den
Labelary-kompatiblen Endpunkt.
Um ein fehlerhaftes Etikett vor dem Druck zu stoppen, liefert
/v1/diagnostics die Befunde als JSON; die vollständige
Referenz steht in der API-Dokumentation.
Wenn ein Skript jedes versendete Etikett umwandelt, ist der Umwandlungsdienst Teil Ihrer Versandstrecke: Antwortet er nicht, warten die Pakete. Bevor Sie sich auf einen Dienst verlassen, unseren eingeschlossen, lohnen sich zwei Prüfungen:
Carrier-ZPL ist fast immer für ein Etikett von 4×6 Zoll (etwa 100×150 mm) geschrieben. Was Konverter und API heute damit machen, gemessen am 2026-11-10:
X-Page-Size: A4 und X-Page-Layout: 2x2 setzen
vier Etiketten auf jede A4-Seite; jedes wird in seine Zelle eingepasst,
auf etwa 90 % (91×137 mm); ein 2×3-Raster ergibt etwa 60 %. Mit
1x1 (Standard, sobald eine Seitengröße gesetzt ist) wird das
Etikett in Originalgröße zentriert und nie vergrößert; ein 4×6-Etikett auf
A6 wird auf etwa 89 % verkleinert. Der Konverter bietet A4-, Letter-, A5-,
A6- und Legal-Bögen.Hier stehen nur Dienstleister, deren eigene Dokumentation wir lesen konnten. Labelixa kauft keine Etiketten und spricht nicht mit den Dienstleistern; es rendert das ZPL, das Sie bereits erhalten haben.
Shipping API, POST /shipments/{version}/ship:
LabelSpecification.LabelImageFormat.Code = ZPL,
LabelStockSize 4×6 oder 4×8 Zoll. Die Spezifikation hat kein
Auflösungsfeld; lesen Sie die Dichte aus der Datei. Anfragefelder und
Antwortpfade: UPS-ZPL-Etiketten.
Ship API: labelSpecification.imageType =
ZPLII, labelStockType etwa
STOCK_4X6, resolution 203 oder 300 (300 nur mit
ZPLII; Standard 203). Details:
FedEx-ZPL-Etiketten.
Domestic Labels 3.0 API (POST /labels/v3/label): USPS nennt
die Etikettenformate PDF, TIFF, SVG, JPG, ZPL203DPI und
ZPL300DPI — die Dichte steckt im Formatnamen. Das Feld für die
Etikettengröße im aktuellen Schema konnten wir nicht lesen.
MyDHL API 3.4.0: imageOptions → encodingFormat
akzeptiert zpl neben epl, lp2 und
pdf; laut DHL kommen Rechnung und Beleg immer als PDF. Gelesen
am 2026-10-31; ein Dichtefeld haben wir nicht gelesen.
Shipping API v2 (Buy Shipping): Die angeforderte Dokumentspezifikation
nimmt ein format (PDF, PNG oder
ZPL), eine size, einen dpi-Wert und
ein Seitenlayout; zulässig sind die Werte, die getRates für
die Sendung liefert (supportedDPIs). Das Etikett kommt
base64-kodiert in den Paketdokumenten.
ShipStation API: label_format = zpl.
ZPL-Etiketten gibt es nur in 4×6 Zoll; die Antwort enthält einen Link
label_download.zpl oder, wenn Sie diesen Download-Typ wählen,
base64 direkt in der Antwort.
Beim Anlegen der Transaktion label_file_type auf
ZPLII setzen; ohne Angabe gilt das Standardformat aus dem
Shippo-Dashboard. Shippo nennt für ZPL keine Größe.
Sendungsoptionen: label_format = ZPL; die
dokumentierte label_size für ZPL ist 4x6, die Carrier-Guides
nennen dienstleisterspezifische Größen.
In der GraphQL Admin API (2026-10) tragen die Dokumente eines
Versandetiketts ein format (PDF oder
ZPL) und eine url. Größe oder Dichte haben wir
dafür nicht gelesen.
Mit ZPL liefert der Aufruf Get Artifact ZPL-II-Befehle, und das Ausgabeformat muss 4x6 sein. Canada Post verlangt einen Drucker, der Text abschneiden kann, und empfiehlt sonst PDF.
Shipping and Tracking API, Etiketten erstellen: Eine Anfrage mit
ZPL-Etiketten ist auf 50 Pakete begrenzt, das Thermolayout heißt
THERMAL-LABEL-A6-1PP. Die Hilfeseite von Australia Post zu
internationalen CN22-Etiketten sagt, ZPL sei nur für das CN22-Etikett
freigeschaltet; prüfen Sie, welche Ihrer Produkte es abdeckt.
DPDs ShipmentService 3.5 (dokumentiert von DPD Schweiz):
printOptions.printerLanguage = ZPL,
paperFormat A6 und
printerResolution 203, 300 oder 600 (auch 150 und 200), passend
zum Druckkopf. DPD betreibt je Land eigene Webservices; prüfen Sie die
Dokumentation Ihres Landes.
Labelling-Webservice: Druckertyp Zebra|Generic ZPL II mit
200, 300 oder 600 dpi. PostNL rät davon ab, PDF-Etiketten direkt an einen
Zebra-Drucker zu senden.
Gelesen am 2026-10-31 und 2026-11-02: das Trendyol Common Label
("format": "ZPL"), HepsiJet (zplBarcode),
Yurtiçi (docCargoZpl), Aras (ZebraZpl), UPS
Türkiye (CreateShipment_Type3_ZPL), Kolay Gelsin und Sendeo
(BarcodeZpl) sowie PTT AVM ("type": "zpl").
Aufrufe und Felder:
Trendyol-
und HepsiJet-ZPL-Etiketten.
Labelixa ist nicht mit den auf dieser Seite genannten Versanddienstleistern und Plattformen verbunden; die Namen dienen nur dazu, zu sagen, welche Dokumentation gelesen wurde.
Ja. Wandeln Sie das ZPL in PDF oder PNG um und drucken Sie es auf jedem Drucker. Jede PDF-Seite hat standardmäßig Etikettengröße; drucken Sie in tatsächlicher Größe (100 %).
Ja. Senden Sie jede ZPL-Datei aus Ihrem Versandskript an den Render-Endpunkt und drucken Sie das zurückgegebene PDF oder PNG. Starter kostet 9 $ im Monat für 25.000 Etiketten im Monat.
Ein Etikett pro Seite druckt in voller Größe, wenn Sie das PDF in Etikettengröße mit 100 % drucken. Die A4-Rasterlayouts setzen vier oder sechs Etiketten auf eine Seite, verkleinert auf etwa 90 % bzw. 60 %.
Aus einer Tabelle hunderte ZPL-Etiketten machen: Vorlagen-Variablen, CSV-Spaltenzuordnung, Batch-Erzeugung und ehrliche Grenzen.
Trendyol- und HepsiJet-ZPL-Versandetiketten druckenDas Trendyol-Common-Label und die HepsiJet-Barcode-API liefern ZPL statt PDF. So prüfen Sie es und senden es an einen Thermodrucker.
ERP-Etikettendruck mit ZPLWo ERP-Etikettenketten brechen und wie ein Prüftor eine fehlerhafte Vorlage stoppt, bevor sie den Lagerdrucker erreicht.
UPS-ZPL-Etiketten: anfordern, prüfen, fixenDie Shipping-API-Felder hinter dem ZPL-Etikett (Formatcode, Stockgröße, Zeichensatz), der Pfad zur Nutzlast pro Paket und warum die Dichte aus der Datei kommt.