Update bookings

Keep us informed

Bookings basics

• You can change the dates, the number of guests and the prices of a booking. A booking cannot be moved to another apartment.
• If Holidu has no booking with your providerBookingId, the same call creates it as a confirmed booking.
• The update is synchronous: the response is Holidu's copy of the booking after the update, so compare it with what you sent. An update in a currency other than the booking's original currency is ignored and still returns 200 with the unchanged booking.
• 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 or change the travel dates. A booking cannot be moved to another apartment: providerApartmentId must be the apartment the booking was made on, otherwise the call returns 400 Requested apartmentId does not match booking's apartmentId.

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.

Bookings Holidu does not know yet

If Holidu has no booking with this providerBookingId for your account, the call creates one: a confirmed booking on providerApartmentId, with the time of the call as its booking date. Holidu calculates its commission on it like on any other booking, so push only bookings that came through Holidu. Later updates and cancellations use the same providerBookingId.

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

BookingUpdate

{
     "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.