Software-Handbuch: Etikettendruck & Zebra Studio
Enterprise-Etikettendruck direkt aus dem Browser: Visueller WYSIWYG-Designer (ZPL II, TSPL/TSPL2, EPL2, CAB JScript), echte scannbare Barcodes & QR-Codes, Mediathek mit automatischer 1-Bit-Grafikkonvertierung (
^GFA,BITMAP,GW), USB- & Netzwerkdruck über WebUSB, Zebra Browser Print, die Cloud-Print-Bridge (Windows PowerShell & Linuxsystemd) und Zelyra Connect (WireGuard-VPN), Kiosk-Modus, Stapeldruck aus der Business Suite und mandantenisolierte REST-API.
1. Überblick & Architektur
Das Modul Etikettendruck & Zebra Studio (/app/etiketten) ist vollständig mandantenfähig und verbindet cloudbasierte Etikettengestaltung mit lokalem Industriedruck auf Zebra-, TSC-, Godex-, CAB-, Honeywell-, SATO-, Citizen- und Brother-Druckern – sowie auf normalen A4-Laserdruckern (Avery/Zweckform).
| Bereich | Funktion |
|---|---|
| Vorlagen & Studio | Visueller WYSIWYG-Designer in mm (203/300/600 DPI), Vollbild-Modus, 1-Klick Starter-Vorlagen, Versionierung & Freigabeschutz |
| Mediathek & Symbole | Dauerhafte Mandanten-Mediathek für Firmenlogos & Piktogramme inkl. automatischer 1-Bit-Grafikkonvertierung |
| Drucker & Bridge | WebUSB (Chrome/Edge), Zebra Browser Print, Cloud-Print-Bridge (Windows PowerShell & Linux systemd), Zelyra WireGuard-VPN, TCP 9100 |
| VPN-Tunnel | Kostenfrei integriertes WireGuard-VPN-Gateway (vpn.zelyra.eu) mit 1-Klick Fritz!Box/Firewall-Import & Kernel-Isolation |
| Datenquellen & Stapel | CSV-Import, manuelle Tabellen sowie Live-Anbindung an Artikelkatalog, Kundenadressen und Lagerbestände |
| Kiosk-Schnelldruck | Touch- & Barcode-Scanner-optimierter Druck inkl. 1-Klick-Direktdruck aus Artikel-, Kunden- und Lagerlisten |
| REST-API | Mandantenisolierte Bearer-Token-API (/api/v1/labels/*) für ERP-, WMS- und Shop-Integrationen |
2. Etiketten gestalten im WYSIWYG-Studio
- Öffnen Sie Etiketten → Vorlagen und legen Sie entweder eine eigene Vorlage (z. B.
50 × 30 mmoder100 × 150 mm) an oder starten Sie mit einer der 1-Klick Starter-Vorlagen (Artikel, Versand, Lagerplatz). - Im Vollbild-Modus (
⛶ Vollbild, Beenden mitEsc) nutzen Sie die gesamte Bildschirmfläche mit automatisch eingepasstem Zoom (Fit) und einklappbaren Seitenleisten (◧/◨). - Elemente: Text/Variable, 1D-Barcode (
Code 128,GS1-128 / SSCC,EAN-13,EAN-8,Code 39,ITF-14), QR-Code, DataMatrix, Rahmen, Trennlinie sowie Bilder/Logos aus der Mediathek. - Profi-Steuerung: Rotation (
0°/90°/180°/270°), Ausrichtung (Links/Mitte/Rechts), Ausrichtungs-Helfer (⬌ Mitte,⬍ Mitte,↔ Breite), Duplizieren (Strg+D), Rückgängig (Strg+Z) und Feinpositionierung per Pfeiltasten (0,5 mm, mitShift2 mm).
3. Automatik-Platzhalter: Seriennummern, MHD & GS1-128
Platzhalter in doppelten geschweiften Klammern werden beim Druck automatisch aufgelöst:
| Platzhalter | Wirkung beim Druck |
|---|---|
{{seq:0001}} |
Fortlaufende Seriennummer – zählt bei Mehrfachdruck je Etikett hoch (0001, 0002, 0003 …) |
{{date}} / {{date_iso}} |
Aktuelles Datum (22.11.2026 bzw. 2026-11-22) |
{{date+365d}} / {{date+6m}} / {{date+1y}} |
Automatisches MHD / Verfallsdatum mit Tages-, Monats- oder Jahres-Offset |
{{date_gs1+180d}} |
GS1-Datumsformat YYMMDD für GS1-128 AI (17) |
{{week}} |
Aktuelle Kalenderwoche (z. B. KW47) |
{{copy_index}} / {{copy_total}} |
Aktuelle Kopienummer (z. B. Karton {{copy_index}} von {{copy_total}}) |
4. Unterstützte Druckerhersteller, USB- & Netzwerkdruck
Unser Modul ist nicht auf Zebra beschränkt – durch 4 native Druckersprachen und den A4-Bogen-Export betreiben Sie Drucker nahezu aller Industrie- und Bürohersteller parallel in einem Mandanten:
Unterstützte Druckersprachen & Hersteller
| Druckersprache / Ausgabe | Typische Hersteller & Modellreihen |
|---|---|
| ZPL II | Zebra (GK/GX, ZD420/421/621, ZT230/411/610) sowie ZPL-kompatible Drucker von Honeywell / Intermec, SATO, Citizen, Brother (TD/TJ-Serie), Toshiba TEC, Printronix, Datamax-O'Neil, Carl Valentin |
| TSPL / TSPL2 | TSC (TE200, TTP-244, MH241 …), Godex, Bixolon, Gprinter, HPRT, Rongta |
| EPL2 | Zebra LP/TLP 2844, Eltron und EPL-kompatible Geräte |
| CAB JScript | CAB (SQUIX, A+, MACH, EOS, HERMES) |
| A4-Bögen (Avery / Zweckform) | Jeder Laser- oder Tintenstrahldrucker (HP, Brother, Kyocera, Canon, Epson, Ricoh, Lexmark …) |
Entscheidungshilfe: Welche Druckmethode wann?
| Methode | Ideal für | Lokale Software nötig? | Unterstützte Geräte |
|---|---|---|---|
| Cloud-Print-Bridge (Empfohlen) | Firmennetze, Lager, mehrere Arbeitsplätze, Tablets & Handys | 1× zentral auf einem PC/Server/Pi | Alle LAN-Drucker (TCP Port 9100) |
| Zelyra WireGuard-VPN (Inklusive) | Direkter Port-9100-Druck über Fritz!Box / OPNsense / pfSense ohne lokales Skript | Nein (1-Klick .conf in Router/Firewall) |
Alle LAN-Drucker (TCP Port 9100, kollisionsfrei) |
| WebUSB | Einzelner USB-Zebra direkt am Packtisch | Nein (Zero-Install) | USB-Zebra in Chrome / Edge |
| Zebra Browser Print | Einzelne Windows-/macOS-PCs (auch Firefox/Safari) | Offizielles Zebra-Tool auf dem PC | Lokale USB-, LAN- & Bluetooth-Zebras |
| Avery / Zweckform A4 | Büro-Laserdrucker / Tintenstrahldrucker / PDF | Nein | Jeder normale A4-Drucker |
A) Cloud-Print-Bridge (Empfohlen für Firmennetze & Tablets – ohne VPN)
- Legen Sie Ihren Drucker unter Etiketten → Drucker & Bridge mit Verbindungsart „Cloud Print-Bridge“ an und tragen Sie dessen lokale Firmennetz-IP (z. B.
192.168.1.50) und Port9100ein. - Laden Sie den passenden Installer herunter und starten Sie ihn einmalig im selben Netz:
- Windows (unsichtbarer Autostart-Dienst ohne Konsolenfenster):
powershell -ExecutionPolicy Bypass -File .\siedelmann-print-bridge-install.ps1 - Linux / Raspberry Pi (
systemd-Dienst):sudo bash siedelmann-print-bridge-install.sh
- Windows (unsichtbarer Autostart-Dienst ohne Konsolenfenster):
- Die Live-Heartbeat-Ampel unter Drucker & Bridge springt innerhalb weniger Sekunden auf Grün (
Bridge aktiv).
B) Zelyra Connect · WireGuard-VPN (Direktdruck Port 9100 ohne lokales Skript)
Kostenfrei im Modul enthalten unter Etiketten → VPN-Tunnel (/app/etiketten/vpn):
- Tunnel anlegen, Gegenstelle wählen (z. B. Fritz!Box ab FRITZ!OS 7.50, OPNsense/pfSense, Windows, Linux) und lokales Netz (
192.168.178.0/24) oder einzelne Drucker-IP (192.168.178.50/32) eintragen. - Fertige
.conf-Datei herunterladen (oder QR-Code scannen) und in der Fritz!Box unter Internet → Freigaben → VPN (WireGuard) → Verbindung hinzufügen → Netzwerke koppeln → Einstellungsdatei importieren hochladen. - Sobald die Handshake-Ampel grün ist, Drucker unter Drucker & Bridge mit Verbindungsart „Zelyra WireGuard-VPN“ anlegen und per Ping prüfen.
- Sicherheit: Jeder Tunnel läuft auf dem Gateway in einem eigenen, kernel-isolierten Linux Network Namespace (0 % IP-Kollisionen zwischen Kunden) mit strikter Einbahnstraßen-Firewall (
INPUT/FORWARD DROP) und eigenem Preshared Key.
C) WebUSB (Direkter USB-Druck im Browser – Zero-Install)
Für direkt per USB angeschlossene Zebra-Drucker in Chrome oder Microsoft Edge – keine IP-Adresse und keine lokale Installation erforderlich.
D) Zebra Browser Print (Lokaler Zebra-Dienst für Windows & macOS)
- Offizielles Zebra Browser Print installieren und starten (
localhost:9100/9101). - Dort den Standarddrucker wählen und ggf.
siedelmann.com/zelyra.eubestätigen. - Unter Drucker & Bridge auf „🔍 Zebra Browser Print suchen“ klicken und Drucker anlegen.
E) Avery / Zweckform A4-Bögen (Normale Bürodrucker & PDF)
- Über
A4-Bogenöffnet sich eine millimetergenaue DIN-A4-Druckseite im gewählten Avery-/Zweckform-Raster inkl. echt scannbarer SVG-Barcodes, QR-Codes, Logos und Start-Offset für angebrochene Bögen. - Im Browser-Druckdialog: Skalierung auf „100 % / Tatsächliche Größe“ und Ränder auf „Keine“ belassen.
5. REST-API & ERP-Anbindung
Erstellen Sie unter Etiketten → REST-API ein mandantenisoliertes Bearer-Token (print, bridge, read):
curl -X POST https://siedelmann.com/api/v1/labels/print \
-H "Authorization: Bearer lbl_DEIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"template_code": "ARTIKEL",
"copies": 2,
"variables": {
"sku": "ART-10420",
"name": "Industrie-Sensor PT100",
"price": "49,90 EUR"
}
}'
6. Versionierung, Freigabeschutz & Sicherheit
- Jedes Speichern einer Vorlage erhöht automatisch die Versionsnummer (
v1,v2, …). - Freigabeschutz: Freigegebene Vorlagen sind für reguläre Mitarbeiter im Layout geschützt (nur Mandanten-Administratoren dürfen Änderungen speichern oder löschen), während der Kiosk-Schnelldruck jederzeit fehlerfrei nutzbar bleibt.
- Alle Vorlagen, Drucker, Druckaufträge, Mediathek-Dateien, VPN-Tunnel und API-Tokens sind strikt mandantenisoliert.
