ZELYRA HANDBUCH

Vollständige Sprachdokumentation & Technische Referenz
Zelyra 1.3.1 (Commit e20d099)
Offizielle Dokumentation · Stefan Siedelmann
https://siedelmann.com · November 2026

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 & Linux systemd), 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

  1. Öffnen Sie Etiketten → Vorlagen und legen Sie entweder eine eigene Vorlage (z. B. 50 × 30 mm oder 100 × 150 mm) an oder starten Sie mit einer der 1-Klick Starter-Vorlagen (Artikel, Versand, Lagerplatz).
  2. Im Vollbild-Modus (⛶ Vollbild, Beenden mit Esc) nutzen Sie die gesamte Bildschirmfläche mit automatisch eingepasstem Zoom (Fit) und einklappbaren Seitenleisten (◧ / ◨).
  3. 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.
  4. 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, mit Shift 2 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 …)

Da die Business Suite in der Cloud läuft, Ihre Etikettendrucker aber im lokalen Firmennetz oder per USB am Packtisch stehen, stehen Ihnen 4 Druckwege zur Verfügung:

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)
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)

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.

  1. 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 Port 9100 ein.
  2. Laden Sie den passenden Installer herunter und starten Sie ihn einmalig auf einem Rechner/Server 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
      
  3. Die Live-Heartbeat-Ampel unter Drucker & Bridge springt innerhalb weniger Sekunden auf Grün (Bridge aktiv).

B) WebUSB (Direkter USB-Druck im Browser – Zero-Install)

Für direkt per USB angeschlossene Zebra-Drucker in Chrome oder Microsoft Edge:

  1. Zebra-Drucker per USB anschließen (keine IP-Adresse nötig).
  2. Drucker als Verbindungsart WebUSB anlegen oder direkt auf „🔌 Zebra USB koppeln & testen“ klicken.
  3. Im Browser-Dialog das Zebra-Gerät einmalig freigeben – ab sofort druckt der Browser direkt per USB.

C) Zebra Browser Print (Lokaler Zebra-Dienst für Windows & macOS)

Zebra Browser Print ist das kostenlose offizielle Hintergrund-Tool von Zebra. Ihr Browser sendet den fertigen ZPL-Code lokal an 127.0.0.1:9100 / 9101 auf demselben PC, und das Zebra-Tool leitet ihn an den Drucker weiter:

  1. Offizielles Zebra Browser Print auf dem Arbeitsplatz-PC installieren und starten (Symbol im Windows-Infobereich / macOS-Menüleiste).
  2. Dort den gewünschten USB- oder LAN-Zebra als Standarddrucker wählen (und ggf. siedelmann.com / zelyra.eu beim ersten Aufruf im Zebra-Popup zulassen).
  3. In unserer App unter Drucker & Bridge auf „🔍 Zebra Browser Print suchen“ klicken – der Drucker wird sofort erkannt. Anschließend einen Drucker mit Verbindungsart „Zebra Browser Print“ anlegen (bleibt die Geräte-UID leer, wird automatisch der Standarddrucker verwendet).

D) Avery / Zweckform A4-Bögen (Normale Bürodrucker & PDF)

Für A4-Etikettenbögen wird kein Zebra-Drucker benötigt:


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