Skip to main content
Description of the main flow used from mapping, to search, to booking.

Mapping Codes

Process of aligning supplier’s codes (rooms, transfer types, offers, etc.) into internal codes.

Mapping NBC

Process of aligning external hotel non bookable content with internal systems. This is typically done with:
  • OTA_HotelDescriptiveInfoRQ
    Used to retrieve hotel descriptions, images, amenities, and other metadata necessary for mapping hotel content.

Searching

Involves checking room availability and pricing for a given hotel and date range. This is handled through:
  • OTA_HotelAvailRQ
    Used to request availability and pricing information for hotels.

Booking

Booking a hotel room is a two-step process involving quoting and committing, both handled through the OTA_HotelResRQ message.

Quoting

Used to validate that the selected room is still available at the displayed price and conditions. This step ensures:
  • The room hasn’t been sold out.
  • The price hasn’t changed.
  • The cancellation and payment policies are still valid.
This is a non-binding operation and does not create a reservation yet. It’s often used to show final details to the user before confirming the booking.

Committing

Once the user confirms the booking, committing finalizes the reservation. This step:
  • Creates the actual booking in the supplier’s system.
  • Returns a confirmation number and booking details.
Both quoting and committing use the OTA_HotelResRQ message, but with different intent flags or parameters to distinguish between the two stages.

Cancelling

Cancelling a booking involves both quoting and committing stages. OTA_CancelRQ used to:
  • Quote cancellation terms.
  • Commit the cancellation of a booking.
Cancellation Scope
  • Supports full and partial cancellations.
  • Applies to any service booked via the XML interface.
Cancellation Fees
  • May apply if:
    • A non-refundable room was booked.
    • A cancellation policy is in effect.

Transfer

Transfers involve only searching, booking and cancellation, it has no NBC. Only codes need to be mapped:
  • Searching: Check availability and pricing for transfer services.
  • Booking: Quote and commit the transfer service.
  • Cancelling: Quote and commit the cancellation.

Excursion

Excursions follow the same flow as hotels:
  • Mapping: Align excursion content.
  • Searching: Check availability and pricing.
  • Booking: Quote and commit the booking.
  • Cancelling: Quote and commit the cancellation.