Overview
The Hotel Rate Plan Notification message is used to notify the CRS of a new rate plan created for a hotel or to modify and synchronize existing rate plans.
With the creation of a new rate plan, a business process must also take place to ensure that the rate plan is populated up through the distribution system. New rate plans and group blocks are broadcast through authorized channels of distribution determined by negotiated business agreements. Viewership is usually set up when a new rate plan code is negotiated and it defines the distribution channel for the rate plan and the profile of the authorized booker(s). The distribution channels are indicated by a collection of System Codes.
The <OTA_HotelRatePlanNotifRS> returns a response to the Hotel Rate Plan Notification request message, indicating that the notification message was successfully processed and warnings from business processing rules or errors if the notification was not able to be processed.
Business Rules
The guarantee policy detail is not supported in version 100. Instead, the GuaranteeCode is used to identify an existing policy that has been already setup in the CRS.
The cancel policy detail is not supported in version 1.00. Instead, the CancelPenalty. PolicyCode is used to identify an existing policy that has been already setup in the CRS.
For RMS to CRS - if @RatePlanNotifType=”Overlay” and rate does not yet exist in CRS, it will be created from this message.
For RMS to CRS, after initial rate create, it is preferred any changes to rate values come via HotelRateAmountNotif to avoid overriding any rate header details a hotelier may have input directly in the CRS.
OTA_HotelRatePlanNotifRQ Elements & Attributes
Element | @Attribute | Num | Description/Contents | Origin | Value |
OTA_HotelRateAmountNotifRQ | 1 | Root element of the message. |
|
OTA_HotelRateAmountNotifRQ / RatePlans | |||
@HotelCode | |||
OTA_HotelRateAmountNotifRQ / RatePlan | |||
@Start | |||
@End | |||
@CurrencyCode | |||
@RatePlanCode | |||
@RatePlanNotifType | |||
OTA_HotelRateAmountNotifRQ / RatePlans / RatePlan / Rates | |||
OTA_HotelRateAmountNotifRQ / RatePlans / RatePlan / Rates / Rate | |||
@RateTimeUnit | |||
@UnitMultiplier | |||
@Start | |||
@End | |||
@Mon | |||
@Tue | |||
@Weds | |||
@Thur | |||
@Fri | |||
@Sat | |||
@Sun | |||
@InvTypeCode | |||
OTA_HotelRateAmountNotifRQ / RatePlans / RatePlan / Rates / Rate / BaseByGuestAmts | |||
OTA_HotelRateAmountNotifRQ / RatePlans / RatePlan / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt | |||
@AmountBeforeTax | |||
@NumberOfGuests | |||
@AgeQualifyingCode | |||
OTA_HotelRateAmountNotifRQ / RatePlans / RatePlan / Rates / Rate / AdditionalGuestAmounts | |||
OTA_HotelRateAmountNotifRQ / RatePlans / RatePlan / Rates / Rate / AdditionalGuestAmount | |||
@AgeQualifyingCode | |||
@Amount |
OTA_HotelRatePlanNotifRQ Sample
<?xml version="1.0" encoding="UTF-8"?> <soap:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns="http://www.opentravel.org/OTA/2003/05" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header> <PayloadInfo RequestId="22d3ac7c-f01e-49c6-8fbd-ae269f39c0ad" RequestorId="TEST" SourceId="RMS" DestinationId="CRS" RetryInd="false"> <Authentication Username="username" Password="Password"/> <PayloadDescriptor Name="OTA_HotelRatePlanNotifRQ" Version="1.0"/> </PayloadInfo> </soap:Header> <soap:Body> <OTA_HotelRatePlanNotifRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:ns="http://www.opentravel.org/OTA/2003/05" EchoToken="123456" TimeStamp="2021-07-16T19:58:15.970422+05:30" Target="Test" Version="1" MessageContentCode="8" TransactionIdentifier="6172037375195"> <RatePlans HotelCode="TESTHotel"> <RatePlan Start="2022-01-16" End="2022-01-16" CurrencyCode="USD" RatePlanCode="BAR" RatePlanNotifType="Overlay"> <Rates> <Rate RateTimeUnit="Day" UnitMultiplier="1" Start="2022-01-16" End="2022-01-16" Mon="true" Tue="true" Weds="true" Thur="true" Fri="true" Sat="true" Sun="true" InvTypeCode="KING"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="115.10" NumberOfGuests="1" AgeQualifyingCode="10" /> <BaseByGuestAmt AmountBeforeTax="120.20" NumberOfGuests="2" AgeQualifyingCode="10" /> <BaseByGuestAmt AmountBeforeTax="120.20" NumberOfGuests="3" AgeQualifyingCode="10" /> <BaseByGuestAmt AmountBeforeTax="120.20" NumberOfGuests="4" AgeQualifyingCode="10" /> </BaseByGuestAmts> <AdditionalGuestAmounts> <AdditionalGuestAmount AgeQualifyingCode="10" Amount="50.00" /> <AdditionalGuestAmount AgeQualifyingCode="8" Amount="10.00" /> </AdditionalGuestAmounts> </Rate> </Rates> </RatePlan> </RatePlans> </OTA_HotelRatePlanNotifRQ> </soap:Body> </soap:Envelope>
OTA_HotelRatePlanNotifRS Elements & Attributes
Element | @Attribute | Num | Description/Contents | Origin | Value |
OTA_HotelRatePlanNotifRS | 1 | Root Element of the message |
|
[TODO] Provide sample response