ZELYRA
SOFTWARE-HANDBUCH · ETIKETTENDRUCK

Etikettendruck &
Zebra Studio.

Praxishandbuch für visuellen Etikettendruck (ZPL II, TSPL, EPL2, CAB), Mediathek, Seriennummern & GS1-128, WebUSB, Windows-/Linux-Print-Bridge und REST-API.

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. 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.
PRODUKTÜBERSICHT & PREISEEtikettendruck & Zebra Studio (59 € netto/Monat) →