Use cases and best practices

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

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:

1. 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.

2. Add the is_test parameter and set it to 1 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

1. Send legal details to Booking.com to create a legal entity ID.
2. 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).
3. 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.
4. Set property to open and bookable using the HotelSummaryNotif endpoint.

Building after contract is signed

1. Send legal details to Booking.com to create a legal entity ID.
2. Retrieve legal entity ID.
   Booking.com sends email with a link to the contracting tool to the Accommodation Partner (AP).
3. Wait until the contract is signed.
   Check the contract status at least once a day until AP signs the contract.
4. Start building a new property using the HotelDescriptiveContentNotif endpoint or Property API. with the required legal entity ID.
5. Set property to open and bookable using the HotelSummaryNotif endpoint.