Skip to main contentDescription 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.