This transaction set is used to request actual available rates and rooms at multiple hotels (Note - up to a max of 200 properties in one request). All hotel CRSs support this transaction.
Demand Partner to insert their agency (TIDS, IATA, or CLIA)
Demand Partner to insert assigned Source Code (SGA) of XX
Property IDs are obtained from the property list from the PDS site and are inserted into requests with brand code and property ID separated by a semi-colon. MC;LONCH–Brandcode“MC”,propertyID“LONCH”
Add RequestedAccuracy="CacheOrSource to these requests so we can identify from where the response is received (Either RateGain Cache or direct from hotel source).
200 properties can be sent in one RateGain recommends sending less than 200 based on the strategy guidelines provided by implementer.
GuestCount is per room.
Standard EST Response:
<HotelML xmlns="
http://www.xpegs.com/v2001Q3/HotelML
">
<Head>
<Route Destination="XX" Source="00">
<Operation Action="Create" App="UltraDirect-ud_instance_1" AppVer="V1_1" DataPath="/HotelML" StartTime="2015-04- 17T10:11:41.635+00:00" Success="true" TotalProcessTime="15"/>
</Route>
</Head>
<Property xml:lang="en" AvailabilityStatus="Open" Code="MC;LONCH" Token="1285940187599">
<Rate>
<RatePlan Code="D00" CommissionableStatus="Commissionable" Description="Advance Purchase rate, prepay in full, see Rate Rules" InDate="2016-06-20" MarketingText1="All rates are quoted inclusive of VAT." OutDate="2016-06-21">
<RoomType BookableRate="293.00" Code="APN" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="Deluxe Room, 1 King, 30sqm/323sqft-45sqm/484sqf t, Wireless Internet for a fee, Wired Internet for a fee, Coffee/tea maker, 32in/81cm LCD TV" StandardRoomType="GENR" TotalRate="293.00" TotalRateInclusive="293.00">
<DepositPolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="AfterBooking" PenaltyAmountTaxIndicator="Unknown" PenaltyAmountFeeIndicator="Unknown"/>
</RoomType>
</RatePlan>
<RatePlan Code="B00" CommissionableStatus="Commissionable" Description="Best Available rate" InDate="2016- 06-20" MarketingText1="All rates are quoted inclusive of VAT." OutDate="2016-06-21">
<RoomType BookableRate="395.00" Code="REG" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="River Thames View Room, 1 King or 2 Double, 30sqm/323sqft-45sqm/484sqft, Wireless Internet for a fee, Wired Internet for a fee, Coffee/tea ma" StandardRoomType="SRPM" TotalRate="395.00" TotalRateInclusive="395.00">
<GuaranteePolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="BeforeArrival" PenaltyAmount="395.00" PenaltyAmountTaxIndicator="Exclusive" PenaltyAmountFeeIndicator="Unknown" PenaltyNights="1" PercentageQualifier="Nights"/>
</RoomType>
</RatePlan>
<RatePlan Code="H00" CommissionableStatus="Commissionable" Description="Best Available rate" InDate="2016- 06-20" MarketingText1="All rates are quoted inclusive of VAT." OutDate="2016-06-21">
<RoomType BookableRate="425.00" Code="REG" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="Executive Big Ben View Room, Executive Lounge Access, 1 King or 2 Double, 30sqm/323sqft-45sqm/ 484sqft, Wireless Internet for a fee, Wired Int" StandardRoomType="BBEV" TotalRate="425.00" TotalRateInclusive="425.00">
<GuaranteePolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="BeforeArrival" PenaltyAmount="425.00" PenaltyAmountTaxIndicator="Exclusive" PenaltyAmountFeeIndicator="Unknown" PenaltyNights="1" PercentageQualifier="Nights"/>
</RoomType>
</RatePlan>
<RatePlan Code="L00" CommissionableStatus="Commissionable" Description="Leisure Rate - Be Your #WeekendSelf, see Rate Rules" InDate="2016-06-20" MarketingText1="All rates are quoted inclusive of VAT." OutDate="2016- 06-21">
<RoomType BookableRate="435.00" Code="UKE" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="Deluxe Room, 2 Double, Wireless Internet for a fee, Wired Internet for a fee, Coffee/tea maker, 40in/102cm TV" StandardRoomType="DBDB" TotalRate="435.00" TotalRateInclusive="435.00">
<GuaranteePolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="BeforeArrival" PenaltyAmount="435.00" PenaltyAmountTaxIndicator="Exclusive" PenaltyAmountFeeIndicator="Unknown" PenaltyNights="1" PercentageQualifier="Nights"/>
</RoomType>
</RatePlan>
<RatePlan Code="I00" CommissionableStatus="Commissionable" Description="Leisure Rate - Be Your #WeekendSelf, see Rate Rules" InDate="2016-06-20" MarketingText1="All rates are quoted inclusive of VAT." OutDate="2016- 06-21">
<RoomType BookableRate="455.00" Code="UKE" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="Executive Big Ben View Room, Executive Lounge Access, 1 King or 2 Double, 30sqm/323sqft-45sqm/ 484sqft, Wireless Internet for a fee, Wired Int" StandardRoomType="BBEV" TotalRate="455.00" TotalRateInclusive="455.00">
<GuaranteePolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="BeforeArrival" PenaltyAmount="455.00" PenaltyAmountTaxIndicator="Exclusive" PenaltyAmountFeeIndicator="Unknown" PenaltyNights="1" PercentageQualifier="Nights"/>
</RoomType>
</RatePlan>
<RatePlan Code="D00" CommissionableStatus="Commissionable" Description="Best Available rate" InDate="2016- 06-20" MarketingText1="All rates are quoted inclusive of VAT." OutDate="2016-06-21">
<RoomType BookableRate="465.00" Code="REG" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="Executive Big Ben View, 1 King or 1 Queen, Living/sitting area, Wireless Internet, complimentary, Wired Internet, complimentary, Coffee/tea m" StandardRoomType="KWTV" TotalRate="465.00" TotalRateInclusive="465.00">
<GuaranteePolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="BeforeArrival" PenaltyAmount="465.00" PenaltyAmountTaxIndicator="Exclusive" PenaltyAmountFeeIndicator="Unknown" PenaltyNights="1" PercentageQualifier="Nights"/>
</RoomType>
</RatePlan>
<RatePlan Code="I00" CommissionableStatus="Commissionable" Description="Best Available rate" InDate="2016- 06-20" MarketingText1="All rates are quoted inclusive of VAT." OutDate="2016-06-21">
<RoomType BookableRate="645.00" Code="REG" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="Junior Suite, 1 King or 1 Queen, Sofa bed, 30sq m/323sqft-45sqm/484sqft, Living/sitting area, Wireless Internet, complimentary, Wired Internet" StandardRoomType="EXVR" TotalRate="645.00" TotalRateInclusive="645.00">
<GuaranteePolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="BeforeArrival" PenaltyAmount="645.00" PenaltyAmountTaxIndicator="Exclusive" PenaltyAmountFeeIndicator="Unknown" PenaltyNights="1" PercentageQualifier="Nights"/>
</RoomType>
</RatePlan>
<RatePlan Code="N00" CommissionableStatus="Commissionable" Description="Advance Purchase rate, prepay in full, see Rate Rules" InDate="2016-06-20" MarketingText1="All rates are quoted inclusive of VAT." OutDate="2016-06-21">
<RoomType BookableRate="793.00" Code="APN" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="Balcony Suite with View over the River Thames and Big Ben, Executive Lounge Access, 1 King, 40 sqm/430sqft-50sqm/538sqft, Living/sitting area," StandardRoomType="STWD" TotalRate="793.00" TotalRateInclusive="793.00">
<DepositPolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="AfterBooking" PenaltyAmountTaxIndicator="Unknown" PenaltyAmountFeeIndicator="Unknown"/>
</RoomType>
</RatePlan>
<RatePlan Code="F00" CommissionableStatus="Commissionable" Description="Best Available rate" InDate="2016- 06-20" MarketingText1="All rates are quoted inclusive of VAT." OutDate="2016-06-21">
<RoomType BookableRate="845.00" Code="REG" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="Balcony Suite with View over the River Thames and Big Ben, Executive Lounge Access, 1 King, 40 sqm/430sqft-50sqm/538sqft, Living/sitting area," StandardRoomType="STWD" TotalRate="845.00" TotalRateInclusive="845.00">
<GuaranteePolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="BeforeArrival" PenaltyAmount="845.00" PenaltyAmountTaxIndicator="Exclusive" PenaltyAmountFeeIndicator="Unknown" PenaltyNights="1" PercentageQualifier="Nights"/>
</RoomType>
</RatePlan>
<RatePlan Code="G00" CommissionableStatus="Commissionable" Description="Best Available rate, prepay in full, non-refundable, no changes" InDate="2016-06-20" MarketingText1="All rates are quoted inclusive of VAT." OutDate="2016-06- 21">
<RoomType BookableRate="2500.00" Code="REG" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="Presidential Suite with View of the River Thames and Big Ben, Executive Lounge Access, 1 King, Microwave, 135sqm/1453sqft, Dining area, Livin" StandardRoomType="PRES" TotalRate="2500.00" TotalRateInclusive="2500.00">
<DepositPolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="AfterBooking" PenaltyAmountTaxIndicator="Unknown" PenaltyAmountFeeIndicator="Unknown"/>
</RoomType>
</RatePlan>
</Rate>
</Property>
<Property xml:lang="en" AvailabilityStatus="Open" DataAge="2015-04-16T09:47:23.842+00:00" DataOrigin="Cache" Code="TP;043241" Token="1285940187599">
<Rate>
<RatePlan Code="A0B" CommissionableStatus="NonCommissionable" Description="NonRefundable Rate Excludes Breakfast / No Cancellation Allowed" InDate="2015-06-20" Indicator="BusinessStandard" MarketingText1="TOP Hotels - Your choice for Europe" OutDate="2015- 06-21">
<RoomType BookableRate="82.65" Code="A07" NativeCurrency="USD" RateFrequency="Daily" RoomDescription="Apartment Double or Twin/ 38sqm/ Mini Bar/ Cable-TV/ Safe/ Full Kitchnette/ Private Bath/ Bath Tub/ Hair Dryer For Up To 4" TotalRate="82.65" TotalRateInclusive="82.65">
<DepositPolicy Required="true"/>
<CancelPolicy Description="No cancel allowed."/>
<Amenity Code="MP" ExtraCharge="true" OnRequest="true" Room="true"/>
<Amenity Code="SMOKE" Confirmable="true" Room="true"/>
</RoomType>
</RatePlan>
</Rate>
</Property>
</HotelML>
BookableRate: rate per room per night (may or may not include taxes). Based on CRS, this rate may be the first night average, highest, or most frequent nightly.
TotalRate and TotalRateInclusive represent the per-room total for all nights.
BookableRate and TotalRate values may or may not include taxes and service TotalRateInclusive values include all taxes and service charges. TotalRateInclusive minus TotalRate equals Total Taxes not included in rate.
All rates are per room (Important to note if multiple rooms are requested).
Marriott (MC) also returns penalty information in this response, but not all chains support this.
Public rates have been returned for all hotels – note that some are deposit rates - <DepositPolicyRequired="true"/> this is important to note for the guarantee type value that needs to be sent in the booking request.
Rate Change Response Examples
The ReturnRateChanges="true” value in the initial request will trigger the response to contain the actual RateChanges if the hotel supports the functionality.
Example response extract if the chain supports this:
RateChange Charge values may or may not include taxes and service charges.
During a rate change period, the first rate change is the rate that is in effect until the next date is specified and remains in effect until the next date is specified.
Average rate can be calculated by dividing either the TotalRateInclusive or TotalRate by the number of nights based on whether you wish to display the final nightly cost or the nightly cost before taxes.
If a chain does not support this functionality in the availability response, but rate changes do occur during the stay the indicator RateChange="true" is returned but with no rate listing – full rate change information is provided in the rate rules response.
Meal Plans in EST
Meal Plan Information may be returned in the EST responses (not all chains will return this information):
<Amenity Code="BRKFST" Confirmable="true" Room="true"/> Breakfast included in rate.
<Amenity Code="BRKFST" Confirmable="true" ExtraCharge="true" Room="true"/> Breakfast not included, extra cost.
<Amenity Code="BRKFST" OnRequest="true" Room="true"/> On Request and complimentary.
<Amenity Code="BRKFST" ExtraCharge="true" OnRequest="true"/> On Request with cost.
<Amenity Code="BRKFST" Room="true"/> If this is returned, we would suggest you check with the hotel chain for clarification of exactly what is on offer.
Please also note the meal plan codes can be returned at both RatePlan and RoomType level. It is important to code for both scenarios as shown below.
Marriott example:
<RatePlan Code="DUQC" CommissionableStatus="NonCommissionable" Description="Dyn Bdld Brkfast For 2, Bed & Breakfast Rate, see Rate Rules" InDate="2019-01-10" MarketingText1="Rates include VAT. Reservations required for Gillray's Steakhous" OutDate="2019-01-11" RequestedRatePlanCode="GT2" Status="Open">
<Amenity Code="BRKFST" Confirmable="true" Room="true"/>
<CorpInfo Code="DN2"/>
<RoomType BookableRate="260.00" Code="GENR" NativeCurrency="GBP" RateFrequency="Daily" RoomDescription="Deluxe Room, 1 King, 30sqm/323sqft-45sqm/484sqf t, Wireless internet, for a fee, Wired internet, for a fee, Coffee/tea maker, 32in/81cm LCD TV" StandardRoomType="GENR" TotalRate="260.00" TotalRateInclusive="260.00">
<GuaranteePolicy Required="true"/>
<CancelPolicy IntervalUnits="Days" TimeInterval="1" IntervalOffsetType="BeforeArrival" PenaltyAmount="260.00" PenaltyAmountTaxIndicator="Exclusive" PenaltyAmountFeeIndicator="Unknown"/>
</RoomType>
</RatePlan>
Demand Partner will have agreements in place with the hotel chains regarding which negotiated rates will be available.
The hotel chains will inform Demand Partner which method to use to request the rates via For chains that use the Negotiated Rate Management Tool (Account Author) the distributor will use a “Negotiated” RatePlanType and for others use a “Corporate” RatePlanType.
It may be necessary for EST Negotiated rates requests to be separated by chain.
It is possible to request multiple codes from one chain (if they are offering you more than one net rate), generally a maximum of 3-15 negotiated rate codes per transaction depending upon the CRS.
Demand Partner to parse the response to identify the negotiated rates 3 Negotiated Rates – 1XX, A0Z and A1C were returned as available.
The returned rate plan code will not always be the same as the requested rate plan code.
RequestedRatePlanCode="1XX" Status="Open"> is returned by this particular CRS but not all CRSs will return this.
If MatchingQualifier value is left out or set to “ExactAndPublic”, both negotiated rates and public rates are If Demand Partner only wants their negotiated rates returned; for chains that support this, MatchingQualifier=”Exact” could be included in the EST request:
If Demand Partner wants BOTH Negotiated OR Public, they can use ExactOrPublic which will return public rates if the negotiated rate plan is not available.
Requests for multiple rooms
There are two ways to request and book multiple rooms, depending on the room configuration;
If the room configuration is the same for all rooms, for example two rooms with 2 adults in each room send EST, Rate rules and booking requests for 2 adults with NumberOfRooms=”2”, as below.
Rate rules and booking requests would include the same values as above (2 adults/2 rooms).
If the room configuration is different, for example one room with 1 adult and one room with 2 adults, a separate request must be sent for each configuration as shown below:
In the same way you would send two separate rate rules and booking requests, it is recommended that bookings for multiple rooms with different room configurations only be allowed for chains that support session control and that session control be used for such bookings. Session control will be discussed in more detail later in this document.
