Ratgeber › ZPL-Etiketten aus Excel- oder CSV-Daten drucken

ZPL-Etiketten aus Excel- oder CSV-Daten drucken

Veröffentlicht:

Der häufigste Etikettenjob in der Praxis ist nicht ein Etikett — es ist ein Design plus eine Tabelle voller Zeilen: Produkte, Sendungen, Regalplätze. Dieser Leitfaden zeigt den ganzen Weg von der Excel/CSV-Datei zum druckbaren ZPL-Stapel.

Schritt 1 — Variablen ins ZPL setzen

Jeden Wert, der sich pro Zeile ändert, durch einen {{name}}-Platzhalter ersetzen:

^XA
^FO40,40^A0N,35^FD{{produkt}}^FS
^FO40,90^BY2^BCN,80,Y,N,N^FD{{sku}}^FS
^XZ

Platzhalter können typisiert sein ({{menge:sayi}} für Zahlen) und Vorgaben tragen ({{notiz|—}} hält eine Zeile bei leerer Zelle gültig). Das Bulk-Werkzeug erkennt die Platzhalter beim Einfügen der Vorlage automatisch.

Schritt 2 — Tabelle als CSV exportieren

In Excel: Datei → Speichern unter → CSV (UTF-8). Die erste Zeile muss Überschriften enthalten. Die Namen müssen nicht mit den Platzhaltern übereinstimmen — der nächste Schritt ordnet zu — gleiche Namen ordnen sich aber von selbst zu.

Schritt 3 — hochladen und Spalten zuordnen

Im Bulk-Generator die CSV hochladen und jeden Platzhalter einer Spalte zuordnen. Vor der Erzeugung gibt es eine Vorschau pro Zeile: eine falsch zugeordnete Spalte zeigt sich als falsches Etikett am Bildschirm, nicht als verschwendete Rolle.

Schritt 4 — erzeugen und drucken

Der Batch läuft als Job: Fortschritt sichtbar, Abbruch möglich, Ergebnis als ZIP. Jedes erzeugte Etikett zählt gegen das Kontingent des Plans — eine Tabelle mit 500 Zeilen sind 500 Vorgänge, und das Werkzeug sagt das vor dem Start, nicht erst auf der Rechnung.

Automatisierung über die API

Derselbe Ablauf existiert als REST-Endpunkte für wiederkehrende Jobs: POST /v1/variables/csv parst die Datei, POST /v1/bulk/jobs startet den Batch — siehe API-Referenz. Was im Browser funktioniert, funktioniert über die API identisch; es ist derselbe Motor.

Ehrliche Grenzen

Das Rendering zeigt, was der Server zeichnet — nicht, was Dunkelheit und Material Ihres Druckers daraus machen; vor einem großen Batch ein Etikett physisch testen. Formeln in Zellen gelten als reiner Text (bewusst: CSV-Formel-Injection ist ein realer Angriff) — Werte also vor dem Export in der Tabelle berechnen.

Häufig gestellte Fragen

Kann ich ZPL-Etiketten direkt aus einer Excel-Datei drucken?

Nicht direkt — die Tabelle zuerst als CSV (UTF-8) exportieren und in den Bulk-Generator hochladen. Platzhalter wie {{sku}} in der ZPL-Vorlage werden CSV-Spalten zugeordnet, pro Zeile in der Vorschau gezeigt und als Batch-Job erzeugt.

Funktionieren Excel-Formeln in der CSV?

Nein — Zelleninhalte gelten bewusst als reiner Text (CSV-Formel-Injection ist ein realer Angriff). Werte vor dem Export in der Tabelle berechnen; nur die Ergebnisse reisen mit.

Wie wird ein Batch mit 500 Zeilen abgerechnet?

Jedes erzeugte Etikett zählt als ein Vorgang gegen das Kontingent des Plans; 500 Zeilen sind 500 Vorgänge. Das Werkzeug nennt die Zahl vor dem Start des Jobs.

Verwandte Ratgeber

Was ist ZPL?

ZPL ist die Sprache der Zebra-Thermodrucker. Wie die Befehle zu lesen sind, wie ein Etikett aufgebaut wird und welche Fehler am häufigsten vorkommen.

Welche Barcode-Symbologie soll ich wählen?

EAN-13, Code 128 oder QR? Praktische Regeln für die Wahl des Barcodes nach Daten, Platz und Lesegerät.

ZPL-Datei ohne Drucker in der Vorschau ansehen

Eine ZPL-Datei ist nur Text — das Etikett existiert erst, wenn etwas es zeichnet. Drei praktische Wege, ein ZPL-Etikett vor dem Drucker zu sehen.

Eigenen ZPL-Code testen →