Reserveringsplatforms koppelen

Gebruik je naast BizzCloud een reserveringsplatform, zoals TheFork, Zenchef, Formitable, Guestplan, Quandoo of resmio? Dan kunnen de reserveringen van dat platform automatisch in BizzCloud komen: direct in de kassa en op het tafelplan. Het platform, of een koppeling via Zapier of Make, maakt, wijzigt en annuleert de reserveringen in BizzCloud.

Wat doet de koppeling?

Een nieuwe reservering op het platform staat binnen enkele seconden in de kassa, met het platform als bron.
Wijzigt de gast de reservering op het platform, dan wijzigt die ook in BizzCloud. Annuleert hij, dan wordt de reservering in BizzCloud geannuleerd. Een reservering van gasten die er al zijn, verandert niet meer.
BizzCloud controleert of de tafel op dat moment vrij is, met dezelfde controle als bij online reserveren. Geeft het platform geen tafel op, of is de tafel bezet, dan kiest BizzCloud zelf de kleinste vrije tafel of combinatie. Is er geen tafel vrij, dan blijft de reservering staan en zie je bij de reservering dat je er een tafel aan moet geven.
Heb je meerdere kassa's of bedrijven, dan komt de reservering bij de juiste kassa, in de tijdzone van je bedrijf.
Een arrangement dat de gast op het platform koos, komt mee als het dezelfde naam heeft als een arrangement in BizzCloud. Anders staat het in de notitie.

Een koppeling laten inrichten

De koppeling werkt met een geheime sleutel. BizzCloud richt de koppeling voor je in: neem contact op met BizzCloud support en vertel welk platform je gebruikt en voor welke kassa. Niet elk platform kan reserveringen zelf doorsturen; dan maken we de koppeling met Zapier of Make.

Voor wie de koppeling bouwt

De koppeling stuurt een POST naar https://<jouw BizzCloud>/pos/reservation/api/v1/reservations met de header X-Api-Key en een JSON-bericht. De sleutel staat in de instellingen van de kassa en is alleen zichtbaar voor BizzCloud.

source: het platform (thefork, zenchef, formitable, guestplan, quandoo, opentable, tablebooker, resmio of other) en external_ref: het nummer van de reservering op het platform. Stuurt de koppeling hetzelfde nummer nog eens, dan wordt de reservering gewijzigd.
config: de naam of het nummer van de kassa. Nodig als er meer dan één kassa met een tafelplan is.
guest_name, phone, email, guests, start (bijvoorbeeld 2026-12-24T19:00:00; zonder tijdzone geldt die van je bedrijf), duration (uren), note en allergies.
table of tables: de naam van de tafel(s), als het platform tafels kent.
arrangement (naam of nummer) of arrangements, bijvoorbeeld [{"name": "Kerstmenu", "guests": 2}].
state: cancelled annuleert de reservering.
on_conflict: wat er gebeurt als de opgegeven tafel bezet is. Standaard kiest BizzCloud een andere vrije tafel; keep houdt de tafel met een waarschuwing, reject weigert de reservering.

Het antwoord bevat per reservering onder meer de tafels, conflicts (dubbele boekingen), tables_changed en warnings. Met een GET op hetzelfde adres (met from, to en eventueel config) haal je de reserveringen op.

{
  "source": "guestplan",
  "external_ref": "GP-48213",
  "config": "Restaurant",
  "guest_name": "Sanne de Vries",
  "phone": "+31612345678",
  "start": "2026-12-24T19:00:00",
  "guests": 4,
  "arrangements": [{"name": "Kerstmenu", "guests": 2}, {"name": "Kindermenu", "guests": 2}]
}