Dieser Artikel beschreibt, welche Parameter eine Dirmeier-Schankanlage mit smartSCHANK für die Anbindung an ein bessa Produkt benötigt. bessa implementiert die Schnittstelle DIRMEIER smartschank – REST API for Cash Interface (Version 1.0). Die Anbindung erfolgt ausschließlich über das Netzwerk.
Voraussetzungen
-
Die Schankanlage ist mit smartSCHANK ausgestattet und stellt die Cash-REST-Schnittstelle im lokalen Netz bereit.
-
Die Schankanlage hat eine statische IP aus dem Kassennetzwerk oder eine reservierte DHCP-Lease.
-
Kassa und Schankanlage liegen im selben Netz, oder zwischen ihren Netzen wird geroutet. Die Kassa muss die Schankanlage auf TCP-Port 80 erreichen.
-
Die Schankanlage ist nicht im Konfigurationsmodus. In diesem Modus pausiert sie die Schnittstelle, siehe Pausierte Schankanlage.
-
Im bessa Manager ist ein Schank-Profil angelegt und mit den Artikel-PLUs und Benutzernummern der Schankanlage befüllt. Der Eintrag ist nur vorhanden, wenn das Schank-Modul zuvor bei bessa bestellt wurde. Siehe Schanken.
Dirmeier-Anlagen beherrschen zum Teil auch das E-Protokoll und VMPS. Dirmeier rät von der seriellen Anbindung und von VMPS über UDP ab und empfiehlt die REST-Schnittstelle. Verwenden Sie deshalb smartSCHANK, wenn die Anlage es anbietet.
Parameter
smartSCHANK wird ausschließlich mit dem Verbindungstyp Netzwerk betrieben. Eingetragen werden die Werte im jeweiligen bessa Produkt — an der Kassa unter Schankeinstellungen.
|
Feld |
Bedeutung |
Wert |
|---|---|---|
|
Verbindungstyp |
Anbindungsart |
|
|
Protokoll |
Kassenprotokoll |
|
|
IP Adresse |
Statische IP der Schankanlage |
z. B. |
|
Port |
HTTP-Port der Cash-Schnittstelle |
|
Weitere Felder gibt es nicht. Stellen-Angaben und ein Prüfsummen-Schalter wie beim E-Protokoll entfallen, weil smartSCHANK alle Nutzdaten als JSON überträgt. Eine Kopplung am Display wie bei der Brau Union Z1U ist nicht nötig: Die Schnittstelle kommt ohne Anmeldung aus.
Die Kommunikation läuft über unverschlüsseltes HTTP im lokalen Netz. Die Cloud-Variante von Dirmeier mit HTTPS und Anmeldedaten wird nicht unterstützt.
Erreichbarkeit prüfen
Testen & Speichern in den Schankeinstellungen fragt die Liste der offenen Zapfungen von der Schankanlage ab. Diese Abfrage verändert an der Anlage nichts. Ist die Anlage nicht erreichbar oder pausiert, zeigt die Kassa einen Fehler und speichert die Einstellung nicht.
Für die Diagnose ohne Kassa öffnen Sie in einem Browser im selben Netz die Adresse http://<IP-Adresse>/cash/1.0/credits, bei abweichendem Port http://<IP-Adresse>:<Port>/cash/1.0/credits. Eine erreichbare Anlage antwortet mit einer Liste der offenen Freigaben oder mit dem Status 410, wenn keine offen sind. Bleibt die Seite ohne Antwort, ist die Anlage aus diesem Netz nicht erreichbar.
Was die Kassa an die Schankanlage sendet
Die Kassa arbeitet mit smartSCHANK im Kreditbetrieb: Jeder gebuchte Schankartikel wird an der Anlage freigegeben und kann danach gezapft werden.
-
Artikel-PLU und Menge — aus der Artikelzuordnung des Schank-Profils.
-
Benutzernummer — aus der Benutzerzuordnung des Schank-Profils. Die Servicekräfte melden sich an der Schankanlage selbst mit ihrer PIN an. Ob eine Freigabe nur von der Servicekraft mit derselben Nummer gezapft werden kann, hängt von der Konfiguration der Anlage ab.
-
Artikelname — der Name der Position, damit die Freigabe am Display der Schankanlage lesbar ist.
-
Tischnummer — nur bei Bestellungen auf einen Tisch. Bei Theke, Zimmer, Kiosk und Online-Bestellungen bleibt sie leer.
Ein Storno an der Kassa reduziert die Freigabe an der Schankanlage um die stornierte Menge. Ist die Freigabe bereits gezapft, kann die Anlage nichts mehr reduzieren: Die Kassa meldet das, der Storno bleibt in der Kassa trotzdem gebucht.
Guthaben zurücksetzen im Menü der Schank-Detailansicht bucht alle offenen Freigaben an der Schankanlage zurück. Sinnvoll ist das nach Testbuchungen oder wenn Kassa und Schankanlage auseinandergelaufen sind.
Getränke, die ohne Freigabe der Kassa gezapft werden, übernimmt die Kassa nicht. Der Debitbetrieb, bei dem eine Zapfung an der Schankanlage automatisch eine Buchung an der Kassa auslöst, ist für smartSCHANK nicht verfügbar.
Pausierte Schankanlage
Solange die Schankanlage im Konfigurationsmodus ist, pausiert sie die Cash-Schnittstelle. An der Kassa wirkt sich das so aus:
-
Testen & Speichern schlägt fehl. Die Einstellung wird nicht gespeichert.
-
Eine Freigabe kommt nicht an der Anlage an. Die Kassa meldet „Diese Artikel konnten nicht zur Schank übertragen werden“ und nennt die betroffenen Artikel. Die Buchung an der Kassa bleibt bestehen.
Beenden Sie den Konfigurationsmodus an der Schankanlage, bevor Sie die Anbindung einrichten oder den Betrieb aufnehmen.
FAQ
Kann eine smartSCHANK seriell angebunden werden? Nicht über das Protokoll smartSCHANK REST — es steht ausschließlich für den Verbindungstyp Netzwerk zur Verfügung.
Muss ich den Port ändern? Nur wenn die Cash-Schnittstelle an der Anlage auf einem anderen Port als 80 eingerichtet ist. Den Wert nennt Ihnen der Dirmeier-Service.
Warum steht an der Anlage keine Tischnummer? Die Kassa sendet die Tischnummer nur bei Bestellungen auf einen Tisch. Thekenbuchungen kommen ohne Tisch an.
Warum wurde ein Storno an der Anlage nicht abgezogen? Die Freigabe war bereits gezapft. Was gezapft ist, lässt sich an der Anlage nicht mehr reduzieren.
Mögliche Fehlerquellen
-
Testen & Speichern schlägt fehl — falsche IP-Adresse oder falscher Port, die Anlage ist ausgeschaltet oder vom Netz, Kassa und Schankanlage liegen in getrennten VLANs ohne Routing, oder die Anlage ist im Konfigurationsmodus.
-
„Diese Artikel konnten nicht zur Schank übertragen werden“ — die Anlage war beim Buchen nicht erreichbar oder pausiert. Prüfen Sie die Erreichbarkeit wie oben beschrieben.
-
Freigabe erscheint, lässt sich aber nicht zapfen — die PLU im Schank-Profil passt nicht zur Anlage, oder die Anlage bindet Freigaben an die Servicekraft und dort ist eine andere Servicekraft angemeldet als jene, für die die Freigabe gesendet wurde.
-
Eine Firewall blockiert HTTP — die Strecke von der Kassa zur Schankanlage muss TCP-Port 80 (oder den eingetragenen Port) zulassen.
Verwandte Themen
-
Schankanlagen — Übersicht der unterstützten Protokolle
-
Schankeinstellungen — Anbindung an der Kassa
-
Schanken — Artikel, Benutzer, Tische und Betriebsmodus im bessa Manager
- Netzwerksicherheit & Port-Freigaben