Drucker & Workstations

Das WMS verwendet ein Print-Broker-System: Drucker werden nicht direkt aus dem Browser angesteuert, sondern über einen lokalen Print Agent, der auf dem Packplatz-PC läuft. Der Agent verbindet sich mit dem WMS, empfängt Druckaufträge und sendet sie an die angeschlossenen Drucker — lautlos, ohne Browser-Dialoge.

Architektur-Überblick

So funktioniert es:

1. Ein Nutzer löst im WMS einen Versand aus (oder klickt “Nachdrucken”)
2. Das WMS erstellt einen Druckauftrag in der Datenbank mit Status queued
3. Der Print Agent auf dem Packplatz-PC wird per Realtime benachrichtigt (oder fragt alle 500ms ab)
4. Der Agent beansprucht den Auftrag (Status wird printing), lädt das Label herunter und druckt es
5. Der Agent meldet den Erfolg oder Fehler zurück (Status wird success oder failed)
6. Das WMS zeigt den aktuellen Status in der Druckhistorie an

Komponenten

Das Drucksystem besteht aus vier Hauptbestandteilen:

Druckauftrag-Lebenszyklus

Print Agent einrichten

Der Print Agent ist ein Windows-Programm (.exe), das auf jedem Packplatz-PC installiert werden muss.

Systemanforderungen

• Betriebssystem: Windows 10 oder neuer
• Runtime: .NET 8 (wird bei der Installation mitgeliefert)
• Netzwerk: Internetzugang zum WMS (HTTPS)

Installation (Schritt für Schritt)

1. Öffne im WMS Einstellungen → Drucker
2. Lade im Bereich Print Agent herunterladen die EXE-Datei herunter
3. Führe die Installation auf dem Packplatz-PC durch
4. Der Agent startet automatisch und legt sich in die Taskleiste (System Tray)
5. Der Agent startet künftig automatisch mit Windows

Pairing (Agent mit Workstation verbinden)

Nach der Installation muss der Agent einmalig mit einer Workstation im WMS gekoppelt werden:

1. Erstelle im WMS eine Workstation (siehe nächster Abschnitt) oder verwende eine bestehende
2. Klicke im WMS auf das Aktionsmenü der Workstation → Pairing-Code erstellen
3. Ein 6-stelliger Zahlencode wird angezeigt (gültig für 10 Minuten)
4. Öffne den Print Agent auf dem Packplatz-PC
5. Gib dort die WMS-URL ein (z.B. https://app.flowkom.de)
6. Gib den 6-stelligen Pairing-Code ein und bestätige
7. Die Verbindung ist hergestellt — der Agent zeigt den Status “Verbunden” an

Nach erfolgreichem Pairing:

• Die Workstation zeigt im WMS den Status Online (grüner Punkt)
• Die Agent-Version wird angezeigt
• Alle am PC angeschlossenen Drucker werden automatisch gemeldet und im WMS sichtbar

Sicherheit: Der Agent authentifiziert sich mit einem kryptografisch sicheren Device Token, nicht mit Benutzername/Passwort. Der Token ist an genau eine Workstation gebunden. Im WMS wird nur der Hash des Tokens gespeichert.

Workstations verwalten

Eine Workstation repräsentiert einen physischen Packplatz. Jede Workstation hat genau einen Print Agent und beliebig viele Drucker.

Workstation erstellen

1. Öffne Einstellungen → Drucker
2. Klicke auf Workstation hinzufügen
3. Vergib einen Namen (z.B. “Packplatz 1”, “Versand Erdgeschoss”)
4. Optional: Füge einen Kommentar hinzu (z.B. Standort, Besonderheiten)
5. Klicke auf Speichern

Workstation-Übersicht

Die Workstation-Tabelle zeigt alle konfigurierten Packplätze:

Online/Offline-Status

Der Agent sendet regelmäßig einen Heartbeat an das WMS. Anhand des letzten Heartbeat wird der Status bestimmt:

• Online (grüner Punkt): Letzter Heartbeat innerhalb der letzten 30 Sekunden
• Offline (grauer Punkt): Kein Heartbeat seit mehr als 30 Sekunden
• Nicht gepairt: Noch kein Agent verbunden — Pairing steht aus

Workstation aktivieren/deaktivieren

Über das Aktionsmenü (drei Punkte) kannst du eine Workstation deaktivieren. Deaktivierte Workstations:

• Erhalten keine neuen Druckaufträge
• Bleiben mit allen Einstellungen erhalten
• Können jederzeit wieder aktiviert werden

Warnung: Wenn keine Workstation aktiv ist, kann kein automatischer Labeldruck ausgeführt werden. Das WMS zeigt dann eine Warnmeldung an.

Workstation entkoppeln

Wenn der Print Agent durch eine Neuinstallation ersetzt werden muss:

1. Klicke auf das Aktionsmenü der Workstation
2. Wähle Entkoppeln
3. Der bestehende Device Token wird invalidiert
4. Erstelle einen neuen Pairing-Code und verbinde den neuen Agent

Workstation löschen

1. Klicke auf das Aktionsmenü → Löschen
2. Bestätige den Dialog

Bedingung: Eine Workstation kann nur gelöscht werden, wenn keine aktiven Druckaufträge (Status “Wartend” oder “Wird gedruckt”) vorhanden sind. Warte, bis alle Aufträge abgeschlossen sind, bevor du die Workstation löschst.

Drucker-Typen und Formate

Nach dem Pairing meldet der Agent alle am PC verfügbaren Drucker automatisch an das WMS. Die Drucker erscheinen im Tab Drucker der Workstation-Details.

Drucker-Typen

Brother QL und DYMO werden vom Agent automatisch anhand des Druckernamens als Adressetikettendrucker erkannt. Falls ein Drucker nicht erkannt wird (z.B. weil er umbenannt wurde), kann der Typ manuell geändert werden.

Label-Formate

Wichtig: Adressetikettendrucker (Brother QL, DYMO) unterstützen kein ZPL. Für diese Drucker muss das Format auf PDF eingestellt sein. Der Agent setzt dies beim Erkennen automatisch, aber das WMS zeigt eine Warnung an, falls ein Adressetikettendrucker auf ZPL eingestellt ist.

Drucker konfigurieren

In den Workstation-Details (Klick auf den Workstation-Namen) im Tab Drucker:

1. Format ändern: Über das Dropdown in der Format-Spalte zwischen PDF und ZPL wechseln
2. Typ ändern: Über das Aktionsmenü → “Drucker-Typ ändern” den Typ manuell setzen
3. Deaktivieren/Aktivieren: Über das Aktionsmenü den Drucker ein-/ausschalten. Deaktivierte Drucker stehen nicht für Zuweisungen zur Verfügung.
4. Testdruck: Über das Aktionsmenü → “Testdruck” einen Testdruck auslösen. Ein Test-Job wird in die Queue eingestellt und vom Agent verarbeitet.

Drucker-Zuweisungen (Versandart → Drucker)

Damit das WMS beim Versand automatisch den richtigen Drucker wählt, musst du Zuweisungen einrichten: Welcher Drucker soll für welche Versandart drucken?

Zuweisungen einrichten

1. Klicke auf eine Workstation, um die Details zu öffnen
2. Wechsle zum Tab Zuweisungen
3. Für jede Versandart siehst du zwei Dropdowns:
   • Primärdrucker — Der bevorzugte Drucker für diese Versandart
   • Fallback-Drucker — Wird verwendet, wenn der Primärdrucker inaktiv ist
4. Wähle die gewünschten Drucker aus
5. Klicke auf Speichern

Warnung: Versandarten ohne Drucker-Zuweisung werden mit einem gelben Warndreieck markiert. Ohne Zuweisung wird beim Versand kein automatischer Labeldruck ausgelöst — das Label kann aber weiterhin manuell heruntergeladen werden.

Exportdokument-Drucker (Zolldokumente)

Für internationale Sendungen mit Zolldokumenten (CN23) kann ein separater A4-Drucker konfiguriert werden:

1. Im Tab Zuweisungen findest du unter der Zuweisungstabelle den Bereich A4-Drucker für Exportdokumente
2. Wähle einen A4-Drucker aus der Liste
3. Zolldokumente werden automatisch an diesen Drucker gesendet

Nur aktive Drucker vom Typ “A4-Drucker” stehen in dieser Auswahl zur Verfügung.

Zuweisungen von anderer Workstation kopieren

Wenn du mehrere Packplätze mit gleicher Konfiguration einrichten möchtest:

1. Öffne die Zuweisungen der Ziel-Workstation
2. Klicke auf Von anderer Workstation kopieren
3. Wähle die Quell-Workstation aus
4. Die Zuweisungen werden übernommen (nur Drucker, die auch auf der Ziel-Workstation existieren)
5. Klicke auf Speichern, um die kopierten Zuweisungen zu sichern

Druckablauf im Versandprozess

Automatischer Labeldruck beim Versand

Der häufigste Druckvorgang: Ein Mitarbeiter versendet eine Bestellung, das Label wird automatisch gedruckt.

Ablauf im Detail:

1. Der Packer wählt im Versand-Dialog seine Workstation aus (wird im Browser gespeichert)
2. Nach Klick auf “Versenden” erstellt das WMS ein Label bei DHL/Deutsche Post
3. Das Label wird im Storage abgelegt
4. Das WMS sucht den passenden Drucker: Primärdrucker der Versandart → Fallback → kein Druck
5. Ein Druckauftrag wird in die Queue eingestellt
6. Der Print Agent empfängt den Auftrag, lädt das Label über eine signierte URL herunter und druckt es
7. Die signierte URL ist 24 Stunden gültig

Wichtig: Der Druckvorgang blockiert nie den Versandprozess. Falls kein Drucker zugewiesen ist oder der Agent offline ist, wird der Versand trotzdem abgeschlossen. Das Label kann dann manuell heruntergeladen werden.

Nachdruck (Reprint)

Falls ein Label erneut gedruckt werden muss (z.B. unleserlich, Papierstau):

1. Öffne die Bestelldetails der versendeten Bestellung
2. Klicke auf Nachdrucken beim gewünschten Label
3. Ein neuer Druckauftrag wird in die Queue eingestellt
4. Der Agent druckt das Label erneut

Der Nachdruck funktioniert für:

• Versandlabels — DHL, Deutsche Post
• Exportdokumente — CN23 Zolldokumente
• Retourenlabels — Falls automatisch erstellt

Was passiert, wenn kein Drucker konfiguriert ist?

Wenn beim Versand kein passender Drucker gefunden wird:

• Der Versand wird nicht blockiert — die Bestellung wird trotzdem als versendet markiert
• Das WMS zeigt eine Warnung: “Kein Drucker für Versandart X auf Workstation Y konfiguriert”
• Das Label kann über den Download-Link manuell heruntergeladen und gedruckt werden
• Die Lösung: Unter Einstellungen → Drucker den fehlenden Drucker zuweisen

Exportdokumente bei internationalen Sendungen

Bei internationalen DHL-Sendungen, die Zolldokumente (CN23) erfordern:

1. Das WMS erstellt neben dem Versandlabel auch ein Exportdokument
2. Falls ein Exportdokument-Drucker (A4) konfiguriert ist, wird ein separater Druckauftrag erstellt
3. Das Exportdokument wird automatisch auf dem A4-Drucker gedruckt
4. Falls kein Exportdrucker konfiguriert ist, kann das Dokument manuell heruntergeladen werden

Workstation im Versandprozess auswählen

Im Versand-Dialog (Pack & Ship) gibt es ein Workstation-Dropdown, um den aktiven Packplatz auszuwählen:

• Das Dropdown zeigt alle aktiven, gepaarten Workstations
• Neben dem Namen wird der Online-Status angezeigt (grün = online, grau = offline)
• Die Auswahl wird im Browser gespeichert und beim nächsten Öffnen automatisch vorbelegt
• Ohne Workstation-Auswahl ist der Versand weiterhin möglich — es wird nur kein automatischer Druck ausgelöst

Druckhistorie

In den Workstation-Details im Tab Druckhistorie siehst du alle Druckaufträge der Workstation:

• Auftrag — Bestellnummer (oder “Testdruck”)
• Drucker — Name des verwendeten Druckers
• Typ — Versandlabel, Exportdokument oder Testdruck
• Format — PDF oder ZPL
• Status — Wartend, Wird gedruckt, Erfolgreich, Fehlgeschlagen
• Zeitpunkt — Wann der Auftrag erstellt bzw. gedruckt wurde
• Benutzer — Wer den Druck ausgelöst hat

Bei fehlgeschlagenen Aufträgen kannst du über das Aktionsmenü einen Retry auslösen — ein neuer Druckauftrag mit Status “Wartend” wird erstellt.

Druckaufträge werden nach 60 Tagen automatisch bereinigt. Die zugehörigen Label-Dateien im Storage werden ebenfalls gelöscht.

Testdruck

Um zu prüfen, ob der Print Agent korrekt mit einem Drucker verbunden ist:

1. Öffne die Workstation-Details (Klick auf den Workstation-Namen)
2. Im Tab Drucker → Aktionsmenü des gewünschten Druckers → Testdruck
3. Ein Test-PDF wird als Druckauftrag in die Queue eingestellt
4. Der Agent verarbeitet den Auftrag und meldet das Ergebnis
5. In der Druckhistorie siehst du, ob der Testdruck erfolgreich war

Fehlerbehebung

Agent zeigt “Offline” im WMS

1. Prüfe, ob der Print Agent auf dem Packplatz-PC läuft (Icon in der Taskleiste?)
2. Prüfe die Internetverbindung des PCs
3. Starte den Agent neu (Rechtsklick auf Tray-Icon → Beenden, dann Agent erneut öffnen)
4. Falls der Agent seit der letzten Neuinstallation nicht mehr verbunden war: Entkoppeln und neu pairen

”Kein Drucker für Versandart X konfiguriert”

1. Öffne Einstellungen → Drucker
2. Klicke auf die betroffene Workstation
3. Wechsle zum Tab Zuweisungen
4. Weise der genannten Versandart einen Primärdrucker zu
5. Klicke auf Speichern

Druckauftrag bleibt auf “Wartend” hängen

1. Prüfe, ob die Workstation online ist (grüner Punkt)
2. Prüfe, ob der Agent auf dem PC läuft
3. Falls der Agent läuft aber keine Jobs abholt: Agent neu starten
4. Falls das Problem bestehen bleibt: Workstation entkoppeln und neu pairen

Druckauftrag zeigt “Fehlgeschlagen”

1. Öffne die Druckhistorie der Workstation
2. Prüfe die Fehlermeldung des fehlgeschlagenen Auftrags
3. Häufige Ursachen:
   • Drucker nicht gefunden — Der Drucker wurde vom PC entfernt oder ist ausgeschaltet
   • Papier/Etiketten leer — Nachfüllen und Retry auslösen
   • Format-Mismatch — ZPL an einen Nicht-ZPL-Drucker gesendet → Format in den Drucker-Einstellungen auf PDF umstellen
4. Nach Behebung der Ursache: Retry über das Aktionsmenü des Auftrags

Label wird in falscher Größe gedruckt

Das WMS sendet Labels im Originalformat (z.B. DHL: 100 x 210 mm). Die Skalierung auf die tatsächliche Etikettengröße ist Aufgabe des Windows-Druckertreibers:

1. Öffne auf dem Packplatz-PC die Druckereigenschaften
2. Stelle die Papiergröße/Etikettengröße auf das eingelegte Medium ein
3. Prüfe die Skalierungseinstellungen im Treiber

Häufige Fragen

Kann ich mehrere Drucker an einer Workstation betreiben?

Ja. Der Print Agent erkennt alle am PC angeschlossenen Drucker und meldet sie dem WMS. Über die Versandart-Zuweisungen steuerst du, welcher Drucker für welche Versandart verwendet wird. Du kannst z.B. einen Thermodrucker für DHL-Labels und einen A4-Drucker für Zolldokumente an derselben Workstation betreiben.

Was passiert, wenn der Print Agent offline ist?

Druckaufträge bleiben in der Queue mit Status “Wartend”. Sobald der Agent wieder verbunden ist, werden die wartenden Aufträge automatisch abgearbeitet. Zeitkritische Labels sollten deshalb immer mit einer aktiven Workstation generiert werden.

Können mehrere Packplätze gleichzeitig drucken?

Ja. Jede Workstation hat eine eigene Druckwarteschlange. Mehrere Packplätze arbeiten vollständig unabhängig voneinander. Es gibt kein Limit für die Anzahl gleichzeitig aktiver Workstations.

Wie wird verhindert, dass ein Label doppelt gedruckt wird?

Jeder Druckauftrag hat einen Idempotenz-Schlüssel (job_key). Beim Versand wird dieser aus Bestell-ID und Versandauftrags-ID zusammengesetzt. Ein zweiter Klick auf “Versenden” erzeugt keinen doppelten Druckauftrag — der bestehende wird erkannt und übersprungen.

Unterstützt das System ZPL und PDF gleichzeitig?

Ja. Das DHL-Label-Format wird beim Versand automatisch anhand der Drucker-Konfiguration gewählt. Ein Thermodrucker kann ZPL empfangen, während ein Adressetikettendrucker an derselben Workstation PDF bekommt. Das Format wird pro Drucker eingestellt, nicht pro Workstation.

Brauche ich den Print Agent für jeden PC?

Ja, der Print Agent muss auf jedem Packplatz-PC installiert werden, der automatisch drucken soll. Jeder Agent ist genau einer Workstation zugeordnet. Wenn du nur einen Packplatz hast, brauchst du nur einen Agent.

printer_type:     thermal | a4 | bond | label | unknown
label_format:     zpl | pdf
label_type:       shipping_label | picklist | test | export_document
print_job_status: queued | printing | success | failed

Verwandte Seiten

• Versandarten — Versandarten anlegen, die den Druckern zugewiesen werden
• Cron-Jobs — Täglicher Cleanup bereinigt alte Druckaufträge und Labels