Integrationen

Was im Reiter steht#

Im Dashboard unter Einstellungen, Reiter Integrationen, steht alles, was außerhalb von Flavoso mit deinem Betrieb arbeitet. Ganz oben zeigt eine Zeile auf einen Blick, was gerade verbunden ist.

Darunter steht je Anbindung eine Karte:

• Online-Zahlung: die Zahlungskonten, über die Gäste online bezahlen. Ab Pro.
• Bondrucker: ein Drucker in der Küche, der jede neue Bestellung als Zettel ausgibt. Ab Pro.
• Bestellungen per E-Mail: jede neue Bestellung zusätzlich an eine E-Mail-Adresse. In jedem Tarif.
• Verbundene Apps: Software, die mit deinem Betrieb arbeitet, etwa ein Kassensystem. In jedem Tarif.
• Eigene Webhooks für eigene Systeme. In jedem Tarif, nur für Inhaber.

Online-Zahlung#

In der Karte „Online-Zahlung“ verbindest du dein Zahlungskonto und schaltest es für Gäste ein. Das Geld geht direkt auf das Konto deines Betriebs, Flavoso ist nie Zahlungsempfänger. Online-Zahlung gehört zum Tarif Pro und darüber.

Wie das Verbinden Schritt für Schritt geht, steht im Kapitel „Zahlung“.

Bondrucker#

In der Karte „Bondrucker“ richtest du einen Drucker in der Küche ein, der jede neue Bestellung als Zettel ausgibt. Gebraucht wird ein Netzwerkdrucker mit Star CloudPRNT oder Epson Server Direct Print. Ab Pro.

Die Einrichtung im Einzelnen steht im Kapitel „Küchenbildschirm“ unter „Bondrucker statt Bildschirm“.

Bestellungen per E-Mail#

Jede neue Bestellung geht zusätzlich an eine E-Mail-Adresse, etwa an die der Küche. Das gibt es in jedem Tarif.

Die Adresse trägst du in der Karte „Bestellungen per E-Mail“ ein oder gleich im Einrichtungs-Assistenten. Online bezahlte Bestellungen gehen erst raus, wenn die Zahlung bestätigt ist.

Apps verbinden#

Jede Software kann sich über die offene Flavoso-API mit deinem Betrieb verbinden, wenn du zustimmst: ein Kassensystem, ein Liefer- oder ein Buchhaltungsprogramm. Ob ein bestimmtes System das unterstützt, weiß dessen Anbieter.

Der Weg beginnt in der anderen Software, und verbinden kann nur ein Inhaber des Betriebs. Einen Schlüssel zum Abtippen gibt es dabei nicht: du meldest dich an und stimmst zu.

Mit deinem Betrieb lässt sich eine App erst verbinden, wenn Flavoso sie geprüft und freigegeben hat. Dann trägt sie „Von Flavoso geprüft“. Bis dahin verbindet sie nur ihr Entwickler, und zwar mit seinem Test-Betrieb und mit Betrieben, in denen er selbst Inhaber ist.

Geprüfte Apps stehen im App-Verzeichnis: im Dashboard unter Einstellungen, Reiter Integrationen, und öffentlich auf flavoso.com/de/integrations. Verbunden wird trotzdem in der App selbst; das Verzeichnis führt dorthin.

Nach dem Verbinden bekommen alle Inhaber des Betriebs eine E-Mail: welche App, welcher Anbieter, welche Rechte, wer verbunden hat und wann. Darin steht der Knopf „Verbundene Apps verwalten“.

Eine App sieht nur den Betrieb, mit dem du sie verbunden hast, und nur das, wofür sie Rechte hat; die Liste steht unter der Anleitung. Bestellungen enthalten dabei keine E-Mail-Adresse des Gastes, die Telefonnummer nur bei Abholung und Lieferung und die Anschrift nur bei Lieferungen. Mit dem Verbinden beauftragst du Flavoso, der App diese Daten zu übermitteln. Für ihre eigene Verarbeitung ist ihr Anbieter selbst verantwortlich.

1. 1

   „Mit Flavoso verbinden“ wählen

   In der anderen Software. Wo genau das steht, sagt dir ihr Anbieter.

   In der anderen Software

2. 2

   Anmelden

   Mit deinem Flavoso-Konto. Hast du einen zweiten Faktor eingerichtet, wird er abgefragt.

   Bei Flavoso

3. 3

   Betrieb wählen

   Den Betrieb, mit dem die App arbeiten soll. Verbinden kannst du nur Betriebe, in denen du Inhaber bist.

4. 4

   Rechte lesen

   Der Bildschirm zeigt Logo, Name und Website der App und in Klartext, was sie darf. Freigegebene Apps tragen „Von Flavoso geprüft“.

5. 5

   Verbinden

   Ein Klick auf „Verbinden“, und es geht zurück in die andere Software. Fertig. „Abbrechen“ verbindet nichts.

• Bestellungen: sehen, oder annehmen, ablehnen, weiterschalten und ins eigene System übernehmen.
• Speisekarte: sehen, oder bearbeiten: Gerichte, Kategorien, Optionen, Preise und Ausverkauft.
• Betrieb: Öffnungszeiten, Status und Tische sehen, oder die Bestellannahme pausieren und Öffnungs- und Vorlaufzeiten ändern.
• Reservierungen: sehen, oder anlegen, bestätigen und ändern. Das wirkt erst ab Pro, wie die Reservierungen selbst, und der Bildschirm zum Zustimmen weist darauf hin.
• Umsätze: Umsatz- und Verkaufszahlen sehen.

Trennen#

Trennen kann ein Inhaber jederzeit: Einstellungen, Reiter Integrationen, Karte „Verbundene Apps“, Knopf „Trennen“, dann die Rückfrage bestätigen. Die App verliert sofort jeden Zugriff.

Die Inhaber bekommen darüber eine kurze E-Mail. Verbinden und Trennen stehen im Protokoll.

Auch die App selbst kann die Verbindung trennen. In der Handy-App siehst und trennst du verbundene Apps unter Mehr, Einstellungen, Integrationen.

Eigene Webhooks#

Für eigene Systeme oder Automatisierungsdienste gibt es eigene Webhooks: bei einem Ereignis, etwa einer neuen Bestellung, schickt Flavoso eine Nachricht an deine Adresse. Sie stehen unter Einstellungen, Reiter Integrationen, „Eigene Webhooks“, nur für Inhaber und in jedem Tarif.

Wie die Nachrichten aufgebaut sind und wie dein System die Signatur prüft, steht in der Entwickler-Dokumentation unter docs.flavoso.com/de/api, Seiten „Webhooks“ und „Signaturen prüfen“.

• Bis zu fünf Adressen. Jede nutzt https und muss öffentlich erreichbar sein, und je Adresse wählst du die Ereignisse.
• Jede Zustellung ist signiert (Kopf Flavoso-Signature, HMAC-SHA256). Daran erkennt dein System, dass sie wirklich von Flavoso kommt.
• Schlägt eine Zustellung fehl, versucht Flavoso es erneut: bis zu acht Versuche über knapp zwei Tage.
• Kommt 24 Stunden lang nichts an und scheitern mindestens zehn Versuche am Stück, wird die Adresse ausgeschaltet, und die Inhaber bekommen eine E-Mail.
• An jeder Adresse stehen das Protokoll der letzten Zustellungen und der Knopf „Testereignis senden“.

Eigene App entwickeln#

Eine eigene App legst du in der Entwickler-Konsole an: unter app.flavoso.com/de/developers oder im Dashboard über das Konto-Menü oben rechts, Eintrag „Entwickler-Konsole“. Dafür reicht ein Flavoso-Konto, ein eigener Betrieb oder ein Abo ist nicht nötig.

Beim ersten Besuch führt dich ein Einrichtungs-Assistent von der App über einen kostenlosen Test-Betrieb bis zur ersten Anfrage. Der Test-Betrieb ist ein Restaurant nur zum Ausprobieren der Schnittstelle, mit Beispielkarte und Tischen. In der Konsole unter „Test-Betrieb“ löst du Bestellungen und Reservierungen aus und schaltest sie weiter, wie es sonst die Küche tut. Deine App bekommt jede Änderung als Ereignis, auch per Webhook.

Andere Betriebe können deine App verbinden, sobald du sie zur Freigabe eingereicht und Flavoso sie geprüft und freigegeben hat. Alles Weitere für Entwickler steht in der Entwickler-Dokumentation unter docs.flavoso.com/de/api.