ZPL-Schnelleinstieg

ZPL-Schnelleinstieg

Was ZPL ist

ZPL (Zebra Programming Language) ist eine textbasierte Sprache zur Ansteuerung von Zebra- und kompatiblen Thermodruckern. Ein ZPL-Etikett ist nichts anderes als ein Textblock: Er beginnt mit ^XA, endet mit ^XZ, und dazwischen werden grafische Elemente, Texte und Barcodes deklariert.

Der Vorteil: Die "Datei" ist lesbar, versionierbar und von Hand editierbar. Kein proprietäres Format — ein einfacher Texteditor reicht, um ein druckfertiges Etikett zu erzeugen.

Hello world

^XA
^FO50,50^A0N,40,40^FDHallo Welt^FS
^XZ

Das ist alles. An einen Zebra-Drucker (oder einen Viewer wie Labelary) gesendet, erzeugt es ein Etikett mit "Hallo Welt" oben links.

Anatomie eines Etiketts

Zeile für Zeile bedeutet das obige Beispiel:

  • ^XA — start format: markiert den Beginn des Etiketts. Alles, was folgt, gehört zum aktuellen Etikett.
  • ^FO50,50 — field origin: platziert das nächste Element 50 Dots vom linken und 50 Dots vom oberen Rand.
  • ^A0N,40,40 — Schriftart: wählt Schrift 0, Ausrichtung N (normal, nicht gedreht), Höhe 40 Dots, Breite 40 Dots.
  • ^FD — field data: leitet den Feldinhalt ein. Alles bis ^FS ist der zu druckende Text.
  • ^FS — field separator: schließt das Feld. Es zu vergessen ist einer der häufigsten Fehler: Der Parser verschluckt nachfolgende Befehle als Datenteil.
  • ^XZ — end format: schließt das Etikett.

Wesentliche Befehle

Befehl Wirkung
^XA / ^XZ Öffnet / schließt das Etikettenformat
^PW Druckbreite (Dots)
^LL Etikettenlänge (Dots)
^LH Verschiebt den logischen Etiketten-Ursprung
^CI28 UTF-8-Kodierung (für Umlaute zwingend)
^FO x,y Positioniert das nächste Element
^A0N,h,w Skalierbare Schrift 0, Höhe/Breite in Dots
^FD ... ^FS Umschließt das Datenfeld
^BC Code-128-Barcode
^BQ QR-Code
^GB w,h,t Rechteck oder Linie (Breite, Höhe, Stärke)
^GF Graustufen-Bitmap
^FX Kommentar (vom Drucker ignoriert)

Koordinatensystem

ZPL rechnet in Dots (einzelnen Druckpunkten), nicht in Millimetern. Die Umrechnung hängt von der Druckerauflösung ab:

dot = mm * DPI / 25.4

Praxisbeispiele:

  • 50 mm bei 203 dpi ≈ 400 Dots
  • 50 mm bei 300 dpi ≈ 591 Dots
  • 100 mm bei 203 dpi ≈ 800 Dots

Ursprung (0,0) ist die obere linke Ecke. Ein 203-dpi-Drucker mit 4-Zoll-Etiketten verwendet typischerweise ^PW812.

Dynamische Platzhalter

Im ZPL Archive verwenden wir die Notation {{name}} für Felder, die zur Laufzeit ersetzt werden. Beispiel eines parametrischen Versandetiketts:

^XA
^CI28
^FO30,30^A0N,28,28^FDEmpfänger:^FS
^FO30,70^A0N,36,36^FD{{customer_name}}^FS
^FO30,120^A0N,28,28^FDTracking:^FS
^FO30,160^BCN,80,Y,N,N^FD{{tracking_number}}^FS
^XZ

Der Personalisierungs-Editor liest die {{...}}, zeigt ein Formular mit einem Feld pro Platzhalter und erzeugt das finale ZPL mit eingesetzten Werten, bevor es an Drucker oder Vorschau geht.

Häufige Fehler

Passieren jedem mindestens einmal. Es lohnt sich, sie schnell zu erkennen.

  • Vergessenes ^FS: Die nachfolgenden Befehle werden vom vorherigen Feld "verschluckt", und das Etikett kommt leer oder verschoben heraus.
  • Koordinaten außerhalb des Druckbereichs: Bei ^PW812 aber ^FO900,... wird das Element nicht gedruckt. Werte immer gegen ^PW und ^LL prüfen.
  • Schriftart nicht im Drucker vorhanden: Schrift 0 ist immer da, alle anderen hängen von der Firmware ab. Im Zweifel ^A0N nutzen.
  • Umlaute als ? oder kryptische Zeichen: ^CI28 fehlt am Anfang. Direkt nach ^XA einfügen.
  • Barcode lässt sich nicht scannen: Meist ist die Quiet Zone (weißer Rand) zu klein. ^FO erhöhen oder Modulbreite reduzieren.

Externe Ressourcen