Usually hotels have several rates with different prices and cancellation policies. To retrieve all that information plus information about special offers you should use OTA_HotelRatePlanRQ call.
Request sample
<OTA_HotelRatePlanRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.003"> <POS /> <RatePlans> <RatePlan> <HotelRef HotelCode="604" /> <DateRange Start="2011-12-25" End="2012-01-03" /> </RatePlan> </RatePlans> </OTA_HotelRatePlanRQ>
Required fields:
Version – OTA requires it
DateRange – Desired period of hotel reservation
HotelCode – Hotel ID
Response sample
<OTA_HotelRatePlanRS> <Success/> <RatePlans HotelCode="674"> <RatePlan RatePlanCode="364"> <DestinationSystemsCode/> <CancelPenalties/> <SellableProducts> <SellableProduct InvTypeCode="C_667"> <GuestRoom/> </SellableProduct> <SellableProduct InvTypeCode="C_668"> <GuestRoom/> </SellableProduct> </SellableProducts> <Rates> <Rate Start="2011-12-25" End="2012-01-03" InvTypeCode="C_667"> <BaseByGuestAmts> <BaseByGuestAmt AmountAfterTax="125.50" CurrencyCode="EUR"/> </BaseByGuestAmts> </Rate> <Rate Start="2011-12-25" End="2012-01-03" InvTypeCode="C_668"> <BaseByGuestAmts> <BaseByGuestAmt AmountAfterTax="135.00" CurrencyCode="EUR"/> </BaseByGuestAmts> </Rate> </Rates> </RatePlan> <RatePlan RatePlanCode="365"> <DestinationSystemsCode/> <CancelPenalties/> <SellableProducts> <SellableProduct InvTypeCode="C_680"> <GuestRoom/> </SellableProduct> <SellableProduct InvTypeCode="C_681"> <GuestRoom/> </SellableProduct> </SellableProducts> <Rates> <Rate Start="2011-12-25" End="2012-01-03" InvTypeCode="C_680"> <BaseByGuestAmts> <BaseByGuestAmt NumberOfGuests="1" AmountAfterTax="125.50" CurrencyCode="EUR"/> <BaseByGuestAmt NumberOfGuests="2" AmountAfterTax="125.50" CurrencyCode="EUR"/> <BaseByGuestAmt NumberOfGuests="3" AmountAfterTax="125.50" CurrencyCode="EUR"/> <BaseByGuestAmt NumberOfGuests="4" AmountAfterTax="125.50" CurrencyCode="EUR"/> <BaseByGuestAmt NumberOfGuests="5" AmountAfterTax="145.00" CurrencyCode="EUR"/> <BaseByGuestAmt NumberOfGuests="6" AmountAfterTax="156.00" CurrencyCode="EUR"/> </BaseByGuestAmts> </Rate> <Rate Start="2011-12-25" End="2012-01-03" InvTypeCode="C_681"> <BaseByGuestAmts> <BaseByGuestAmt NumberOfGuests="1" AmountAfterTax="135.00" CurrencyCode="EUR"/> <BaseByGuestAmt NumberOfGuests="2" AmountAfterTax="135.00" CurrencyCode="EUR"/> <BaseByGuestAmt NumberOfGuests="3" AmountAfterTax="135.00" CurrencyCode="EUR"/> <BaseByGuestAmt NumberOfGuests="4" AmountAfterTax="135.00" CurrencyCode="EUR"/> <BaseByGuestAmt NumberOfGuests="5" AmountAfterTax="157.00" CurrencyCode="EUR"/> <BaseByGuestAmt NumberOfGuests="6" AmountAfterTax="175.00" CurrencyCode="EUR"/> </BaseByGuestAmts> </Rate> </Rates> </RatePlan> </RatePlans> <Offers> <Offer OfferCode="654" ApplicationOrder="" RPH=""> <OfferRules> <OfferRule> <DateRestriction Start="2011-05-05" RestrictionType="arrival"/> </OfferRule> </OfferRules> <Markup Percent="0"/> <OfferDescription> <Text>Text of the offer</Text> </OfferDescription> </Offer> </Offers> </OTA_HotelRatePlanRS>