Documentatie
difficulty level:
API - Hook - POST hook/booking/
Eingehender Hook, um eine Reservierung zu erstellen oder zu aktualisieren
POST hook/booking/
Verwendet für
Eingehender Hook, um eine Reservierung zu erstellen oder zu aktualisieren.
Authentifizierung
Der Benutzer muss auf Administratorebene angemeldet sein.
Berechtigung: entity_booking_update
Parameter
Diese Tabelle zeigt einige der Kernvariablen. Eine vollständige Übersicht finden Sie hier.
| Parameter | Beschreibung | Erforderlich | Ort | Beispiel |
|---|---|---|---|---|
| id | Die Reservierungs-ID | Nein * | Body | 15492 |
| object_id | Die Objekt-ID | Nein * | Body | 17 |
| date_from | Datum ab in ISO | Nein * | Body | 2018-02-13T11:30:00+0100 |
| date_till | Datum bis in ISO | Nein * | Body | 2018-02-13T11:30:00+0100 |
| number | Anzahl | Nein * | Body | |
| remarks | Bemerkungen | Nein | Body | |
| subchannel | Kanal, für Berichtszwecke | Nein | Body | hook |
| cust_id | Kunden-ID | Nein | Body | |
| Falls angegeben, wird versucht, den Kunden anhand der E-Mail zu finden | Nein | Body | ||
| external_id | Falls angegeben, wird eine Reservierung mit dieser externen ID gesucht | Nein | Body | |
| status_code | Falls angegeben, wird ein Statusübergang mit dem angegebenen Statuscode als Zielstatus durchgeführt | Nein | Body | 30 |
* Keine der Variablen ist primär erforderlich. Eine korrekte Kombination von Variablen ist jedoch erforderlich und bestimmt die auszuführende Aktion.
- Wenn "id" angegeben ist, wird die Reservierung mit den angegebenen Feldern aktualisiert.
- Wenn "id" nicht angegeben ist, aber "external_id" schon, wird die Reservierung mit dieser external_id aktualisiert.
- Wenn "id" und "external_id" nicht angegeben sind oder angegeben sind, aber nicht gefunden werden können, wird eine neue Reservierung erstellt.
- Beim Erstellen einer neuen Reservierung sind die Kernfelder erforderlich: "object_id", "date_from", "date_till", "number"
Beispiel
Reservierung erstellen.
POST api/rest/hook/booking/
Request
{
"object_id": 10,
"date_till": "2018-02-13T11:30:00+0100",
"date_from": "2018-02-13T09:30:00+0100",
"remarks": "",
"email": "info@teqa.nl",
"external_id": "3114hqq4rqsvlhgr8s66msvju9"
}
Response:
{
"id": "1126",
"object_id": 10,
"object": "Catharinadal",
"object_desc": "Catharinadal",
"date_from": "2018-02-13T09:30:00+0100",
"date_till": "2018-02-13T11:30:00+0100",
"number": 1,
"remarks": "",
"mainobject_desc": "Stats",
"mainobject_id": 5,
"fromtime": "09:30",
"tilltime": "11:30",
"status_code": "11",
"status": "In optie",
"customer_id": "460",
"customer": "Dhr. T. Ester",
"email": "info@teqa.nl",
"event_id": null,
"price": 0,
"currency": "EUR",
"custom06": "",
"custom07": "0",
"custom12_raw": null,
"custom12": ""
}
Reservierungsfelder werden hier angezeigt Übersicht der Reservierungsfelder
