Schnittstellen und API für die Gastronomie

Vorhanden

Schnittstellen für die Gastronomie, die heute laufen

Diese Anbindungen arbeiten im Alltag von DevyPOS-Betrieben. Manche richten Sie selbst in den Einstellungen ein, andere übernimmt IT Saar per Fernwartung.

Hotelsoftware

Zahlart „Zimmer“ mit Mews und apaleo über deren Schnittstellen sowie über die Fidelio-Kassenschnittstelle (FIAS) mit Oracle Opera, protel, SIHOT, HS/3 und Gastrodat. Gast suchen, auf die Gästerechnung buchen, Storno gegenbuchen, Tagesabgleich. Ein Zusatzmodul.

Zahlungsanbieter

Stripe für Kartenzahlung im Webshop und am Kartenleser, PayPal im Webshop und die Gutscheinplattform gurado. Die Zugangsdaten Ihrer eigenen Konten hinterlegt IT Saar per Fernwartung.

Telefonanlage

Anruferkennung über den Anrufmonitor einer Fritzbox oder eine eigene SIP-Nebenstelle Ihrer Telefonanlage. Die Verbindung baut der Konnektor im Lokal auf; die Anlage muss nicht aus dem Internet erreichbar sein.

Drucker

Bon- und Küchendrucker spricht der Konnektor über ihre MAC-Adresse an, auch nach neuen IP-Adressen vom Router. Fällt ein Drucker aus, übernimmt der Hauptdrucker; ist der Konnektor offline, warten die Bons, bis er sich zurückmeldet.

Webshop-API-Schlüssel

Der eigene Webshop spricht über einen API-Schlüssel mit der Kasse. Angelegt wird er unter Einstellungen → Schnittstellen, nur während einer Fernwartung sichtbar, und genau einmal angezeigt; verlorene Schlüssel werden deaktiviert und neu angelegt.

Lieferplattformen

Das Modul für Wolt und Uber Eats wird Bestellungen direkt in die Kasse bringen, mit Küchenzettel und Beleg. Es ist fertig entwickelt und getestet; die Freischaltung durch die Plattformen steht noch aus.

So läuft die Anbindung an die Hotelsoftware

1. System wählen

Unter Einstellungen → Hotelsoftware wählen Sie Mews, apaleo oder die Fidelio-Kassenschnittstelle, bei FIAS zusätzlich den Hersteller. Das Hotel stellt AccessToken oder Client-ID und Client-Secret bereit; bei FIAS nennt der Hersteller Adresse, Port und Kassennummer im Hotelnetz.

2. Verbindung prüfen

Nach „Verbindung prüfen“ erscheint der Name des Hotels, und DevyPOS lädt Services, Buchhaltungskategorien und Steuercodes. Bei FIAS hält der Konnektor im Hotelnetz die Verbindung.

3. Buchung festlegen

Sie wählen das Buchungsziel und die Bezeichnung auf der Gästerechnung, legen Pauschalen wie Frühstück oder Halbpension fest und prüfen das mit „Gastsuche testen“. Zuletzt schalten Sie die Zahlart „Zimmer“ an der Kasse ein.

4. Abgleichen

Am Abend vergleicht der Tagesabgleich jeden Zimmer-Beleg mit den Buchungen laut Hotel: stimmt, fehlt im Hotel, Betrag weicht ab. Das Protokoll hält jede Buchung und Gegenbuchung mit Zeit und Ergebnis fest.

Auf Zimmer buchen: was die Anbindung im Betrieb kann

Im Hotelrestaurant zahlt der Gast selten an der Kasse. DevyPOS überträgt den Betrag auf seine Gästerechnung und stellt trotzdem einen Kassenbeleg mit Signatur aus.

Beim Kassieren wählt der Service die Zahlart „Zimmer (Hotel)“, gibt Zimmernummer oder Name ein und sieht die eingecheckten Gäste mit Abreisetag und Pauschale. Der Betrag erscheint im Hotel als Posten, wahlweise als eine Summe je Steuersatz oder Position für Position. DevyPOS bucht zuerst im Hotel und stellt erst nach dessen Bestätigung den Beleg aus.

Pauschalen: Frühstück, Halbpension, Vollpension oder All inclusive erkennt die Kasse am Raten- oder Produktnamen; enthaltene Positionen werden gekennzeichnet und auf Wunsch mit 0,00 € berechnet.
Storno: Ein Belegstorno bucht im Hotel automatisch gegen. Gelingt das ausnahmsweise nicht, bleibt der Storno gültig, und der Fall erscheint im Tagesabgleich.
Abgelehnte Buchung: Ist der Gast schon ausgecheckt oder die Verbindung weg, meldet die Kasse den Grund, und es entsteht kein Beleg.

Einstellungen → Hotelsoftware: verbunden und eingeschaltet, mit Buchungsziel und Bezeichnung auf der Gästerechnung.

Exporte

Exporte für Steuerberatung, Marketing und Datenübernahme

Was in der Kasse steht, kommt in Formaten heraus, mit denen Steuerberatung und Prüfung arbeiten.

DSFinV-K

Unter Berichte wählen Sie den Zeitraum und laden die Zip-Datei: Stammdaten, Bonköpfe, Positionen, Zahlarten und Umsatzsteuer je Abschluss. Das ist die Datei, die bei einer Kassennachschau verlangt wird.

DATEV (SKR04)

Ein Buchungsstapel im DATEV-Format mit den Tagesumsätzen je Z-Abschluss, unbaren Zahlarten als Geldtransit und den Handbuchungen des Kassenbuchs gegen das jeweilige Gegenkonto. Die Gegenkonten je Buchungsart tragen Sie direkt darunter ein.

CSV

Die Trefferliste des Marketing-Filters, etwa „90 Tage nicht bestellt“, lässt sich als CSV exportieren, gezählt nur mit passender Werbeeinwilligung. Im Filialverbund kommen die Verbund-Berichte über alle Standorte als CSV heraus.

Kundenimport

Bestehende Kundendaten übernehmen Sie in der Verwaltung unter „Kunden importieren (CSV)“. Dubletten führen Sie anschließend in der Verwaltung zusammen.

Eigene Anbindungen: was heute geht und was kommt

Heute gibt es den Webshop-API-Schlüssel, über den der eigene Webshop an die Kasse angebunden ist, sowie die Zugänge für Zahlungsanbieter und Hotelsoftware. Eine öffentliche API-Dokumentation für eigene Anbindungen ist in Vorbereitung; einen Termin nennen wir erst, wenn er steht. Wer heute ein bestimmtes System anbinden möchte, spricht uns an: Wir sagen offen, ob es über die vorhandenen Schnittstellen geht.

Häufige Fragen

Gibt es eine öffentliche API für eigene Anbindungen?

Noch nicht. Eine öffentliche API-Dokumentation ist in Vorbereitung. Heute läuft der eigene Webshop über einen API-Schlüssel, den IT Saar per Fernwartung anlegt; Hotelsoftware, Zahlungsanbieter, Telefonanlage und Drucker haben feste Anbindungen.

Welche Hotelsoftware lässt sich anbinden?

Mews und apaleo direkt über deren Schnittstellen, außerdem Oracle Opera, protel, SIHOT, HS/3 und Gastrodat über die Fidelio-Kassenschnittstelle (FIAS). Bei FIAS läuft der Konnektor auf einem Rechner im Hotelnetz; die Einrichtung erfolgt gemeinsam mit dem Hotel und dessen Hersteller. Die Hotelanbindung ist ein Zusatzmodul.

Kann ich Wolt oder Uber Eats an die Kasse anbinden?

Das Modul ist fertig entwickelt und getestet: Bestellungen werden direkt in der Kasse landen, mit Küchenzettel und Beleg. Die Freischaltung durch Wolt beziehungsweise Uber Eats steht noch aus; wann es bei Ihnen losgehen kann, sagen wir Ihnen im Gespräch. Eine Lieferando-Anbindung gibt es heute nicht, die Anfrage zum Partnerprogramm läuft.

Muss meine Telefonanlage aus dem Internet erreichbar sein?

Nein. Der Konnektor im Lokal baut die Verbindung auf, entweder zum Anrufmonitor der Fritzbox, der am Telefon einmalig mit #96*5* freigeschaltet wird, oder als SIP-Nebenstelle an Ihrer Telefonanlage. Die Kasse zeigt dann beim Klingeln den Kunden.

Wie sicher sind die hinterlegten Schlüssel?

Sie werden verschlüsselt gespeichert und nie wieder im Klartext angezeigt; der Bereich Schnittstellen ist nur während einer Fernwartung sichtbar. Die Zugangsdatei des Konnektors erzeugt beim erneuten Herunterladen einen neuen Schlüssel, der alte wird ungültig.