Update bookings
Keep us informed
Bookings basics
- Only the base financial informations can be changed for existing bookings
- The booking update is asyncronous, so the changes are not visible immediately and can fail in the downstream systems
- You only need to push an update if the booking gets changed on your side
- If you use Holiday Payments, you do not need this endpoint, since the guest will directly approach Holidu Customer Happiness Team, which will then update you on the booking status.
Sometimes plans of travellers change, they might want to bring an extra guest, change the travel dates or even the apartment.
In order for Holidu to send you the correct invoice, you are asked to push us updates for those changes immediately with the query param in the endpoint being the id of the booking in your system, so we can update the according booking on our side.
Parameter | Type | Required | Usage |
---|---|---|---|
providerApartmentId | string | Yes | the id of the apartment in your system. Same as the id you pushed throught the apartment endpoint |
arrival | date | Yes | The arrival day of the traveller |
departure | date | Yes | The departure date of the traveller |
bareRentalPrice | Object | Yes | The cost object on which Holidu receives commission |
bareRentalPrice.amount | number | Yes | The amount on which Holidu receives commission |
bareRentalPrice.currency | string | Yes | The currency of the amount |
numberOfGuests | int32 | The number of guest present in the booking |
Example
{
"providerApartmentId": "123456",
"arrival": "2020-10-20",
"departure": "2020-10-30",
"bareRentalPrice": {
"amount": 100,
"currency": "EUR"
},
"numberOfGuests": 2
}
Only update booking for relevant changes
You only need to push updates to Holidu if some of the for Holidu relevant fields change and not if the traveller wants to e.g. bring an additional pet or book another optional extra.
Updated about 2 years ago