ZPL-Fehlersuche nach Symptom

Veröffentlicht: 2026-08-27 · Aktualisiert: 2026-10-01

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
Eine Textzeile läuft über den Rand, oder umbrochene Zeilen drucken übereinander	Das Feld hat kein ^FB, also wird nichts umbrochen; oder sein ^FB erlaubt weniger Zeilen, als der Text braucht, und der Rest überdruckt die letzte Zeile	Text läuft über den Rand
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
Mehrere Grafiken im Format, nur die letzte wird gedruckt	Ein mobiler Drucker, der ZPL durch eine Emulationsschicht führt — das Format selbst ist meist gültig	Nur letzte Grafik
Roher Text und Steuerzeichen statt eines Etiketts	Bei einer Feed-Tasten-Sequenz ausgelöster Dump-Modus — oder ZPL an einen Drucker der EPL-Generation	Druckt Zeichensalat
Der Drucker verlangt plötzlich Farbband, Medienverhalten wechselt zwischen Jobs	Das Format trägt ^MT, und der Drucker gehorcht jobseitiger Konfiguration	Medientyp aus dem Format
Statusabfragen (~HS) dauern ewig oder kommen nie zurück	Fünf Druckerzustände antworten mit Stille; eine Abfrage hinter einer offenen Verbindung wartet	Langsamer oder stummer Status
Ping antwortet, an Port 9100 kommt nichts an	ICMP geht durch, der Raw-Dienst ist aus, gefiltert oder von einer anderen Verbindung belegt	Ping geht, 9100 nicht
Punkte über Flächen, die weiß sein sollten	Eine gerasterte Bitmap in der Datei — oder Schwärzung, Schmutz und Verschleiß am Druckkopf	Punkte in weißen Flächen
Thermotransferdruck blass, verschmiert oder reibt sich ab	Farbbandtyp passt nicht zum Etikettenmaterial, oder Geschwindigkeit über dem Farbbandmaximum	Blasser oder verschmierter Transferdruck

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.

Die Vorschau stimmt, das Papier nicht: eine Checkliste

„Im Viewer sieht es richtig aus und druckt leer (oder gedreht, oder winzig)" ist eine der häufigsten Fragen zu ZPL. Arbeiten Sie die Liste der Reihe nach ab — jeder Schritt schließt eine Schicht zwischen Datei und Druckkopf aus:

1. Nutzt die Vorschau die Dichte des Druckers? Eine für 203 dpi geschriebene Datei sieht bei 8 dpmm richtig aus und druckt auf einem 300-dpi-Kopf auf zwei Dritteln der Größe — siehe Etikett druckt zu klein.
2. Kommt der Auftrag roh beim Drucker an? Ein Windows- oder CUPS-Treiber kann den Auftrag rastern, skalieren, drehen oder einpacken; ERP- und Versandsysteme, die über einen Treiber drucken, sind die übliche Quelle gedrehter Versandetiketten — siehe ZPL ohne Treiber drucken.
3. Interpretiert der Drucker überhaupt ZPL? Im Dump- (Diagnose-)Modus druckt er die empfangenen Befehle als Text, und ein reiner EPL-Drucker macht aus ZPL verstümmelte Ausgabe — siehe Drucker druckt Zeichensalat.
4. Überschreiben im Drucker gespeicherte Einstellungen die Datei? Ausrichtung (^PO), oberer Versatz (^LT), Etikettenverschiebung (^LS) und Druckbreite lassen sich in der Druckerkonfiguration speichern (^JUS); ein gespeicherter Wert gilt für jeden Auftrag, der ihn nicht selbst setzt — siehe Etikett druckt kopfüber und Inhalt verschoben.
5. Wird das Material richtig erkannt? Leere oder übersprungene Etiketten bei korrekter Vorschau deuten auf Lücken-/Markenerkennung und Kalibrierung — siehe zusätzliches leeres Etikett.
6. Ging der Auftrag an den Drucker, den Sie meinen? Eine Warteschlange oder IP, die inzwischen auf ein anderes Gerät zeigt, ergibt „nichts ist passiert" — siehe Etikett am falschen Drucker gedruckt.

Drei Prüfungen, die das meiste abfangen

1. 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.
2. 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.
3. 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).

Verwandte Ratgeber

Eigenen ZPL-Code testen →