Rates
- David Martin
- Miquel Galobardes (Unlicensed)
Channel Manager API will send updates for rate using OTA_HotelRateAmountNotifRQ message. Channel Manager API will receive the OTA_NotifReportRS and will save the succes or failure of the update.
OTA_HotelRateAmountNotifRQ
The OTA_HotelRateAmountNotifRQ message will be used to update the rate for one Room Type for a single hotel.
Each message will contain a single AvailStatusMessages element with the attribute @HotelCode with the Hotel Code assigned by the Channel Manager.
There can be several AvailStatusMessage child elements per request to hold a data range but the message will be limited to one hotel.
<OTA_HotelRateAmountNotifRQ EchoToken="b024c13c-3dd3-4df1-bb56-5f88ae0b5700" TimeStamp="2021-01-01T12:00:00.000Z" Version="1" xmlns="http://www.opentravel.org/OTA/2003/05">
<POS>
<Source>
<RequestorID Type="22" ID="ULYSESCLOUD"/>
</Source>
</POS>
<RateAmountMessages HotelCode="UC123">
<RateAmountMessage>
<StatusApplicationControl RatePlanCode="BB|2000|BARBBNR" InvTypeCode="DOB"/>
<Rates>
<Rate CurrencyCode="EUR" Start="2021-01-01" End="2021-01-10">
<BaseByGuestAmts>
<BaseByGuestAmt AmountAfterTax="305.10"/>
</BaseByGuestAmts>
</Rate>
</Rates>
</RateAmountMessage>
</RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
Element | Number | Description |
|---|---|---|
OTA_HotelRateAmountNotifRQ | 1 | Main node |
@EchoToken | 1 | Globally unique identifier for the request, the value will be returned in the response EchoToken. |
@Version | 1 | Current version is 1.0 |
@Timestamp | 1 | Timestamp of the request in xml dateTime format |
OTA_HotelRateAmountNotifRQ / POS / Source / RequestorID | 1 | This identifies the system which is sending the Rates. This element must appear in the first Source element. |
@Type | 1 | Fixed at 22 (ESRP) |
@ID | 1 | The ID used will be agreed by the trading partners and remain the same throughout the messages. |
OTA_HotelRateAmountNotifRQ / | 1 | Contains rates for a given hotel |
@HotelCode | 1 | Hotel code of the property whose rate is being updated |
RateAmountMessages / RateAmountMessage | 1..n | Rates to be updated |
RateAmountMessage / StatusApplicationControl | 1 | Contains room identification information |
@RatePlanCode | 1 | Identifies the rate to be updated |
@InvTypeCode | 1 | Identifies the room to be updated |
RateAmountMessage / Rates / Rate | 1..n | Contains the timespan the update applies to and the currency code if this is a rate update |
@CurrencyCode | 1 | Required if BaseByGuestAmts is present, ie if you are updating the rate amount. |
@Start, @End | 1 | The start and end date of the rate plan in xml date format. End date is inclusive. |
Rate / BaseByGuestAmts | 1 | Contains information about the rates. Can be omitted if the update is only for inclusions. |
BaseByGuestAmts / BaseByGuestAmt | 1 | Contains the rate amounts per room |
@AmountAfterTax | 1 | Contains the rate amounts per room |
OTA_NotifReportRS
This message is returned to the PMS in response to the OTA_HotelRateAmountNotifRQ message. It notifies whether the OTA_HotelRateAmountNotifRQ message has been processed successfully.
Example of success Response
<OTA_NotifReportRS EchoToken="daafcc9e-c8c6-484e-87bc-acd7fedb2980" TimeStamp="2021-01-01T12:00:00Z" Version="1.0" xmlns="http://www.opentravel.org/OTA/2003/05">
<Success/>
</OTA_NotifReportRS>Example of error Response
<OTA_NotifReportRS EchoToken="daafcc9e-c8c6-484e-87bc-acd7fedb2980" TimeStamp="2021-01-01T12:00:00Z" Version="1.0" xmlns="http://www.opentravel.org/OTA/2003/05">
<Errors>
<Error Type="3" Code="392">Cannot finder hotelier DOB</Error>
</Errors>
</OTA_NotifReportRS>
Element | Number | Description |
|---|---|---|
OTA_NotifReportRS | 1 | Main element |
@EchoToken | 1 | Return the EchoToken from the request message. |
@Version | 1 | Current version is 1.0 |
@TimeStamp | 1 | Time of the transaction. |
OTA_NotifReportRS / Success | 0..1 | Will only be present if the request processed successfully. The Errors node will not be present if the Success node is present |
OTA_NotifReportRS / Errors | 0..1 | Contains a list of errors if the request failed to process. |
Errors / Error | 1..n | Will be at least one node if there is an Errors Node. |
@Type | 1 | Mandatory if Error present. 3: Biz rule (The business rules for the request message were not met) |
@Code | 0..1 | OTA Error Codes |