Get rules for a specific hotel room type before booking

[hong22]

The definition for OTA_HotelBookingRuleRQ,
This message provides the capability of requesting the rules and usage requirements (either all or for a specific rule category) of a rate for a specific hotel property. The request may be per room type, booking code, check in/out dates, or by confirmation number for a previously booked reservation.

However, I could not find a good place in the RQ xml to put the room type? Can you give a sample for this?

[BonnieLowell]

Hi Hong22,

Here's some sample code that defines a room type using the OTA_HotelBookingRuleRQ @InvTypeCode attribute:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelBookingRuleRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelBookingRuleRQ.xsd" EchoToken="12345671" TimeStamp="2006-05-02T09:30:47-05:00" Target="Production" Version="1.000">
<POS>
<Source>
<RequestorID Type="13" ID="4258"/>
<!--Type 13=Internet broker-->
<BookingChannel Type="7">
<!--Type 7=Internet-->
<CompanyName CompanyShortName="Travel The World"/>
</BookingChannel>
</Source>
</POS>
<RuleMessage ChainCode="DW" HotelCode="53291">
<StatusApplication Start="2006-05-20" End="2006-05-23" InvType="Room" InvTypeCode="N2DRAC"/>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="1"/>
<!--AgeQualifyingCode 10=Adult-->
<GuestCount AgeQualifyingCode="8" Count="1"/>
<!--AgeQualifyingCode 8=Child-->
</GuestCounts>
</RuleMessage>
</OTA_HotelBookingRuleRQ>

The response would look something like this:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelBookingRuleRS xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelBookingRuleRS.xsd" EchoToken="12345671" TimeStamp="2005-05-02T09:30:47-05:00" Target="Production" Version="1.000">
<Success/>
<RuleMessage ChainCode="DW" HotelCode="53291" HotelName="Sleep Well" StateProv="FL" PostalCode="32830">
<StatusApplication Start="2006-05-20" End="2006-05-23" InvTypeCode="N2DRAC">
<RoomRates>
<RoomRate Amount="99.00" CurrencyCode="USD" Start="2006-05-20" Duration="P2D">
</RoomRate>
<RoomRate Amount="109.00" CurrencyCode="USD" Start="2006-05-22" Duration="P1D">
</RoomRate>
<RoomRate Amount="397.17" CurrencyCode="USD">
<RateDescription>
<Text>Total amount per stay</Text>
</RateDescription>
</RoomRate>
<RoomRate>
<RateDescription>
<Text>Excludes taxes/fees/surcharges</Text>
<Text>2DBeds best available rate.</Text>
<Text>Traditional room 2 phones W Data Port, ergonomic chair large desk, coffee tea maker.</Text>
<Text>Newly renovated spacious room with all amenities</Text>
<Text>For business or leisure traveler</Text>
</RateDescription>
</RoomRate>
</RoomRates>
</StatusApplication>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="1"/>
<!--AgeQualifyingCode 10=Adult-->
</GuestCounts>
<BookingRules>
<BookingRule MinAdvancedBookingOffset="P14D">
<AcceptableGuarantees>
<AcceptableGuarantee GuaranteePolicyType="GuaranteesRequired">
<Comments>
<Comment>
<Text>Major credit cards</Text>
</Comment>
</Comments>
</AcceptableGuarantee>
</AcceptableGuarantees>
<CancelPenalties CancelPolicyIndicator="true">
<CancelPenalty>
<Deadline AbsoluteDeadline="18:00:00" OffsetTimeUnit="Day" OffsetUnitMultiplier="0" OffsetDropTime="BeforeArrival"/>
<AmountPercent NmbrOfNights="1" BasisType="Nights"/>
</CancelPenalty>
</CancelPenalties>
<RequiredPaymts>
<GuaranteePayment PaymentCode="31">
<!--PaymentCode 31=Guarantee-->
<AcceptedPayments>
<AcceptedPayment>
<PaymentCard CardType="1" CardCode="AX"/>
<!--CardType 1=CreditCard-->
</AcceptedPayment>
<AcceptedPayment>
<PaymentCard CardType="1" CardCode="CB"/>
<!--CardType 1=CreditCard-->
</AcceptedPayment>
<AcceptedPayment>
<PaymentCard CardType="1" CardCode="DC"/>
<!--CardType 1=CreditCard-->
</AcceptedPayment>
<AcceptedPayment>
<PaymentCard CardType="1" CardCode="DI"/>
<!--CardType 1=CreditCard-->
</AcceptedPayment>
<AcceptedPayment>
<PaymentCard CardType="1" CardCode="EC"/>
<!--CardType 1=CreditCard-->
</AcceptedPayment>
<AcceptedPayment>
<PaymentCard CardType="1" CardCode="ER"/>
<!--CardType 1=CreditCard-->
</AcceptedPayment>
<AcceptedPayment>
<PaymentCard CardType="1" CardCode="MC"/>
<!--CardType 1=CreditCard-->
</AcceptedPayment>
<AcceptedPayment>
<PaymentCard CardType="1" CardCode="VI"/>
<!--CardType 1=CreditCard-->
</AcceptedPayment>
<AcceptedPayment>
<PaymentCard CardType="1" CardCode="XS"/>
<!--CardType 1=CreditCard-->
</AcceptedPayment>
</AcceptedPayments>
</GuaranteePayment>
<GuaranteePayment PaymentCode="8">
<!--PaymentCode 8=Deposit-->
<AmountPercent TaxInclusive="true" NmbrOfNights="1" Percent="100"/>
<Deadline OffsetTimeUnit="Day" OffsetUnitMultiplier="7" OffsetDropTime="BeforeArrival"/>
<Address FormattedInd="false">
<AddressLine>Sleep Well</AddressLine>
<AddressLine>2234 Orange Grove Lane</AddressLine>
<AddressLine>Orlando, FL 32830</AddressLine>
</Address>
</GuaranteePayment>
<GuaranteePayment>
<AmountPercent>
<Taxes>
<Tax Code="15" Percent="9.5" ChargeUnit="12"/>
<!--Code 15=StateTax-->
<!--ChargeUnit 12=PerStay-->
<Tax Code="3" Percent="5" ChargeUnit="12"/>
<!--Code 3=CityTax-->
<!--ChargeUnit 12=PerStay-->
<Tax Code="2" Amount="3.00" CurrencyCode="USD" ChargeUnit="20"/>
<!--Code 2=CityHotelFee-->
<!--ChargeUnit 20=PerPersonPerStay-->
<Tax Code="4" Percent="2" ChargeUnit="12"/>
<!--Code 4=CountyTax-->
<!--ChargeUnit 12=PerStay-->
<Tax Code="6" Percent="8" ChargeUnit="12"/>
<!--Code 6=FederalTax-->
<!--ChargeUnit 12=PerStay-->
<Tax Code="5" Amount="3.00" CurrencyCode="USD" ChargeUnit="19"/>
<!--Code 5=EnergyTax-->
<!--ChargeUnit 19=PerRoomPerNight-->
</Taxes>
</AmountPercent>
</GuaranteePayment>
</RequiredPaymts>
<LengthsOfStay>
<LengthOfStay Time="1" TimeUnit="Day" MinMaxMessageType="MinLOS"/>
<LengthOfStay Time="31" TimeUnit="Day" MinMaxMessageType="MaxLOS"/>
</LengthsOfStay>
<Description>
<Text>Property has 198 rooms on 4 floors</Text>
<Text>Property location - centrally located between Orlando airport and Disney World</Text>
</Description>
</BookingRule>
</BookingRules>
</RuleMessage>
</OTA_HotelBookingRuleRS>

Let me know if you have any other questions!
Thanks,
-Bonnie

[hong22]

Thanks for the prompt response. It would be great if you can add this sample to the user guide. Thanks.