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 ZPL-
^GFA-Grafikkonvertierung, Zebra USB- & Netzwerkdruck über WebUSB, Zebra Browser Print und die Cloud-Print-Bridge (Windows PowerShell & Linuxsystemd), 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- und CAB-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-ZPL-^GFA-Konvertierung |
| Drucker & Bridge | WebUSB (Chrome/Edge), Zebra Browser Print, Cloud-Print-Bridge (Windows PowerShell & Linux systemd), Direktdruck TCP 9100 |
| 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. Zebra USB- & Netzwerkdruck (Cloud-kompatibel)
Da die Business Suite in der Cloud läuft, Ihre Zebra-Drucker aber im lokalen Firmennetz oder per USB am Packtisch stehen, stehen Ihnen 4 Druckwege zur Verfügung:
A) Cloud-Print-Bridge (Empfohlen für Firmennetze & Tablets – ohne VPN)
Die lokale Bridge holt offene Druckaufträge ausgehend per HTTPS ab und sendet sie lokal per TCP (Port 9100) an Ihre Netzwerkdrucker. Es ist keine Port-Freigabe in der Firewall und kein VPN erforderlich.
- Windows (unsichtbarer Autostart-Dienst ohne Konsolenfenster):
Laden Sie unter Drucker & Bridge den Windows Autostart-Dienst (
.ps1) herunter und starten Sie ihn einmalig:powershell -ExecutionPolicy Bypass -File .\siedelmann-print-bridge-install.ps1 - Linux / Raspberry Pi (
systemd-Dienst):sudo bash siedelmann-print-bridge-install.sh - Die Live-Heartbeat-Ampel unter Drucker & Bridge zeigt innerhalb weniger Sekunden grün (
Bridge aktiv), sobald der Dienst verbunden ist.
B) WebUSB (Direkter USB-Druck im Browser – Zero-Install)
Für direkt per USB angeschlossene Zebra-Drucker (Chrome / Edge): Drucker anstecken, als Verbindungsart WebUSB wählen und beim ersten Druck im Browser-Dialog freigeben – fertig.
C) Zebra Browser Print
Für Arbeitsplätze, auf denen der offizielle lokale Zebra Browser Print Dienst (localhost:9100/9101) läuft – unterstützt lokale USB- und Netzwerkdrucker.
D) Avery / Zweckform A4-Bögen
Über den Button A4-Bogen drucken Sie jede Vorlage inkl. echt scannbarer SVG-Barcodes, QR-Codes, Logos und optionalem Start-Offset auf herkömmlichen Laserdruckern.
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 und API-Tokens sind strikt mandantenisoliert.
