Naar de inhoud

Boekingen

Boekingen aanmaken en bijwerken in het WaW-account van een klant.

Updated Bekijk als markdown

Een boeking aanmaken

POST /v1/bookings

Veld Type Verplicht Opmerkingen
external_id string, max 128 Ja Je eigen ID voor deze boeking. Uniek per klantteam.
name string, max 300 Ja
start_date datum-tijd Ja Zie Datums.
location string, max 1.000 Ja
end_date datum-tijd of null Nee Moet na start_date liggen.
contact_id WaW-contact-ID of null Nee Stelt het hoofdcontact in. Het contact moet in hetzelfde team zitten.
status string Nee Zie Statussen. Standaard draft.
lost_reason string, max 1.000, of null Nee Verplicht wanneer status lost is.
{
  "external_id": "booking-8421",
  "name": "Huwelijk Noor en Sam",
  "start_date": "2027-06-12T16:00:00+02:00",
  "end_date": "2027-06-13T02:00:00+02:00",
  "location": "Gent",
  "status": "confirmed"
}

Antwoord: 201 Created

{ "id": "3f1e9a2b-5c4d-4e6f-8a7b-9c0d1e2f3a4b", "external_id": "booking-8421" }

Stuur je dezelfde aanvraag opnieuw, dan krijg je 200 met dezelfde ID’s. Er komt geen dubbel record. Zie Opnieuw proberen.

Een boeking bijwerken

PATCH /v1/bookings/{id}

Gebruik de WaW-id uit het antwoord bij het aanmaken. Stuur alleen de velden die je wil wijzigen. Je kunt elk veld uit de tabel hierboven sturen, behalve external_id.

{ "location": "Brugge", "status": "confirmed" }

Antwoord: 200 OK

{ "id": "3f1e9a2b-5c4d-4e6f-8a7b-9c0d1e2f3a4b", "updated": true }
  • Velden die je weglaat, blijven zoals ze zijn.
  • null maakt een optioneel veld leeg.
  • De laatste geslaagde wijziging wint. Past de klant hetzelfde veld aan in WaW, dan overschrijft jouw volgende wijziging het.

Statussen

WaW heeft drie statussen: draft (de standaard), confirmed en lost. Dat zijn de boekingsstatussen die de klant in WaW ziet.

lost heeft een niet-lege lost_reason nodig. Zet je een boeking van lost naar een andere status, dan wordt de lost_reason gewist. cancelled is geen geldige status; gebruik lost met een reden.

Datums

Datums volgen RFC 3339, met seconden en een tijdzoneverschil, bijvoorbeeld 2027-06-12T16:00:00+02:00. Een datum zonder tijd, of een tijd zonder tijdzoneverschil, geeft 422.

Goed om te weten

  • Maak eerst het contact aan, en geef daarna de WaW-ID mee als contact_id.
  • Automatisaties die de klant heeft ingesteld voor nieuwe boekingen lopen gewoon.
Navigatie

Type to search…

↑↓ navigate↵ selectEsc close