Belegdrucker einrichten: Verbindung und Bestelldruck

Der RestaurantManage Print Agent ist ein leichter Windows-Dienst, der Druckbefehle aus der Cloud empfängt und sie an Ihren Thermobeleg-Drucker sendet — wodurch automatischer Belegdruck ermöglicht wird, wenn Bestellungen bezahlt werden oder wenn Küchentickets gedruckt werden müssen. Der Agent unterstützt Netzwerkdrucker (TCP-Port 9100), USB-Drucker und Windows-Spooler-Verbindungen. Diese Anleitung behandelt Installation, Konfiguration, Druckerverbindung und Fehlerbehebung.

Wie funktioniert der Belegdruck?

Der Druckworkflow ist vollständig automatisiert. Wenn ein Kassierer eine Zahlung bestätigt oder ein Küchenticket ausgelöst wird, generiert das RestaurantManage-Backend den vollständigen Beleg als ESC/POS-Byte-Befehle — einschließlich Restaurantname, Tischnummer, aufgeführter Bestellung, Preise, Steueraufschlüsselung, Gesamtbetrag und Zahlungsart. Diese Bytes werden über eine sichere WebSocket-Verbindung (PrintHub) an den Print Agent gesendet, der auf einem Windows-PC in Ihrem Restaurant läuft. Der Agent dekodiert die Daten und leitet sie direkt an den angeschlossenen Thermodrucker weiter. Der gesamte Prozess dauert weniger als zwei Sekunden von der Zahlungsbestätigung bis zum gedruckten Beleg.

Wie installiere ich den Print Agent?

Herunterladen: Holen Sie sich den neuesten Print Agent-Installer aus Ihrem Admin-Dashboard oder kontaktieren Sie den Support.
Installieren: Führen Sie den Installer auf einem Windows-PC aus, der während der Servicezeiten eingeschaltet bleibt.
Konfigurieren: Öffnen Sie config.json und geben Sie Ihre API-Basis-URL, Restaurant-ID und den Agenten-Geheimschlüssel ein (von Ihrem Administrator bereitgestellt).
Drucker verbinden: Schließen Sie Ihren Thermodrucker per USB an oder verbinden Sie ihn mit demselben Netzwerk wie der PC.
Dienst starten: Starten Sie den Print Agent — er verbindet sich automatisch mit PrintHub und zeigt einen grünen Statusindikator.
Testdruck: Verarbeiten Sie eine Testzahlung im Kassenpanel und überprüfen Sie, ob der Beleg korrekt gedruckt wird.

Welche Druckerverbindungstypen werden unterstützt?

Der Print Agent unterstützt drei Verbindungsmethoden mit automatischem Fallback zwischen ihnen. Netzwerkdrucker verbinden sich über TCP auf Port 9100 — geben Sie die IP-Adresse des Druckers in der Konfiguration ein. Dies ist die empfohlene Methode für Restaurants mit mehreren Druckern. USB-Drucker verbinden sich direkt mit dem PC und werden über den Windows-Spooler oder direkte USB-Port-Adressierung angesprochen. Der Windows-Spooler verwendet den Standard-Windows-Druckertreiber, der mit jedem von Windows erkannten Drucker funktioniert. Der Agent versucht zuerst den Spooler, fällt dann auf direktes USB zurück und versucht schließlich UNC-Netzwerkfreigaben.

Wie konfiguriere ich den Print Agent?

Der Print Agent verwendet eine config.json-Datei mit drei erforderlichen Einstellungen: ApiBaseUrl (die RestaurantManage-Server-URL), RestaurantId (die eindeutige ID Ihres Restaurants aus dem Admin-Dashboard) und AgentSecretKey (ein im Admin-Panel generierter Geheimschlüssel, der den Druckagenten ohne Benutzerkonto authentifiziert). Der Agent authentifiziert sich bei PrintHub mit diesem Geheimschlüssel über WebSocket. Für Netzwerkdrucker fügen Sie die Drucker-IP und den Port zur Konfiguration hinzu. Der Agent protokolliert alle Aktivitäten im Ordner logs/ zur Fehlerbehebung.

Wie funktioniert die automatische Aktualisierung?

Der Print Agent prüft ungefähr alle 2,5 Stunden auf Updates, indem er den Update-Endpunkt auf dem RestaurantManage-Server aufruft. Wenn eine neue Version verfügbar ist, lädt er das Update-Paket als ZIP-Datei in einen Ordner für ausstehende Updates herunter, führt das Installationsskript aus und startet den Dienst automatisch neu. Das bedeutet, dass Ihr Restaurant immer die neueste Version ohne manuellen Eingriff ausführt. Update-Prüfungen beinhalten einen restaurantspezifischen Zeitversatz, damit nicht alle Agenten gleichzeitig aktualisieren. Sie können die aktuelle Agentenversion im Admin-Dashboard einsehen.

Häufige Probleme beheben

Agent verbindet sich nicht: Prüfen Sie, ob ApiBaseUrl und AgentSecretKey in config.json korrekt sind. Verifizieren Sie den Internetzugang auf dem PC.
Beleg wird nicht gedruckt: Bestätigen Sie, dass der Drucker eingeschaltet und verbunden ist. Prüfen Sie den Ordner logs/ für Fehlerdetails.
Unlesbarer Text auf dem Beleg: Stellen Sie sicher, dass Ihr Drucker ESC/POS-Befehle unterstützt. Die meisten 80-mm-Thermodrucker sind kompatibel.
Verbindung bricht häufig ab: Der Agent verbindet sich automatisch neu, aber prüfen Sie Ihre Netzwerkstabilität. Eine kabelgebundene Ethernet-Verbindung ist zuverlässiger als WLAN.
Agent startet nicht als Dienst: Führen Sie install-service.bat als Administrator aus, um den Windows-Dienst korrekt zu registrieren.