BookDetails
Represents the details of a hotel booking.
Properties
| Name | Type | Description |
|---|---|---|
| Status | BookStatus | The current status of the booking. |
| Reference | Reference | A collection of locators that identify the booking. |
| Reference/ClientLocator | String | The booking locator provided by the client.This is typically used to match the booking in the client's internal systems. |
| Reference/SupplierLocator | String | The booking locator provided by the supplier.This identifier is used to reference the booking in the supplier's system. |
| Reference/HotelLocator | String | The booking locator specific to the hotel, provided by the supplier. (Optional)This may be required in cases where the hotel system uses its own unique identifiers. |
| Holder | Holder | The personal details of the booking holder. |
| Holder/Name | String | The name of the holder. |
| Holder/SurName | String | The surname of the holder. |
| Holder/PersonalTitleType | PersonalTitleType | The personal title type of the holder. |
| Holder/ContactInfo | ContactInfo | The contact information of the holder. |
| Holder/ContactInfo/Email | String | The email address of the passenger. |
| Holder/ContactInfo/Phone | String | The phone number of the passenger. |
| Hotel | HotelDetail | The hotel details associated with the booking. |
| Hotel/BookingDate | String | The date when the booking was created. |
| Hotel/CheckIn | String | The check-in date for the booking. |
| Hotel/CheckOut | String | The check-out date for the booking. |
| Hotel/CheckInAsDateTime | String | The check-in date as a DateTime object. |
| Hotel/CheckOutAsDateTime | String | The check-out date as a DateTime object. |
| Hotel/HotelCode | String | The unique code identifying the hotel. |
| Hotel/HotelName | String | The name of the hotel associated with the booking. |
| Hotel/BoardCode | String | The board code for the booking. |
| Hotel/Occupancies | Array<BookOccupancy> | The collection of occupancies associated with the booking. |
| Hotel/Occupancies/OccupancyId | Integer | The unique identifier for the occupancy. |
| Hotel/Occupancies/Paxes | Array<BookPaxInput> | The collection of passenger inputs (paxes) for the occupancy. |
| Hotel/Occupancies/Paxes/Age | Integer | The age of the passenger. |
| Hotel/Occupancies/Paxes/Name | String | The first name of the passenger. |
| Hotel/Occupancies/Paxes SurName | String | The surname (last name) of the passenger. |
| Hotel/Occupancies/Paxes PersonalTitleType | PersonalTitleType | The personal title type of the passenger. |
| Hotel/Rooms | Array<Room> | The collection of rooms included in the booking. |
| Hotel/Rooms/OccupancyRefId | Integer | Numeric ID linking this room to its occupancy data in the Occupancy. |
| Hotel/Rooms/Code | String | Unique code assigned to this room. |
| Hotel/Rooms/Description | String | Description of the room's features or characteristics. |
| Hotel/Rooms/RoomPrice | RoomPrice | Pricing information for the room, including total price and currency details. |
| Hotel/Rooms/RoomPrice/Price | Price | The total price of the room. |
| Hotel/Rooms/RoomPrice/Price Currency | Currency | The currency of the price, represented in ISO 4217 format (e.g., USD, EUR). |
| Hotel/Rooms/RoomPrice/Price Binding | Boolean | Indicates whether the price is binding. |
| Hotel/Rooms/RoomPrice/Price Net | Double | The net price paid by the buyer to the seller. |
| Hotel/Rooms/RoomPrice/Price Gross | Double | The gross price, which includes the net price and the buyer's commission. |
| Hotel/Rooms/RoomPrice/Price NetSpecified | Boolean | Indicates whether the net price is explicitly specified. |
| Hotel/Rooms/RoomPrice/Price MinimumSellingPrice | Double | The minimum selling price. |
| Hotel/Rooms/RoomPrice PriceBreakdown | Array<PriceBreakdown> | Breakdown of the room price over specific periods, such as daily rates. |
| Hotel/Rooms/RoomPrice PriceBreakdown/Price | Price | The price for each day of the room during the specified period. |
| Hotel/Rooms/RoomPrice PriceBreakdown/Price/Currency | Currency | The currency of the price, represented in ISO 4217 format (e.g., USD, EUR). |
| Hotel/Rooms/RoomPrice PriceBreakdown/Price/Binding | Boolean | Indicates whether the price is binding. |
| Hotel/Rooms/RoomPrice PriceBreakdown/Price/Net | Double | The net price paid by the buyer to the seller. |
| Hotel/Rooms/RoomPrice PriceBreakdown/Price/Gross | Double | The gross price, which includes the net price and the buyer's commission. |
| Hotel/Rooms/RoomPrice PriceBreakdown/Price NetSpecified | Boolean | Indicates whether the net price is explicitly specified. |
| Hotel/Rooms/RoomPrice PriceBreakdown/Price MinimumSellingPrice | Double | The minimum selling price. |
| Hotel/Rooms/RoomPrice PriceBreakdown/Start | Integer | The starting day of the pricing period (inclusive). |
| Hotel/Rooms/RoomPrice PriceBreakdown/End | Integer | The ending day of the pricing period (inclusive). |
| Hotel/Rooms/Refundable | Boolean | Indicates if the room is refundable based on the cancellation policy. |
| Hotel/Rooms RefundableSpecified | Boolean | Indicates whether the refundable status has been explicitly specified. |
| Hotel/Rooms/LegacyRoomId | String | Legacy identifier for internal tracking. Automatically generated using OccupancyRefId and Code. |
| Hotel/Rooms/Units | Integer | Number of units available for this room type. |
| Hotel/Rooms/RatePlan | RatePlan | Rate plan associated with this room. |
| Hotel/Rooms/RatePlan/Code | String | The unique code for the rate plan. |
| Hotel/Rooms/RatePlan/Name | String | The name of the rate plan. |
| Hotel/Rooms/Promotions | Array<Promotion> | Promotions or discounts applicable to this room. |
| Hotel/Rooms/Promotions/Code | String | The unique code identifying the promotion. |
| Hotel/Rooms/Promotions/Name | String | The name of the promotion. |
| Hotel/Rooms/Remarks | Array<Remark> | Additional remarks or notes about this room. |
| Hotel/Rooms/Remarks/RemarkType | RemarkType | The type of the remark, categorized by RemarkType.This specifies the nature or purpose of the remark: Related to the hotel as a whole. Specific to the room being booked. Related to services provided by the accommodation. General remarks not tied to a specific entity. |
| Hotel/Rooms/Remarks/Text | String | The text content of the remark, providing details or additional notes.This can include supplier-specific instructions, conditions, or general information. |
| Hotel/Rooms/Surcharges | Array<Surcharge> | Additional surcharges applied to this room. |
| Hotel/Rooms/Surcharges ChargeType | ChargeType | Specifies whether the surcharge is included in the room rate or must be paid separately at the property. See ChargeType for possible values. |
| Hotel/Rooms/Surcharges Mandatory | Boolean | Indicates whether this surcharge is mandatory. Mandatory surcharges, such as government taxes, must always be paid, while optional surcharges may depend on the guest's preferences. |
| Hotel/Rooms/Surcharges Description | String | Provides a description of the surcharge, giving context about the type of cost it represents.Examples: "Tourist Tax", "Resort Fee", or "Additional Bed Fee". |
| Hotel/Rooms/Surcharges/Price | Price | Represents the price of this surcharge, including the amount and currency. See Price for details about the price structure. |
| Hotel/Rooms/Surcharges/Price Currency | Currency | The currency of the price, represented in ISO 4217 format (e.g., USD, EUR). |
| Hotel/Rooms/Surcharges/Price Binding | Boolean | Indicates whether the price is binding. |
| Hotel/Rooms/Surcharges/Price Net | Double | The net price paid by the buyer to the seller. |
| Hotel/Rooms/Surcharges/Price Gross | Double | The gross price, which includes the net price and the buyer's commission. |
| Hotel/Rooms/Surcharges/Price NetSpecified | Boolean | Indicates whether the net price is explicitly specified. |
| Hotel/Rooms/Surcharges/Price MinimumSellingPrice | Double | The minimum selling price. |
| Hotel/Rooms/Surcharges/Code | String | An optional code that uniquely identifies this surcharge for internal or external reference. This can be useful for tracking specific fees or integrating with supplier systems. |
| Hotel/Rooms/CancelPolicy | CancelPolicy | Cancellation policy specific to this room. |
| Hotel/Rooms/CancelPolicy Refundable | Boolean | Indicates whether the booking is refundable. |
| Hotel/Rooms/CancelPolicy CancelPenalties | Array<CancelPenalty> | A collection of penalties that apply if the booking is canceled. |
| Hotel/Rooms/CancelPolicy CancelPenalties/HoursBefore | Integer | Indicates the number of hours before the check-in date when the penalty becomes applicable. |
| Hotel/Rooms/CancelPolicy CancelPenalties/PenaltyType | PenaltyType | Specifies the type of penalty enforced upon cancellation. |
| Hotel/Rooms/CancelPolicy CancelPenalties/Currency | Currency | Specifies the currency in which the penalty value is expressed. |
| Hotel/Rooms/CancelPolicy CancelPenalties/Value | Double | Indicates the value of the penalty. |
| Hotel/Rooms/CancelPolicy CancelPenalties/Deadline | String | Specifies the absolute deadline for the penalty in UTC format. |
| Hotel/Rooms/CancelPolicy CancelPolicyDescription | String | Provides additional details or a textual summary of the cancellation policy. |
| Hotel/Rooms/Beds | Array<Bed> | List of beds available in the room, including types and configurations. |
| Hotel/Rooms/Beds/Type | String | The type of the bed. |
| Hotel/Rooms/Beds/Description | String | A description of the bed. |
| Hotel/Rooms/Beds/Count | Integer | The number of beds of this type in the room. |
| Hotel/Rooms/Beds/Shared | Boolean | Indicates whether the bed is shared. |
| Hotel/Rooms/Amenities | Array<Amenity> | Amenities included with this room, such as Wi-Fi or parking. |
| Hotel/Rooms/Amenities/Code | String | A unique code that identifies the amenity. |
| Hotel/Rooms/Amenities/Type | AmenityType | The type of the amenity, defined by AmenityType. |
| Hotel/Rooms/Amenities/Value | String | The value associated with the amenity. |
| Hotel/Rooms/Amenities/Texts | String | Additional textual information or description for the amenity. |
| Hotel/Rooms/UnitsSpecified | Boolean | Indicates whether the number of units has been explicitly specified. |
| Hotel/Rooms/Features | Array<Feature> | Features or custom attributes of the room, used for specific integrations. |
| Hotel/Rooms/Features/Code | String | The unique code identifying the feature of the room. |
| Price | Price | The total price of the booking. |
| Price/Currency | Currency | The currency of the price, represented in ISO 4217 format (e.g., USD, EUR). |
| Price/Binding | Boolean | Indicates whether the price is binding. |
| Price/Net | Double | The net price paid by the buyer to the seller. |
| Price/Gross | Double | The gross price, which includes the net price and the buyer's commission. |
| Price/NetSpecified | Boolean | Indicates whether the net price is explicitly specified. |
| Price/MinimumSellingPrice | Double | The minimum selling price. |
| CancelPolicy | CancelPolicy | The cancellation policy associated with the booking. |
| CancelPolicy/Refundable | Boolean | Indicates whether the booking is refundable. |
| CancelPolicy/CancelPenalties | Array<CancelPenalty> | A collection of penalties that apply if the booking is canceled. |
| CancelPolicy/CancelPenalties HoursBefore | Integer | Indicates the number of hours before the check-in date when the penalty becomes applicable. |
| CancelPolicy/CancelPenalties PenaltyType | PenaltyType | Specifies the type of penalty enforced upon cancellation. |
| CancelPolicy/CancelPenalties Currency | Currency | Specifies the currency in which the penalty value is expressed. |
| CancelPolicy/CancelPenalties Value | Double | Indicates the value of the penalty. |
| CancelPolicy/CancelPenalties Deadline | String | Specifies the absolute deadline for the penalty in UTC format. |
| CancelPolicy CancelPolicyDescription | String | Provides additional details or a textual summary of the cancellation policy. |
| Remarks | Array<Remark> | Additional remarks or notes related to the booking. |
| Remarks/RemarkType | RemarkType | The type of the remark, categorized by RemarkType.This specifies the nature or purpose of the remark: Related to the hotel as a whole. Specific to the room being booked. Related to services provided by the accommodation. General remarks not tied to a specific entity. |
| Remarks/Text | String | The text content of the remark, providing details or additional notes.This can include supplier-specific instructions, conditions, or general information. |
| BillingSupplierCode | String | The code of the agency responsible for the booking. |
| Payable | String | Information about the entity responsible for payment of the booking. |
| AddOns | Object | Additional metadata provided by the supplier for internal use. |