Skip to content

Selection and Booking Supplements

Room Supplements are additional services associated with respective rooms.
The supplements JSON array provides this list in the more-rooms service response.

Selection

To select supplements, the consumer must explicitly pass the supplement-keys of the desired supplements in the hotel-pre-book service request.

The hotel-pre-book service response will return the updated:

  • List of supplements available from among the consumer’s selection
  • Prices of the selected supplements that are available
  • netAmount inclusive of the cost of selected available supplements

Please note that it is not possible to change the selection of supplements after the hotel-pre-book service.
To modify the list of selected-supplements, the consumer must pass an updated list of selected supplement-keys in a new hotel-pre-book service.

Supplement Groups and Options

  • A single supplement object represents a single supplement option, identified by the optionId field.
  • Multiple supplement options may belong to the same supplement group, identified by the groupOptionId field.

Example:
Supplement Group: Return Transfer
-- Supplement Option 1: Return Seaplane Transfer
-- Supplement Option 2: Return Speed Boat Transfer

Consumers are free to choose & book multiple supplements belonging to different supplement groups, if permitted by the provider/supplier.
However, as of now, selecting more than one option within the same supplement group is not allowed.

Mandatory Supplements

Certain supplements are designated as mandatory, and the consumer must select them - identified by the isMandatory field. For example, in Maldives resort bookings, pre-booked transfers may be mandatory for entry into the country and must be booked prior to travel.

Required / DependentOn Supplements

In some cases, selecting a supplement requires booking another associated supplement.
These prerequisite supplement IDs are provided in dependentOnSupplementId, for example: [294_111, ABC_1]

Charge Type of Supplements

Included Supplements

These supplements can be identified by: type = "INCLUDED" and isIncluded = true

The cost of these supplements is already included in the room price.
Although they are included, it is recommended to still pass their supplement-key in the hotel-pre-book request. This ensures the consumer receives the latest information and pricing for the supplement.

Additional Supplements

These supplements can be identified by: type = "ADDITION"

These are not included in the room price & the consumer must explicitly select and book them.
These supplements are optional unless the isMandatory flag is set to true.

At-Property Supplements

These supplements can be identified by: type = "AT_PROPERTY"

These supplements are optional, not included in room pricing, and must be paid for directly at the hotel (offline).

Booking

To book the selected supplements, the consumer must explicitly pass the corresponding supplement-keys again in the hotel-book service request.

FlightDetails

If any supplement requires flight details (indicated by isFlightDetailsRequired = true in the hotel-pre-book response), the consumer must provide the flight details in the supplementBookingInfo object during booking.