Velofood-Standort mit bessa verbinden

Diese Anleitung beschreibt, wie Sie das Velofood-Konto eines Standorts mit bessa verbinden, damit Bestellungen automatisch zwischen beiden Systemen fließen.

Was Sie von Velofood erhalten

Für jeden Standort stellt Velofood zwei Werte bereit:

Velofood-Begriff	Beispiel	Was es ist

Velofood-Begriff	Beispiel	Was es ist
Venue ID (Lokal ID)	`c8731c9e-…-8348f59802df`	Die Kennung des Standorts auf Velofood-Seite. bessa erkennt daran, zu welchem Standort eine eingehende Bestellung gehört.
Secret	`zMo7…WrLi`	Ein gemeinsames Geheimnis, mit dem Nachrichten zwischen Velofood und bessa signiert und verifiziert werden.

Behandeln Sie das Secret wie ein Passwort — geben Sie es niemals in Tickets, Chats oder Dokumentationen weiter.

Wo diese Werte in bessa eingetragen werden

Die Integration liegt am Eintrag Third Party Service des Standorts (Typ = Velofood). Ordnen Sie die Werte wie folgt zu:

bessa-Feld	Einzutragender Wert

bessa-Feld	Einzutragender Wert
Service venue identifier (`external_id`)	die Venue ID (Lokal ID)
Service identifier (`chain_id`)	das Secret
Service venue api key (`api_key`)	der Velofood-API-Token — in der Regel dasselbe Secret, sofern Velofood keinen separaten Token vergeben hat
Username / Password	von Velofood nicht verwendet — einen beliebigen Platzhalter eintragen (z. B. `BESSA APP`)
Active	aktiviert lassen

[!NOTE]
Pro Standort wird genau ein Velofood-Eintrag angelegt. Der Standort muss zuvor das Modul „Third Party" (Product) aktiviert haben, sonst weist bessa die Einrichtung ab.

So funktioniert die Verbindung

Velofood → bessa (neue Bestellungen): Velofood ruft bessas Endpunkt …/velofood/notification/ auf, sobald eine Bestellung eingeht. Jeder Aufruf ist mit dem Secret signiert (im Header API-SIGNATURE) und enthält die Venue ID, sodass bessa den Absender verifizieren und die Bestellung dem richtigen Standort zuordnen kann.
bessa → Velofood (Annehmen / Ablehnen / Status): Wenn Mitarbeitende die Bestellung in bessa annehmen oder ablehnen, ruft bessa die Velofood-API mit dem API-Token auf, um die Lieferzeit zurückzumelden oder eine Ablehnung zu übermitteln.

Kurze Checkliste

Prüfen Sie, ob der Standort das Modul „Third Party" aktiviert hat.
Legen Sie den Third-Party-Service-Eintrag für Velofood mit Venue ID und Secret wie oben an.
Geben Sie eine Testbestellung in Velofood auf und prüfen Sie, ob sie in bessa erscheint.
Nehmen Sie die Bestellung in bessa an und prüfen Sie, ob sich der Status auf Velofood-Seite aktualisiert.

Häufige Fragen

Brauche ich pro Standort einen eigenen Velofood-Eintrag?
Ja. Pro Standort wird genau ein Velofood-Eintrag angelegt.

Sind Venue ID und Secret dasselbe wie der API-Token?
Die Venue ID identifiziert den Standort, das Secret signiert die Nachrichten. Der API-Token ist üblicherweise mit dem Secret identisch — es sei denn, Velofood hat Ihnen einen separaten Token bereitgestellt.

Was trage ich bei Username und Password ein?
Velofood nutzt diese Felder nicht. Tragen Sie einen beliebigen Platzhalter ein (z. B. BESSA APP).

Fehlerbehebung

Bestellungen kommen nicht an — Falsches oder abweichendes Secret (die Signaturprüfung schlägt fehl) oder der Eintrag ist inaktiv.
Bestellung kommt an, aber mit Fehler — Die Venue ID stimmt nicht mit dem „Service venue identifier" des Eintrags überein.
Annehmen/Ablehnen nicht möglich — Der API-Token (api key) fehlt oder ist falsch.