Ratgeber › ZPL-Fehlersuche nach Symptom

ZPL-Fehlersuche nach Symptom

Veröffentlicht: 2026-08-27

Gesundheitsbericht

Thermodruck-Probleme werden rückwärts diagnostiziert: Sie sehen die physische Ausgabe und arbeiten sich zur ZPL-Zeile zurück, die sie verursacht hat. Diese Seite ist der Triage-Schritt — ordnen Sie zu, was der Drucker tatsächlich getan hat, lesen Sie die übliche Ursache und folgen Sie der Prüfung, die sie bestätigt. Jedes Symptom verlinkt auf eine ausführliche Anleitung.

Bei der Datei anfangen, nicht beim Drucker

Der Reflex ist, eine Druckereinstellung zu ändern, erneut zu drucken und zu schauen. Das kostet Etiketten und verdeckt die Ursache: Eine geänderte Einstellung kann ein Dateiproblem für einen Auftrag maskieren und es beim nächsten Drucker zurückbringen. ZPL ist lesbarer Text, und die meisten Fehler sind darin sichtbar — deklarierte Größe, Koordinaten, Feldabschlüsse, Richtungsbuchstaben. Lesen Sie zuerst die Datei; fassen Sie den Drucker erst an, wenn die Datei nachweislich sauber ist.

Symptom → wahrscheinliche Ursache

Was Sie sehen	Übliche Ursache	Anleitung
Alles gedruckt, aber viel zu klein für das Material	Die Datei wurde in Punkten für eine Auflösung geschrieben und an einen Drucker mit anderer geschickt (203 vs. 300 dpi)	Etikett druckt zu klein
Rechter Rand oder unterer Teil fehlt	Inhalt überschreitet `^PW`/`^LL`, oder das Material ist schmaler als angenommen	Etikett abgeschnitten
Der Barcode druckt, aber kein Scanner liest ihn	Modulbreite zu klein für die Auflösung, fehlende Ruhezone oder Daten, die die Symbologie nicht kodieren kann	Barcode nicht lesbar
Das ganze Etikett steht auf dem Kopf, oder ein Feld liegt quer	Drei getrennte Schalter drehen: `^PO` (ganzes Etikett), `^FW` (alle folgenden Felder), der Richtungsbuchstabe in `^A` (ein Feld)	Druckt auf dem Kopf
Umlaute oder Sonderzeichen kommen als Buchstabensalat	Kodierungskonflikt — die Datei ist UTF-8, aber dem Drucker wurde es nicht gesagt (`^CI28`), oder der Schrift fehlt die Glyphe	Sonderzeichen fehlen
Nach jedem echten Etikett kommt ein leeres	Die deklarierte Etikettenlänge passt nicht zum Material, oder im Auftrag steckt ein ungewolltes `^PQ`	Zusätzliches leeres Etikett
Das Layout stimmt, aber alles sitzt versetzt	Eine globale Verschiebung wirkt: `^LH`, `^LS` oder `^LT` — oder `^FT` wird wie `^FO` gelesen	Inhalt verschoben
Das Etikett kommt komplett leer heraus	Strukturell: unausgeglichenes `^XA`/`^XZ`, eine gerissene `^FS`-Kette, die folgende Befehle schluckt, oder Daten ohne Position	Druckt leer

Was eine Vorschau belegen kann — und was nicht

Eine Browser-Vorschau zeichnet dieselben Befehle, die ein Drucker zeichnen würde, und klärt damit eine große Klasse von Fragen ohne Materialverbrauch: ob der Inhalt in die deklarierte Größe passt, ob Koordinaten dort landen, wo Sie denken, ob die Barcodedaten kodierbar sind, ob ^FW und die ^A-Ausrichtungen je Feld das Erwartete tun und ob der Befehlsstrom strukturell sauber ist.

Die physische Ebene kann sie nicht belegen. Die im Drucker angewandte Druckausrichtung (^PO), der Kopfversatz (^LT), Materialerkennung und Lückensensor, Schwärzung und Geschwindigkeit, Ribbon- und Kopfzustand sowie die RFID-Kodierung geschehen alle, nachdem das Bild aufgebaut wurde. Eine makellose Vorschau grenzt das Problem auf diese Ebene ein — das ist nützliche Information, kein Fehlschlag.

Drei Prüfungen, die das meiste abfangen

Deklariert die Datei ihre Größe, und passt die zum Material? ^PW und ^LL stehen in Punkten, nicht in Zoll oder Millimetern. Ein 4-Zoll-Etikett sind 812 Punkte bei 203 dpi und 1218 bei 300 dpi.
Ist jedes Feld abgeschlossen? Ein fehlendes ^FS macht die folgenden Befehle zu Daten des vorherigen Felds — sie verschwinden aus der Ausgabe, statt einen Fehler zu erzeugen.
Verschiebt oder dreht etwas global? Suchen Sie die Datei nach ^LH, ^LS, ^LT, ^PO und ^FW ab, bevor Sie einzelne Felder prüfen — einer davon erklärt die meisten "alles verrutscht"-Meldungen.

Fügen Sie ein Etikett in den ZPL-Viewer ein: Strukturprüfung und gerendertes Ergebnis in einem Schritt.

Häufig gestellte Fragen

Wo fange ich an, wenn ein ZPL-Etikett falsch druckt?

Bei der Datei, nicht beim Drucker. Deklarierte Größe (^PW/^LL), Koordinaten, die ^FS-Kette und Richtungsbuchstaben sind lesbarer Text, und die meisten Fehler sind dort sichtbar. Eine geänderte Druckereinstellung maskiert ein Dateiproblem für einen Auftrag und bringt es beim nächsten Drucker zurück.

Kann eine Browser-Vorschau belegen, warum mein Etikett falsch druckt?

Sie klärt die Aufbau-Ebene: ob der Inhalt in die deklarierte Größe passt, ob Koordinaten dort landen, wo Sie es erwarten, ob die Barcodedaten kodierbar sind und ob der Befehlsstrom strukturell sauber ist. Die physische Ebene kann sie nicht belegen — ^PO, ^LT, Materialerkennung, Schwärzung, Ribbon- und Kopfzustand wirken erst nach dem Bildaufbau.

Was sind die schnellsten Prüfungen bei einem defekten ZPL-Etikett?

Drei: Deklariert die Datei eine Größe, die zum Material passt (^PW/^LL in Punkten — 4 Zoll sind 812 bei 203 dpi und 1218 bei 300 dpi); ist jedes Feld mit ^FS abgeschlossen; und verschiebt oder dreht etwas global (^LH, ^LS, ^LT, ^PO, ^FW).