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
+test01being 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_testparameter and set it to1to 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
HotelDescriptiveContentNotifendpoint 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
HotelSummaryNotifendpoint.
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
HotelDescriptiveContentNotifendpoint or Property API. with the required legal entity ID. - Set property to open and bookable using the
HotelSummaryNotifendpoint.