This message is used to provide a notification of a new rate plan created for a hotel and to synchronize the rate plan between the PMS and the channel manager.
<?xml version="1.0" encoding="utf-8"?>
<OTA_HotelRateAmountNotifRQ EchoToken="Example123" PrimaryLangID="eng" Target="Production" TimeStamp="2018-07-29T07:38:54.729Z" Version="1.0">
<POS>
<Source>
<RequestorID ID="APIKEY" MessagePassword="APIPASSWORD"/>
</Source>
</POS>
<RateAmountMessages HotelCode="12345">
<RateAmountMessage>
<StatusApplicationControl InvTypeCode="DBL" RatePlanCode="STD" RateTier="1" Start="2018-07-24" End="2018-07-31" Mon="true" Fri="true" />
<Rates>
<Rate>
<BaseByGuestAmts>
<BaseByGuestAmt NumberOfGuests="1" AgeQualifyingCode="10" AmountAfterTax="3895" DecimalPlaces="2" />
<BaseByGuestAmt NumberOfGuests="2" AgeQualifyingCode="10" AmountAfterTax="4995" DecimalPlaces="2" />
</BaseByGuestAmts>
<AdditionalGuestAmounts>
<AdditionalGuestAmount Amount="1000" DecimalPlaces="2" />
</AdditionalGuestAmounts>
</Rate>
</Rates>
</RateAmountMessage>
</RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
Element / @Attribute | Parent | Info | Values | Occurrence |
---|---|---|---|---|
RateAmountMessages | OTA_HotelRateAmountNotifRQ | A collection of RateAmountMessages that define the rate changes to be made. | 1..n | |
@HotelCode | RateAmountMessages | The ID of the hotel. | [integer] | 1 |
RateAmountMessage | RateAmountMessages | RateAmountMessages that define the rate changes to be made. | 1..n | |
StatusApplicationControl | RateAmountMessage | Information on what the RateAmount Message applies to (i.e. the combination of inventory and rate codes) and the period of application. The StatusApplicationControl class is used to indicate to which block codes/rate plans/inventory codes a status should be applied. | 1 | |
@InvTypeCode | StatusApplicationControl | The ID of the room. Required when updating rates, not required when updating a rate plan. | [integer] | 0..1 |
@InvType | StatusApplicationControl | Optional attribute to be included when a bed type in a room needs to be updated. Always set to BedType . Omit when updating a room. |
BedType |
0..1 |
@InvCode | StatusApplicationControl | Optional attribute to be included when a bed type in a room needs to be updated. Indicates the ID of the bed type. | [integer] | 0..1 |
@RatePlanCode | StatusApplicationControl | The ID of the rate, or the ID of the rate plan (in case RatePlanCodeApplication has been set to RatePlanGroupingCode ). |
[integer] | 1 |
@RatePlanCodeApplication | StatusApplicationControl | Omit when updating a rate, set to RatePlanGroupingCode when updating a rate plan. |
RatePlanGroupingCode |
0..1 |
@Start | StatusApplicationControl | The starting value of the time span. | [yyyy-MM-dd] | 1 |
@End | StatusApplicationControl | The ending value of the time span. | [yyyy-MM-dd] | 1 |
@Mon, @Tue, @Weds, @Thur, @Fri, @Sat, @Sun | StatusApplicationControl | When true , applies only to a particular day. |
true false |
0..1 |
Rates | RateAmountMessage | A collection of rate changes to be synchronized between systems. | 1 | |
Rate | Rates | An individual rate, which is a collection of amounts by guest, additional guests, and the unique id to identify the rate. | 1 | |
BaseByGuestAmts | Rate | A collection of Base charges by number of guests. | 1 | |
BaseByGuestAmt | BaseByGuestAmts | Base charge for a given number of guests for a given age qualifying code. | 1..n | |
@NumberOfGuests | BaseByGuestAmt | The number of guests associated with this base charge. Only required for AgeQualifyingCode 10 (Adult). |
1 = Single use2 = Standard use3 = Triple use4 = Quad use |
0..1 |
@AgeQualifyingCode | BaseByGuestAmt | Defines an age range or age category of a guest. | Refer to OpenTravel Code List Age Qualifying Code (AQC).10 = Adult (Default) |
0..1 |
@DecimalPlaces | BaseByGuestAmt | The ISO 4217 standard "minor unit" for the number of decimal places for a particular currency. | 2 |
1 |
@AmountAfterTax | BaseByGuestAmt | The total amount including all associated taxes (e.g., sales tax, VAT, GST or any associated tax). | [numeric] | 1 |
AdditionalGuestAmounts | Rate | A collection of charges that apply to for additional guests. | 0..1 | |
AdditionalGuestAmount | AdditionalGuestAmounts | Collection of incremental charges for additional guests. | 1 | |
@Amount | AdditionalGuestAmount | A monetary amount, including tax. | [numeric] | 1 |
@DecimalPlaces | AdditionalGuestAmount | Decimal places for currency code. | 2 |
1 |
This message is used to indicate the status of processing the OTA_HotelRateAmountNotifRQ
message.
<?xml version="1.0" encoding="utf-8"?>
<OTA_HotelRateAmountNotifRS EchoToken="Example123" PrimaryLangID="eng" Target="Production" TimeStamp="2018-07-29T07:38:54.729Z" Version="1.0">
<Success />
<UniqueID ID="123456" Type="18" />
</OTA_HotelRateAmountNotifRS>
Element / @Attribute | Parent | Info | Values | Occurrence |
---|---|---|---|---|
UniqueID | OTA_HotelRateAmountNotifRS | An identifier used to uniquely reference an object in a system. | 1 | |
@ID | UniqueID | The queue ID. | [integer] | 1 |
@Type | UniqueID | A reference to the type of object defined by the UniqueID element. | Refer to OpenTravel Code List Unique ID Type (UIT). Value: 18 = Other |
1 |
Only the exact data stated in the request message will be processed; this data needs to be different than the data present in the channel manager.
Other data present in the channel manager will not be modified.