Use cases and best practices

In this section you can find use cases and best practices

This flow refers to using the API in its full capacity to do contracting for Accommodation Partners with Booking.com.

  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][creating-a-property] 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.][opening-a-property]

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][creating-a-property] with the required legal entity ID.
  5. Set property to open and bookable using the [HotelSummaryNotif endpoint.][opening-a-property]

This flow refers to the build first approach using the contracting feature.

→ To switch on the contracting feature, see the Accommodation Partner build first contracting flow feature on the feature management page. 1. Start building a new property using HDCN with the required ContractContactEmail, contact name, preferred language, and company name.
Booking.com sends email with a link to the contracting tool to the Accommodation Partner (AP). 2. Wait until the contract is signed.
Check the contract status at least once a day until AP signs the contract. 3. Set property to open and bookable using the [HotelSummaryNotif endpoint.][opening-a-property]