22

Drucker & Drucker-Routing

Wozu dient das?#

Der Bereich DRUCKEN im Backoffice richtet den Belegdrucker ein und ordnet die Menükategorien den Druckergruppen Speisen, Getränke und Sonstiges zu. Die Gruppe einer Kategorie bestimmt, auf welchem Küchen- oder Barausdruck ihre Artikel erscheinen.

Voraussetzungen#

• Mindestens ein einsatzbereiter ESC/POS-Netzwerkdrucker (Port 9100) oder ein über die POS Bridge (Station Controller) eingebundenes Druckgerät.
• Angelegte Menükategorien im Kassenkatalog (→ Kapitel 21 Speisekarte).
• Administrator- oder Manager-Berechtigung im Backoffice.

Rollen#

• Administrator (admin): Kann die Druckerhardware und das Routing bearbeiten.
• Betriebsleiter (manager): Kann das Routing anpassen.
• Servicepersonal (server): Hat keinen Zugriff auf die Druckereinstellungen im Backoffice, steuert Nachdrucke jedoch über das Kassen-Terminal.

Bildschirm für Bildschirm#

Im Backoffice öffnen Sie DRUCKEN. Oben stehen der Titel Drucken und die Zeile Netzwerk ESC/POS-Druckerkonfiguration., darunter eine Leiste EINSTELLUNGEN mit einer Auswahl der Bereiche Drucker-Hardware und Drucker-Routing.

1. Belegdruck (Drucker-Hardware)#

• 1 Die Leiste EINSTELLUNGEN mit der Auswahl des Bereichs. Hier wechseln Sie zwischen Drucker-Hardware und Drucker-Routing.
• 2 Der Schalter neben Belegdruck. Ist er aus, sind die Felder darunter ausgegraut und es wird nicht gedruckt.
• 3 IP-ADRESSE / HOST: die Adresse des Netzwerkdruckers, zum Beispiel 192.168.1.100.
• 4 PORT: Standard ist 9100.
• 5 DRUCKER-UNTERTYP: Netzwerk ESC/POS (Generisch) oder Kein physischer Drucker.
• 6 DRUCKERHARDWARE SPEICHERN. Die Schaltfläche ist erst aktiv, wenn Sie etwas geändert haben.

Dieser Bereich bearbeitet den Belegdrucker Ihres Betriebs. Eine Liste mehrerer Drucker mit Testdruck und Statusanzeige gibt es in der Kasse nicht.

2. Drucker-Routing#

Hier legen Sie fest, welche Menükategorie auf welcher Druckergruppe ausgegeben wird.

• 1 Die Auswahl in der Leiste steht auf Drucker-Routing, der Titel lautet Drucker & Routing.
• 2 Die Tabellenspalten KATEGORIENAME, ROUTINGGRUPPE und STATUS.
• 3 In jeder Zeile wählen Sie die Gruppe: SPEISEN, GETRÄNKE oder SONSTIGES. Die aktive Gruppe ist farbig gefüllt. Ein Tipp speichert sofort; dabei dreht sich in der Spalte STATUS kurz ein Ladesymbol.
• 4 Die Meldung nach dem Speichern lautet Routing-Kategorie aktualisiert.

Schritt für Schritt#

Belegdrucker einrichten#

1. Öffnen Sie im Backoffice DRUCKEN und stellen Sie den Schalter Belegdruck an.
2. Tragen Sie IP-ADRESSE / HOST und PORT des Druckers ein und wählen Sie Netzwerk ESC/POS (Generisch).
3. Tippen Sie auf DRUCKERHARDWARE SPEICHERN.

Kategorien auf Druckergruppen verteilen#

1. Wechseln Sie in der Leiste EINSTELLUNGEN auf Drucker-Routing.
2. Stellen Sie bei jeder Kategorie die Gruppe ein: Vorspeisen, Hauptgänge und Desserts auf SPEISEN, Getränke auf GETRÄNKE, alles andere (zum Beispiel Gutscheine) auf SONSTIGES.

Pfad D: Kassenlade am Bondrucker#

Die Kassenlade hängt an der Ladenbuchse des Bondruckers und öffnet auf einen elektrischen Puls, den das Kassensystem über den Station Controller an den Drucker schickt.

1. Einrichten: Die Einstellungen der Kassenlade (Einschalten, Pin 2 oder 5, Pulsdauer, Vorgabe 50 ms an, 500 ms aus) gehören zum Drucker. Dafür gibt es in der Kasse keine Bedienmaske; wenden Sie sich an Ihren Betreuer. Pro Standort genau ein Drucker mit Kassenlade — eine Zuordnung Kasse → Drucker gibt es nicht, bei mehreren Laden öffnet die Barzahlung keine.
2. Barzahlung: Nach jeder erfolgreichen Barzahlung öffnet die Lade von selbst. Bei Kartenzahlung öffnet sie nie. Ist der Drucker nicht erreichbar, bleibt die Zahlung gültig; der Fehlschlag steht im Protokoll.
3. Lade öffnen ohne Verkauf: Im Schicht-Menü (→ Kapitel 12) die Schaltfläche Lade öffnen. Er erscheint nur mit dem Recht printing.cash_drawer.open (Vorgabe: Administrator und Betriebsleiter; im Rechte-Konfigurator auf Servicepersonal erweiterbar). Ein Grund ist Pflicht.
4. Protokoll: Jedes Öffnen steht unveränderlich im Audit-Log — wer, wann, welcher Drucker, welcher Standort, Grund bzw. Zahlung, und ob der Puls ankam, unterwegs ist oder fehlschlug. Der Schichtbericht zählt „Lade ohne Verkauf geöffnet“.

Drucker anlegen und Testdruck (nur über die Schnittstelle)#

Die Plattform kann mehrere Drucker je Standort verwalten: einen Drucker anlegen, ändern, löschen und einen Testdruck auslösen (POST /api/v1/printers/{id}/test-print). Dafür gibt es in der Kasse keine Bedienoberfläche: Weder unter DRUCKEN noch an anderer Stelle finden Sie eine Druckerliste, eine Schaltfläche zum Anlegen oder einen Testdruck. Ein zusätzlicher Drucker wird über die Schnittstelle (→ Kapitel 37) oder durch Ihren Betreuer eingerichtet. Der Belegdrucker aus dem Bereich Drucker-Hardware ist davon unabhängig.

Was passiert im Hintergrund#

• Beim Auslösen einer Bestellung erzeugt das Backend einen PrintJob in der Datenbank.
• Die Routing-Engine liest die routing_category aller Produkte der Bestellung aus und gruppiert die Positionen nach Druckern.
• Das Backend sendet für jeden Ziel-Drucker ein DeviceCommand mit kind: "print". Ist ein Station Controller aktiv, holt dieser den Befehl ab (claim_commands) und sendet die raw ESC/POS-Bytes direkt per TCP-Socket an Port 9100 des Druckers.
• Der Status durchläuft: queued → claimed → printed. Antworte der Drucker nicht innerhalb von 60 Sekunden, schlägt der Befehl fehl (status: failed).

Häufige Probleme#

1. Drucker fällt mitten im Service aus (Papierstau, Stromverlust, Kabel getrennt)#

• Verhalten: Die Bestellung geht im Kassensystem nicht verloren. Das Kassen-Terminal zeigt an, dass der Druck fehlgeschlagen ist.
• Ursache: Das Gateway versucht 60 Sekunden lang, den Druckauftrag an die IP zu senden. Nach dem Timeout schlägt der DeviceCommand fehl (Command timed out waiting in queue).
• Lösung: Beheben Sie die Störung am Drucker (Papier einlegen, Strom zuschalten) und lösen Sie den Ausdruck an der Kasse erneut aus.

2. Kein Papier mehr im Drucker (Paper Out)#

• Ursache: Der Drucker meldet Papiermangel und nimmt keine Bytes mehr an.
• Lösung: Legen Sie eine neue Thermopapierrolle ein und schließen Sie die Klappe. Fehlgeschlagene Ausdrucke lösen Sie an der Kasse erneut aus.

3. Küchen-Drucker empfängt keine Bestellungen#

• Meldung: Kein Fehler an der Kasse, aber kein Ausdruck in der Küche.
• Ursache: Die Kategorie der Artikel steht auf SONSTIGES statt auf SPEISEN oder GETRÄNKE, oder der Belegdruck ist ausgeschaltet.
• Lösung: Öffnen Sie DRUCKEN → Drucker-Routing und prüfen Sie die Gruppe der Kategorie. Prüfen Sie unter Drucker-Hardware, ob der Schalter Belegdruck an ist und IP-ADRESSE / HOST stimmt.

4. Printer not found#

• Meldung: Printer not found
• Ursache: Der hinterlegte Drucker existiert nicht mehr.
• Lösung: Öffnen Sie DRUCKEN → Drucker-Hardware, prüfen Sie die Angaben und tippen Sie auf DRUCKERHARDWARE SPEICHERN.

5. Print job not found#

• Meldung: Print job not found
• Ursache: Das POS Gateway versucht, den Status eines Druckauftrags zu melden, der bereits storniert oder bereinigt wurde.
• Lösung: Tritt dieser Fehler auf, aktualisieren Sie die Druckeransicht. Bei anhaltendem Fehler starten Sie die Kassen-App neu.

6. Receipt cannot be issued in live mode: Mock TSE provider is not permitted#

• Meldung: Receipt cannot be issued in live mode: Mock TSE provider is not permitted
• Ursache: Ein Kassenbeleg soll auf einem Produktiv-Drucker ausgedruckt werden, während das Kassensystem noch im Fiskal-Simulationsmodus läuft.
• Lösung: Stellen Sie in den Fiskaleinstellungen auf einen echten TSE-Provider (Fiskaly (Cloud-TSE) oder Hardware-TSE) um.

7. Order must be paid before issuing receipt#

• Meldung: Order must be paid before issuing receipt
• Ursache: Es wurde versucht, einen endgültigen Zahlungsbeleg für eine Bestellung zu drucken, die noch nicht vollständig bezahlt ist.
• Lösung: Drucken Sie stattdessen eine Zwischenrechnung (Pre-Receipt) oder schalten Sie die Bestellung an der Kasse zuerst vollständig ab.

8. Receipt already issued for this order#

• Meldung: Receipt already issued for this order
• Ursache: Es wurde versucht, einen Kassenbeleg für eine Bestellung zu erzeugen, für die bereits ein offizieller Beleg ausgestellt wurde (Schutz vor Doppelbelegen).
• Lösung: Nutzen Sie an der Kasse die Funktion Beleg nachdrucken, um ein Duplikat zu erzeugen.

Grenzen#

• Drucker-Routing ist auf Kategorie- und Gruppen-Ebene ausgelegt; eine individuelle Routing-Regel pro einzelnen Artikelvarianten ist nicht vorgesehen.
• Standard-Windows-GDI-Treiber ohne direkte ESC/POS-Netzwerkschnittstelle (Port 9100) werden für den Echtzeit-Küchendruck nicht unterstützt.

Dieses Kapitel gehört zum Merkuron-Handbuch für Inhaber und Servicepersonal.