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 1-Bit-Grafikkonvertierung (^GFA, BITMAP, GW), USB- & Netzwerkdruck über WebUSB, Zebra Browser Print, die Cloud-Print-Bridge (Windows PowerShell & Linux systemd) 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

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

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)

  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 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) Zelyra Connect · WireGuard-VPN (Direktdruck Port 9100 ohne lokales Skript)

Kostenfrei im Modul enthalten unter Etiketten → VPN-Tunnel (/app/etiketten/vpn):

  1. 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.
  2. 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.
  3. Sobald die Handshake-Ampel grün ist, Drucker unter Drucker & Bridge mit Verbindungsart „Zelyra WireGuard-VPN“ anlegen und per Ping prüfen.

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)

  1. Offizielles Zebra Browser Print installieren und starten (localhost:9100/9101).
  2. Dort den Standarddrucker wählen und ggf. siedelmann.com / zelyra.eu bestätigen.
  3. Unter Drucker & Bridge auf „🔍 Zebra Browser Print suchen“ klicken und Drucker anlegen.

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


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