Dokumentation
Bondrucker
Jede angenommene Bestellung (im Terminal oder automatisch ohne Annahme) wird als Küchenbon gedruckt: 80 mm mit 48 Zeichen oder 58 mm mit 32 Zeichen je Zeile (Einstellung Papierbreite), Zeichensatz CP858, als ESC/POS bzw. bei Star CloudPRNT als StarPRNT. Bestellnummer, Fertig- bzw. Wunschzeit, Positionen (doppelt hoch) mit Optionen und Kommentaren, Anmerkung, Gesamtbetrag, Zahlungsart und Gast. Die Bestellart steht nur auf dem Bon, wenn Abholung und Lieferung angeboten werden.
Druckertypen (Konfiguration → Bondrucker):
| Typ | Funktionsweise | Einsatz |
|---|---|---|
| Druck-Brücke im Restaurant | Ein kleines Gerät im Restaurant-Netz (z. B. Raspberry Pi) holt die Bons per HTTPS über einen Verbindungslink ab und gibt sie an den Drucker weiter. | Empfohlen für gehostete Websites, funktioniert mit jedem ESC/POS-Netzwerkdrucker. Einrichtung: Anleitung im Paket unter bridge/README.md |
| Star CloudPRNT | Der Drucker fragt den Shop selbst alle paar Sekunden per HTTPS nach neuen Bons, ohne zusätzliches Gerät. | Star-Drucker mit CloudPRNT, z. B. mC-Print2 (58 mm) und mC-Print3 (80 mm). Einrichtung: Star CloudPRNT |
| Netzwerkdrucker (ESC/POS über TCP) | Der Webserver sendet den Bon direkt an den Drucker. | Nur wenn der Server den Drucker erreicht, z. B. für Tests mit einem virtuellen Drucker |
- Druckaufträge stehen in einer Warteschlange (
tl_gratorder_print_job). Ist der Drucker nicht erreichbar, wird bis zu fünfmal im Abstand von 30 Sekunden neu versucht. - Im Terminal zeigt die Bestellung den Bon-Status, im Dialog gibt es Bon nachdrucken. Ist die Druck-Brücke bzw. der CloudPRNT-Drucker länger als 30 Sekunden ohne Kontakt, erscheint oben „Druck-Brücke offline“ bzw. „Drucker offline“.
- Zum Testen ohne echten Drucker eignen sich virtuelle Drucker, z. B. virtual-printer.online oder die iPad-App Virtual Thermal Printer. Keine echten Kundendaten verwenden – die Übertragung ist unverschlüsselt.
Star CloudPRNT
Star-Drucker mit CloudPRNT holen die Bons selbst ab: Der Drucker fragt den Shop regelmäßig per
HTTPS (POST), lädt einen bereitliegenden Bon (GET, application/vnd.star.starprnt) und meldet das
Ergebnis (DELETE). Getestet ist das Protokoll mit einem Simulator; unterstützt sind mC-Print2 und
mC-Print3 ab Firmware 1.2 (mit Auftrags-Token ab 3.2). Diese Modelle verstehen nur StarPRNT,
nicht ESC/POS; Druck-Brücke und Netzwerkdrucker eignen sich für sie daher nicht.
Einrichtung
- GratOrder → Konfiguration → Bondrucker: Druckertyp Star CloudPRNT, Papierbreite (58 mm
für mC-Print2, 80 mm für mC-Print3), speichern. Danach erscheint die Server-URL
(
https://<domain>/_gratorder/cloudprnt/<token>). - IP-Adresse des Druckers herausfinden: Selbsttest-Ausdruck (Feed-Taste beim Einschalten gedrückt halten) oder im Router.
- Die IP-Adresse im Browser öffnen (Webinterface des Druckers), anmelden (Standard:
root/public, danach ändern). - Unter CloudPRNT den Dienst aktivieren, die Server-URL eintragen, Abfrageintervall (Polling time) 5 Sekunden, speichern und den Drucker neu starten (Save → Restart device).
- In der Konfiguration springt der Status nach wenigen Sekunden auf „verbunden“.
Hinweise:
- Die Website braucht ein gültiges HTTPS-Zertifikat einer öffentlichen Stelle (z. B. Let's Encrypt); der Drucker prüft es gegen seine eingebaute Liste.
- Das Token in der URL ist der einzige Schlüssel. Neue Server-URL erzeugen macht die alte sofort ungültig; danach die neue URL im Drucker eintragen.
- Meldet der Drucker „Papier leer“, „Papierstau“ oder „Deckel offen“, erscheint das oben im Terminal, die Statusmeldung steht auch in der Konfiguration. Bricht ein Bon deshalb ab, wird er nach dem Beheben automatisch neu gedruckt (Warteschlange wie oben).