# Enhanced Shopping Transaction Response Message Format

| Element Path                                                    | Attribute                               | Occ                     | Type                      | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------------------------------- | --------------------------------------- | ----------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| HotelML/Head                                                    | <p><br></p>                             | 1                       | <p><br></p>               | This is the standard element containing some transaction metadata and any applicable errors or warnings.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| HotelML/Property                                                | <p><br></p>                             | 0..200                  | <p><br></p>               | Occurs once for each requested property or once per requested property that is available, depending on the value of RateCriteria/@ReturnUnavailable in the request message.                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | xml:lang                                | 0..1                    | Char                      | <p>Identifies the language of the response message that was returned by the hotel’s CRS.</p><p><br></p><p>The language will normally be the requested language or English if the requested language is not available. However, if the affiliate is configured to accept response messages with unmatched languages, RatGain will return the response to the affiliate in whichever language the hotel’s CRS has provided</p>                                                                                                                                                                                      |
| <p><br></p>                                                     | Code                                    | 1                       | Char                      | Chain and property code, separated by a semi-colon – e.g. “UI;AB1234”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><br></p>                                                     | DataOrigin                              | 0..1                    | Enum.                     | Indicates whether the response was generated from the UltraDirect transaction cache or the source (CRS). Values are: “Cache” or “Source”. Only returned Head/Route/@RequestedAccuracy is supplied in the request                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><br></p>                                                     | DataAge                                 | 0..1                    | <p>Date &</p><p>time</p>  | The date and timestamp of the response. If the response was generated from the cache then this is the timestamp of when it was added to the cache). The format is “2011-05-08T14:28:01.268-00:00”. Only returned Head/Route/@RequestedAccuracy is supplied in the request                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | Token                                   | 0..1                    | <p><br></p>               | Token generated by UltraDirect                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| HotelML/Property/Rate/RatePlan                                  | <p><br></p>                             | 0..M                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Code                                    | 1                       | Char 10                   | Rate plan code. Only returned when Status is “Open”. This code should be used for any subsequent transactions for this rate, such as PreBook & Rate Rules or Booking.                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><br></p>                                                     | RequestedRatePlanCode                   | 0..1                    | Char 10                   | <p>If the rate plan corresponds to a rate plan in the request message, the requested rate plan code is echoed back in this attribute.</p><p>For example, if rate plan “COR” was requested and it maps to rate plans “ABC” and “XYZ” in the CRS then one RatePlan may be returned with Code=“ABC” and RequestedRatePlanCode=“COR”, and another returned with Code=“XYZ” and RequestedRatePlanCode=“COR”.</p><p><br></p><p>In case of the negotiated rate plan mapped in the Account Author, the rate plan against the configured Negotiated rate plan code mapped will be returned.</p>                            |
| <p><br></p>                                                     | Status                                  | 1                       | Enum.                     | <p>The status of the rate plan. Values are: “Open” – rate plan is available</p><p>“Closed” – this is only returned for requested rate plans that are closed</p><p><br></p><p>“Unknown” – this is returned when the status of the requested rate plan is not known.</p>                                                                                                                                                                                                                                                                                                                                            |
| <p><br></p>                                                     | ClosedReason                            | 0..1                    | Enum.                     | <p>Optionally provides additional information if the Status is “Closed” or</p><p>“Unknown”:</p><p><br></p><p>“Unavailable” – rate plan code is valid but not available for the specified dates of stay etc.</p><p><br></p><p>“NotFound” – rate plan code is not found</p><p><br></p><p>“Restricted” – the requestor does not have access to the rate plan</p><p><br></p><p>“Unknown” – no additional information</p>                                                                                                                                                                                              |
| <p><br></p>                                                     | <p>Commissionable</p><p>Status</p>      | 0..1                    | Enum.                     | Specifies whether the rate is commissionable. Values are: “Commissionable”, “NonCommissionable” and “Unknown”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><br></p>                                                     | Description                             | 0..1                    | Char                      | Rate plan description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><br></p>                                                     | ExactMatch                              | 0..1                    | Boolean                   | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | InDate                                  | 0..1                    | Date                      | Arrival date, in format “2023-07-13”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><br></p>                                                     | OutDate                                 | 0..1                    | Date                      | Departure date in format “2023-07-16”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><br></p>                                                     | Indicator                               | 0..1                    | Enum.                     | <p>Rate plan type. Values are:</p><p><br></p><p>BusinessStandard, Consortium, Convention, Corporate, Credential, FreqAuto, FreqGuest, FreqFlyer, Government, IATA, Inclusive, Negotiated, Package, Privileged, PseudoCity, SearchQualifier</p>                                                                                                                                                                                                                                                                                                                                                                    |
| <p><br></p>                                                     | MarketingText1                          | 0..1                    | Char 63                   | The first line of marketing text                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><br></p>                                                     | MarketingText2                          | 0..1                    | Char 63                   | The second line of marketing text                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | CredentialsRequired                     | 0..1                    | Boolean                   | Indicates whether some form of credentials are required at check-in, such as a AAA ID card, Government card, or any other form of ID required to book a special rate.                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><br></p>                                                     | NonRefundableStay                       | 0..1                    | Boolean                   | Indicates whether the rate is non-refundable.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| HotelML/Property/Rate/RatePlan/Aut oInfo                        | <p><br></p>                             | 0..5                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Code                                    | 1                       | Char 25                   | Auto Frequent Traveler Number                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| HotelML/Property/Rate/RatePlan/CorpInfo                         | <p><br></p>                             | <p><br></p><p>0..1</p>  | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Code                                    | 1                       | Char 25                   | Corporate customer number                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| HotelML/Property/Rate/RatePlan/FlyerInfo                        | <p><br></p>                             | 0..5                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Code                                    | 1                       | Char 25                   | Frequent Flyer Number                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| HotelML/Property/Rate/RatePlan/FreqGuest                        | <p><br></p>                             | 0..1                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Code                                    | 1                       | Char 25                   | Frequent Guest Number                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| HotelML/Property/Rate/RatePlan/AdditionalDescription            | <p><br></p>                             | <p><br></p><p> 0..M</p> | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Code                                    | 1                       | Integer                   | Used to provide additional descriptive information where there are no specific fields elsewhere in the message.  All codes in the OpenTravl Alliance ADT code list are supported.                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | Text                                    | 0..1                    | Char                      | Descriptive text – type is specified by AdditionalDescriptionCode                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| HotelML/Property/Rate/RatePlan/RoomType                         | <p><br></p>                             | 0..M                    | <p><br></p>               | <p>Some hotel chains return multiple RatePlan elements, each containing multiple RoomType elements.</p><p><br></p><p>Other CRSs return multiple RatePlan elements each containing only a single RoomType element – i.e. the RatePlan is repeated for each combination of rate plan and room type.</p>                                                                                                                                                                                                                                                                                                             |
| <p><br></p>                                                     | BookableRate                            | 0..1                    | Decimal                   | The rate at which the room type may be booked                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><br></p>                                                     | CalculationMethod                       | 0..1                    | <p><br></p>               | <p>Specify how the BookableRate is calculated. It is only returned if a specific calculation method was requested, The method in the response should be the same as in the request but some CRSs may ignore the requested method. If the CRS does not specify the calculation method, this attribute will be omitted.</p><p><br></p><p>Valid values are:</p><p><br></p><p>“First” – rate for the first night</p><p>“Highest” – highest nightly rate</p><p>“Average” – average nightly rate</p><p>“Frequent” – most frequently occurring rate</p>                                                                  |
| <p><br></p>                                                     | Code                                    | 1                       | Char 10                   | Room type code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><br></p>                                                     | NativeRoomCode                          | 0..1                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | StandardRoomType                        | 0..1                    | Char 4                    | Marriott Only – HRS Room Type Code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><br></p>                                                     | CorpInfoRequired                        | 0..1                    | Boolean                   | Denotes if a corporate ID is required to book the room at the indicated rate.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><br></p>                                                     | ExclusiveRateToVend or                  | 0..1                    | Boolean                   | Denotes if the rate is exclusively available to a vendor.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | Indicator                               | 0..1                    | Enum.                     | Denotes the type of rate. "Privileged", "Corporate", "FreqGuest", "FreqFlyer", "FreqAuto", "Convention", "Negotiated", "BusinessStandard"                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | LimitedAvailability                     | 0..1                    | Boolean                   | Denotes if the room type has limited availability.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><br></p>                                                     | NativeCurrency                          | 0..1                    | Char 3                    | The native ISO currency code for the property                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><br></p>                                                     | NumberOfRooms                           | 0..1                    | Integer                   | The number of room types to be allocated                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><br></p>                                                     | RoomInventoryCount                      | 0..1                    | Integer                   | Number of available rooms at this rate.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><br></p>                                                     | RateChange                              | 0..1                    | Boolean                   | Denotes if the rate has changed                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>                                                     | RateForMultipleNights                   | 0..1                    | Boolean                   | Denotes if the rate is only available for multiple nights                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | RateFrequency                           | 0..1                    | Enum.                     | Denotes the frequency of the rate. "Daily", "Nightly", "Weekly", "Monthly", "PerStay", "Weekend"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><br></p>                                                     | RateOnRequest                           | 0..1                    | <p><br></p><p>Boolean</p> | <p><br></p><p>Denotes if the rate is only available on request.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | RoomName                                | 0..1                    | Char64                    | <p>Room name</p><p><br></p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><br></p>                                                     | RoomDescription                         | 0..1                    | Char                      | Textual description of the room.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><br></p>                                                     | RoomRateText                            | 0..1                    | Char                      | Textual description of the room rate.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><br></p>                                                     | TotalRate                               | 0..1                    | Decimal                   | The total rate for the room, including fees but excluding taxes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>                                                     | TotalRateInclusive                      | 0..1                    | Decimal                   | <p>The sum of nightly rates and taxes for the stay. Mutually exclusive with</p><p>TotalRateInclusiveCharges.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><br></p>                                                     | TotalRateInclusiveCha rges              | 0..1                    | Decimal                   | Total room rate inclusive of all known taxes, fees, and any extra charges. Only returned when transaction version is “Enhanced\_V1”.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><br></p>                                                     | TotalTaxes                              | 0..1                    | Decimal                   | Total tax amount.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | TotalSurcharges                         | 0..1                    | Decimal                   | Total Surcharges.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | TaxQualifier                            | 0..1                    | Enum.                     | Used to classify the bookable room rate. "AllInclusive", "NonInclusive", “Unknown”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><br></p>                                                     | RoomCategory                            | 0..1                    | Enum.                     | <p>Indicates the quality of the room. The following values are most commonly used:</p><p><br></p><p>Deluxe, Superior, Standard, Moderate, Economy, Premium</p><p><br></p><p>The attribute also supports the following values but these are generally not used in this context:</p><p><br></p><p>FirstClass, Budget, Upscale, Luxury, MeetingConvention, ResidentialApartment, Resort, CorporateBusinessTransient, AllSuite, ExtendedStay, Tourist, Efficiency</p>                                                                                                                                                 |
| <p><br></p>                                                     | RoomFloor                               | 0..1                    | <p>Integer</p><p><br></p> | <p>Floor number where the room is located</p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><br></p>                                                     | NumberOfBeds                            | 0..1                    | Integer                   | The number of beds per room.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><br></p>                                                     | BedType                                 | 0..1                    | Enum.                     | <p>Indicates the type of bed. Values:</p><p><br></p><p>Single, Twin, Double, King, Queen, Futon, MurphyBed, SofaBed, TatamiMats, Rollaway, Crib</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | NumberOfPayingGues tsPerRoom            | 0..1                    | Integer                   | Indicates the number of guests per room that are included in the price.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><br></p>                                                     | NumberOfChildren                        | 0..1                    | Integer                   | Number of guests that are classed as children by the hotel for pricing purposes (e.g. depending on their age).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><br></p>                                                     | <p>RateCategoryMatch</p><p>Type</p>     | 0..1                    | Enum.                     | <p>Values:</p><p><br></p><p>“Requested” – this rate is for the requested category</p><p><br></p><p>“Alternative” – this rate is not for the requested category</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><br></p>                                                     | <p>RoomCountMatch</p><p>Type</p>        | 0..1                    | Enum.                     | <p>Values:</p><p><br></p><p>“Available” – the number of rooms requested are available</p><p><br></p><p>“Unavailable” – the number of rooms requested are not available</p><p><br></p><p>“ExceedsMaximum” – the number of requested rooms exceeded the maximum allowed</p>                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | <p>AdultCountMatch</p><p>Type</p>       | 0..1                    | Enum.                     | <p>Values:</p><p><br></p><p>“Allowed” – the number of adults requested are allowed for the number of bedding types/rooms</p><p><br></p><p>“NotAllowed” – the number of adults requested is not allowed for the number of bedding types/rooms</p>                                                                                                                                                                                                                                                                                                                                                                  |
| <p><br></p>                                                     | <p>ChildCountMatch</p><p>Type</p>       | 0..1                    | Enum.                     | <p>Values:</p><p><br></p><p>“Allowed” - the number of adults requested are allowed for the number of bedding types/rooms</p><p><br></p><p>“NotAllowed” – the number of adults requested is not allowed for the number of bedding types/rooms</p>                                                                                                                                                                                                                                                                                                                                                                  |
| <p><br></p>                                                     | BedMatchType                            | 0..1                    | Enum.                     | <p>Values:</p><p><br></p><p>“Requested” – the number and type of beds requested are available</p><p><br></p><p>“Alternative” – a substitute has been offered for the requested number and type of beds</p><p><br></p><p>“Unknown” – the number and type of beds for this room is unknown</p>                                                                                                                                                                                                                                                                                                                      |
| <p><br></p>                                                     | AdultRollawayMatchType                  | 0..1                    | Enum.                     | <p>Values:</p><p><br></p><p>“Available” – the number of adult rollaway requested are available and included in the nightly rate</p><p><br></p><p>“Unavailable” – the number of adult rollaways requested is not available</p><p><br></p><p>“Unknown” – the number or availability of adult rollaway is unknown</p>                                                                                                                                                                                                                                                                                                |
| <p><br></p>                                                     | <p>ChildRollawayMatchT</p><p>ype</p>    | 0..1                    | Enum.                     | <p>Values:</p><p><br></p><p>“Available” – the number of child rollaway requested are available and included in the nightly rate</p><p><br></p><p>“Unavailable” – the number of child rollaway requested are not available</p><p><br></p><p>“Unknown” – the number or availability of child rollaways is unknown</p>                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | CribMatchType                           | 0..1                    | Enum.                     | <p>Values:</p><p><br></p><p>“Available” – the number of child rollaways requested are available and included in the nightly rate</p><p><br></p><p>“Unavailable” – the number of child rollaways requested are not available</p><p><br></p><p>“Unknown” – the number or availability of child rollaways is unknown</p>                                                                                                                                                                                                                                                                                             |
| <p>Property/Rate/RatePlan/RoomType/C</p><p>ommissionPolicy</p>  | <p><br></p>                             | 0..1                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Amount                                  | 0..1                    | Decimal                   | Commission payable expressed as a currency amount                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | Percentage                              | 0..1                    | Decimal                   | Commission payable expressed as a percentage of the booking value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Property/Rate/RatePlan/RoomType/GuaranteePolicy                 | <p><br></p>                             | 0..1                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | AcceptedCreditCard                      | <p><br></p><p>0..1</p>  | <p><br></p><p>Char</p>    | <p><br></p><p>List of credit card codes accepted for guarantee</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><br></p>                                                     | Required                                | 0..1                    | Boolean                   | Specifies whether a guarantee is required                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | HoldTime                                | 0..1                    | Time                      | The time (on the day of arrival) that the room will be held.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Property/Rate/RatePlan/RoomType/GuaranteePolicy/GuaranteeMethod | <p><br></p>                             | 0..M                    | <p><br></p>               | This element can occur once for each acceptable guarantee method.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | Code                                    | 1                       | Integer                   | Identifies the method accepted for guarantee. Values are from the OpenTravel Alliance (OTA) PMT Code List. For example, credit card is defined as Code="5".                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Property/Rate/RatePlan/RoomType/DepositPolicy                   | <p><br></p>                             | 0..1                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | AcceptedCreditCard                      | 0..1                    | Char                      | List of credit card codes accepted for deposit                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><br></p>                                                     | Time                                    | 0..1                    | Time                      | The time the deposit is required.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | Date                                    | 0..1                    | Date                      | The latest date that a deposit must be made. It can be used in conjunction with the existing Time attribute. If the Time attribute is specified without a Date then the day of arrival is assumed.                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><br></p>                                                     | TimeInterval                            | 0..1                    | <p><br></p>               | Used with IntervalUnits and optionally IntervalOffsetType to specify the number of days/weeks prior to arrival (or after booking) that the deposit is required.                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>                                                     | IntervalUnits                           | 0..1                    | Enum                      | Specifies the type of TimeInterval. Values are “Hours”, “Days”, “Weeks”, “Months”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | IntervalOffsetType                      | 0..1                    | Enum.                     | <p>Indicates whether the time interval (defined by the existing TimeInterval and IntervalUnits attribute) relates to the interval after the booking is made or before arrival (e.g. deposit is required X days after the booking was made or X days prior to arrival).</p><p><br></p><p>Values are: “BeforeArrival” and “AfterBooking”</p>                                                                                                                                                                                                                                                                        |
| <p><br></p>                                                     | Amount                                  | 0..1                    | Decimal                   | The deposit amount that is required by the deadline                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | Required                                | 0..1                    | Boolean                   | Indicates whether a deposit is required.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Property/Rate/RatePlan/RoomType/DepositPolicy/GuaranteeMethod   | <p><br></p>                             | 0..1                    | <p><br></p>               | This element can occur once for each acceptable deposit method.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>                                                     | Code                                    | 0..1                    | Integer                   | Identifies the method accepted for deposits. Values are from the OpenTravel Alliance (OTA) PMT Code List. For example, credit card is defined as Code="5" or "5.PMT”.                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Property/Rate/RatePlan/RoomType/PrePayPolicy                    | <p><br></p>                             | 0..1                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Time                                    | 0..1                    | Time                      | The time the prepayment is required.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><br></p>                                                     | Date                                    | 0..1                    | Date                      | The date by when the prepayment must be made. Can be used in conjunction with the existing Time attribute                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | TimeInterval                            | 0..1                    | <p><br></p>               | Used with IntervalUnits and optionally IntervalOffsetType to specify the number of days/weeks prior to arrival (or after booking) that the prepayment is required.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><br></p>                                                     | IntervalUnits                           | 0..1                    | Enum                      | Specifies the type of TimeInterval. Values are “Hours”, “Days”, “Weeks”, “Months”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | IntervalOffsetType                      | 0..1                    | Enum.                     | <p>Indicates whether the time interval (defined by the existing TimeInterval and IntervalUnits attributes) relates to the interval after the booking is made or before arrival (e.g. prepayment must be made X days after it was made or X days prior to arrival)</p><p><br></p><p>Values are: “BeforeArrival” and “AfterBooking”</p>                                                                                                                                                                                                                                                                             |
| <p><br></p>                                                     | Amount                                  | 0..1                    | Decimal                   | The prepayment amount that is required by the deadline                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><br></p>                                                     | Required                                | 0..1                    | Boolean                   | Indicates whether prepayment is required.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Property/Rate/RatePlan/RoomType/PrePayPolicy/GuaranteeMethod    | <p><br></p>                             | 0..M                    | <p><br></p>               | This element can occur once for each acceptable deposit method                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><br></p>                                                     | Code                                    | 0..1                    | Integer                   | Identifies the method accepted for deposits. Values are from the OpenTravel Alliance (OTA) PMT Code List. For example, credit card is defined as Code="5" or "5.PMT                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Property/Rate/RatePlan/RoomType/CancelPolicy                    | <p><br></p>                             | 0..M                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Description                             | 0..1                    | Char 990                  | <p>Cancel policy description – max 2 lines of 64 characters</p><p>990 character</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | Time                                    | 0..1                    | Time                      | The latest time that the reservation can be cancelled without incurring a penalty. This is normally on the day of arrival but can be on a specific date (if the Date attribute is also returned)                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><br></p>                                                     | Date                                    | 0..1                    | Date                      | The latest date that the booking can be cancelled in order to avoid any penalties. Can be used in conjunction with the existing Time attribute. If the Time is attribute is specified without a Date then the day of arrival is assumed.                                                                                                                                                                                                                                                                                                                                                                          |
| <p><br></p>                                                     | TimeInterval                            | 0..1                    | <p><br></p>               | Used with IntervalUnits and optionally IntervalOffsetType to specify the number of days/weeks prior to arrival (or after the booking) that it can be canceled without penalty.                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><br></p>                                                     | IntervalUnits                           | 0..1                    | Enum                      | Specifies the type of TimeInterval. Values are “Hours”, “Days”, “Weeks”, “Months”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | IntervalOffsetType                      | 0..1                    | Enum.                     | <p>Indicates whether the time interval (defined by the existing TimeInterval and IntervalUnits attributes) relates to the interval after the booking is made or before arrival (e.g. booking can be canceled X days after it was made or X days prior to arrival).</p><p><br></p><p>Values are: “BeforeArrival” and “AfterBooking”</p>                                                                                                                                                                                                                                                                            |
| <p><br></p>                                                     | PenaltyAmount                           | 0..1                    | Decimal                   | The cancellation penalty is expressed as a monetary amount.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | <p>PenaltyAmountTax</p><p>Indicator</p> | 0..1                    | Enum.                     | Indicates whether the penalty amount includes or excludes taxes. Values are: “Inclusive”, “Exclusive” and “Unknown”.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><br></p>                                                     | <p>PenaltyAmountFee</p><p>Indicator</p> | 0..1                    | Enum.                     | Indicates whether the penalty amount includes or excludes fees. Values are: “Inclusive”, “Exclusive” and “Unknown”.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | PenaltyNights                           | 0..1                    | Integer                   | This attribute can be used on its own to indicate the number of nights that will be charged if the reservation is canceled in the penalty period (e.g. PenaltyNights="1" indicates that 1 night will be charged). It can also be grouped together with the PenaltyPercentage and PercentageQualifier attributes if the cancel penalty is expressed as a percentage applied to a given number of nights (e.g. if the cancel penalty is 5% of 2 nights then PenaltyNights="2" and PenaltyPercentage="5.00" and PercentageQualifier="Nights").                                                                       |
| <p><br></p>                                                     | PenaltyPercentage                       | 0..1                    | Decimal                   | The cancellation penalty eis xpressed as a percentage. The associated PenaltyNights and PercentageQualifier indicate what this is a percentage of.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><br></p>                                                     | PercentageQualifier                     | 0..1                    | Enum.                     | <p>The qualifier indicates how the percentage is applied when determining the cancel penalty (e.g. if the cancel penalty is 30% of the first and last night’s stay then PenaltyPercentage="30.00" and PercentageQualifier= "FirstLast").</p><p><br></p><p>They can also be grouped together with the PenaltyNights if the cancel penalty is expressed as a percentage applied to a given number of nights (e.g. if the cancel penalty is 5% of 2 nights then PenaltyNights="2" and PenaltyPercentage="5.00" and PercentageQualifier="Nights").</p><p><br></p><p>Values are: “FullStay”, “FirstLast”, “Nights”</p> |
| HotelML/Property/Rate/RatePlan/RoomType/Amenity                 | <p><br></p>                             | <p><br></p>             | <p><br></p>               | This can repeat up to 6 times for amenities/services.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><br></p>                                                     | Code                                    | 1                       | Char 6                    | Amenity code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><br></p>                                                     | Quantity                                | 0..1                    | Integer                   | Amenity code quantity.  E.g. if the amenity code is for a meal plan then this defines the number of guests for which the meal plan applies.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Description                             | 0..1                    | Char30                    | Amenity Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | Confirmable                             | 0..1                    | Boolean                   | Indicates whether the amenity/service is confirmable                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><br></p>                                                     | ExtraCharge                             | 0..1                    | Boolean                   | Indicates whether there is an extra charge for the amenity/service                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><br></p>                                                     | OnRequest                               | 0..1                    | Boolean                   | Indicates whether the amenity/service is on request                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | Room                                    | 0..1                    | Boolean                   | Indicates this is a room-level amenity                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><br></p>                                                     | Property                                | 0..1                    | Boolean                   | Indicates this is a property-level amenity                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><br></p>                                                     | Inclusive                               | 0..1                    | Boolean                   | Indicates whether Room Rate is inclusive of this Extra charge.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><br></p>                                                     | ChargeApplication                       | 0..1                    | Enum.                     | Indicates how the Extra Charge is to be applied. Values are "PerRoomPerStay", "PerRoomPerNight", "PerPersonPerStay", "PerPersonPerNight"                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><br></p>                                                     | CurrencyCode                            | 0..1                    | Char 3                    | Charge currency code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><br></p>                                                     | AmountBeforeTax                         | <p><br></p><p>0..1</p>  | <p><br></p><p>Decimal</p> | Total Extra Charge Exclusive of Tax                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | AmountAfterTax                          | 0..11                   | Decimal                   | Total Extra Charge Inclusive of Tax                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Property/Rate/RatePlan/RoomType/RateChange                      | <p><br></p>                             | 1..10                   | <p><br></p>               | This can be returned if the nightly rate changes during the stay.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | Charge                                  | 1                       | Decimal                   | The room rate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><br></p>                                                     | CurrencyCode                            | 0..1                    | Char 3                    | Currency code of the room rate – will be in the same currency as the bookable room rate (i.e. RoomType/@NativeCurrency)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><br></p>                                                     | Frequency                               | 0..1                    | Enum.                     | Denotes the frequency of the rate. Will be the same frequency as the bookable rate (i.e. RoomType/@RateFrequency) –normally “Nightly”. Values are "Daily", "Nightly", "Weekly", "Monthly", "PerStay", "Weekend"                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>                                                     | Date                                    | 1                       | Date                      | The start of the date range for which the rate applies.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Property/Rate/RatePlan/RoomType/RateChange/ExtraCharge          | <p><br></p>                             | 0..M                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | AmenityCode                             | 1                       | Char 6                    | Amenity code which will lead to an Extra Charge                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>                                                     | Quantity                                | 0..1                    | Integer                   | Number of charges that apply                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><br></p>                                                     | ChargeDescription                       | 0..1                    | Char30                    | Amenity Description which will lead to an Extra Charge                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><br></p>                                                     | AmountBeforeTax                         | 0..1                    | Decimal                   | Daily Extra Charge exclusive of Tax                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | AmountAfterTax                          | 0..1                    | Decimal                   | Daily Extra Charge inclusive of Tax                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Property/Rate/RatePlan/RoomType/ExtraPerson                     | <p><br></p>                             | 1..2                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Type                                    | 1                       | Enum.                     | Values “Adult” and “Child”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><br></p>                                                     | Charge                                  | 1                       | Decimal                   | Charge for the extra adult or child                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Property/Rate/RatePlan/RoomType/ExtraBed                        | <p><br></p>                             | 1..3                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | Type                                    | 1                       | Enum.                     | Values “ChildRollAway”, “AdultRollAway”, “Crib”.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><br></p>                                                     | Charge                                  | 1                       | Decimal                   | Charge for the rollaway/crib.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Property/Rate/RatePlan/RoomType/TaxDetail                       | <p><br></p>                             | 0..M                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | EffectiveStartDate                      | 0..1                    | Date                      | The date that the tax is effective, if applicable. In format “2011-07-19”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | EffectiveEndDate                        | 0..1                    | Date                      | The date that the tax expires, if applicable. In format “2011-07-19”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><br></p>                                                     | Type                                    | 0..1                    | Enum.                     | Coded field identifying the type of tax. Values are: "StateTax", "CityTax", "CountyTax", "FederalTax", "SalesTax", "OccupancyTax", "BedTax", "ValueAddedTax", "Miscellaneous"                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><br></p>                                                     | Order                                   | 0..1                    | Integer                   | Indicates the order in which the tax should be applied when calculating the total amount.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | Basis                                   | 0..1                    | Enum.                     | Indicates whether the tax is independent of all other charges, or whether it is compounded, meaning it must be calculated against the sum of all previous charges as well as the room rate. Values are "Compound" and “Independent"                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | Unit                                    | 0..1                    | Enum.                     | <p>Indicates whether the tax is a flat amount or percentage. Values are</p><p>"Monetary" and "Percentage"</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><br></p>                                                     | Amount                                  | 1                       | Decimal                   | <p><br></p><p>The tax amount - expressed as a flat amount or percentage, depending on the value of Unit.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><br></p>                                                     | CurrencyCode                            | 0..1                    | Char 3                    | Tax currency code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | Application                             | 1                       | Enum.                     | Indicates how the tax is to be applied. Values are "PerRoomPerStay", "PerRoomPerNight", "PerPersonPerStay", "PerPersonPerNight"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>                                                     | Description                             | 0..1                    | Char 64                   | Tax description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>                                                     | Inclusive                               | 0..1                    | Boolean                   | Indicates whether it is inclusive of other taxes and fees                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Property/Rate/RatePlan/RoomType/FeeDetail                       | <p><br></p>                             | 0..M                    | <p><br></p>               | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><br></p>                                                     | EffectiveStartDate                      | 0..1                    | Date                      | The date that the fee is effective, if applicable. In format “2011-07-19”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | EffectiveEndDate                        | 0..1                    | Date                      | The date that the fee expires, if applicable. In format “2011-07-19”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><br></p>                                                     | Type                                    | 0..1                    | Enum.                     | Coded field identifying the type of Fee. Values are: "CityHotelFee", "Miscellaneous", "ResortFee", "Surcharge", "ServiceCharge", "MaintenanceFee", "EnergyCharge", "PackageRateFee"                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | Order                                   | 0..1                    | Integer                   | Indicates the order in which the fee should be applied when calculating the total amount.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><br></p>                                                     | Basis                                   | 0..1                    | Enum.                     | Indicates whether the fee is independent of all other charges, or whether it is compounded, meaning it must be calculated against the sum of all previous charges as well as the room rate. Values are "Compound" and “Independent"                                                                                                                                                                                                                                                                                                                                                                               |
| <p><br></p>                                                     | Unit                                    | 0..1                    | Enum.                     | Indicates whether the fee is a flat amount or percentage. Values are "Monetary" and "Percentage"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><br></p>                                                     | Amount                                  | 1                       | Decimal                   | The fee amount - expressed as a flat amount or percentage, depending on the value of Unit.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><br></p>                                                     | CurrencyCode                            | 0..1                    | Char 3                    | Fee currency code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br></p>                                                     | Application                             | 1                       | Enum.                     | Indicates how the fee is to be applied. Values are "PerRoomPerStay", "PerRoomPerNight", "PerPersonPerStay", "PerPersonPerNight"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>                                                     | Description                             | 0..1                    | Char 64                   | Fee description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>                                                     | Inclusive                               | 0..1                    | Boolean                   | Indicates whether it is inclusive of other taxes and fees                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.rategain.com/our-products/smart-distribution/multiavailability-enhanced-shopping-transaction/enhanced-shopping-est-detailed-rate-information/enhanced-shopping-transaction-response-message-format.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
