Cash XML API — kompatibel zur ibelsa cashAPI

Über diese Cash XML API können Kassensysteme abgeschlossene Verkäufe und zimmerbezogene Buchungen an die Hotelsoftware übertragen. Die empfangenen Daten können optional zur automatischen Erstellung von Rechnungen für Hausgäste oder Passanten sowie für interne Auswertungen verwendet werden.

Die vollständige Feldbeschreibung inkl. Sonderfällen (Storno, Split-Payments) ist in der ibelsa cashAPI-Dokumentation beschrieben: https://rooms.ibelsa.com/doc/cashapi/doc_2.2

Unterstützte Funktionen

Diese Methoden der API werden derzeit unterstützt:

  • Ping
  • GetVersion
  • RoomsGetList (RoomsLookupList)
  • InvoiceToRoom
  • InvoicesClosedTransfer (InvoicesShiftClose)

Gastrokasse in Casona hinzufügen

Folgen Sie unserer Anleitung zum Anlegen einer Gastrokasse in Casona: Gastrokassen verbinden

Verwenden Sie XML Cash API als Kassentyp, um zum Beispiel Kassen wie von Leaf Systems zu verbinden. Nach dem Speichern werden Ihnen die beiden benötigten Verbindungsschlüssel angezeigt, die in der Gastrokasse hinterlegt werden müssen.

  1. System-Schlüssel
  2. Benutzer-Schlüssel
  3. Wenn in der Kasse weitere Felder wie "Name" angegeben sind, können diese beliebig befüllt werden.

Produktkategorien und Produkte verknüpfen

In unserer Anleitung Gastrokassen verbinden wird beschrieben, wie vorhandene Produktkategorien und Produkte anhand der in der Kasse hinterlegten IDs verknüpft werden können.

Kategorien und Produkte, die nicht anhand einer hinterlegten ID zugeordnet werden können, werden automatisch in Casona als neue Kategorie bzw. Produkt angelegt. Dies ist wichtig, um die Produkte mit dem korrekten Steuersatz in Rechnung zu stellen.

Buchungen für Passanten

Die Option Passantenrechnung für Buchungen ohne Zimmerzuordnung erlaubt es Ihnen, auch Rechnungen aus der Gastrokasse zu empfangen, die nicht an ein Zimmer gestellt wurden. Für jede dieser Buchungen wird in Casona eine Passantenrechnung erstellt und ggf. Zahlungen direkt zugewiesen.

Bitte beachten Sie, dass dies auch eine TSE-Aktion auslöst. Verwenden Sie diese Funktion nur, wenn die Gastrokasse selbst keine TSE-Funktionalität besitzt bzw. diese nicht verwendet wird.

Diese Schnittstelle wurde anhand der öffentlich zugänglichen ibelsa cashAPI-Spezifikation entwickelt. Es besteht keine offizielle Partnerschaft oder Freigabe durch die ibelsa GmbH.