Use cases and best practices
In this section you can find use cases and best practices
Creating a test Accommodation Partner
To create a test Accommodation Partner, keep the following in mind:
The Contracting API uses a one-to-one relationship between the legal contact email address and the legal entity id. Therefore, for testing purposes you must use a different email address.
TIP You could attach a suffix to your legal contact email address, for example: johndoe+test01@gmail.com, with
+test01
being the suffix. Doing so results in any communication still being sent to the same email address, but the system recognising it as different. You should add a unique suffix each time you create a new test partner, but remember to add a+
sign before the suffix.Add the
is_test
parameter and set it to1
to correctly create a test Accommodation Partner.
Using legal entity ID first (API only)
This flow refers to using the API in its full capacity to do contracting for Accommodation Partners with Booking.com.
Building with legal entity ID
- Send legal details to Booking.com to create a legal entity ID.
- Find the legal entity ID immediately in the response body.
Booking.com sends email with a link to the contracting tool to the Accommodation Partner (AP). - Start building a new property using the
HotelDescriptiveContentNotif
endpoint with the required legal entity ID.
Check the contract status at least once a day until AP signs the contract. - Set property to open and bookable using the
HotelSummaryNotif
endpoint.
Building after contract is signed
- Send legal details to Booking.com to create a legal entity ID.
- Retrieve legal entity ID.
Booking.com sends email with a link to the contracting tool to the Accommodation Partner (AP). - Wait until the contract is signed.
Check the contract status at least once a day until AP signs the contract. - Start building a new property using the
HotelDescriptiveContentNotif
endpoint or Property API. with the required legal entity ID. - Set property to open and bookable using the
HotelSummaryNotif
endpoint.