The OTA_HotelAvailNotifRQ / OTA_HotelAvailNotifRS can be used to transmit exclusively room-based pricing. A request will be send every time a change in the prices has been detected on our system.
Beside transmitting room availabilities, the OTA_HotelAvailNotifRQ / OTA_HotelAvailNotifRS message pair can also be used to transmit booking rules (MinLOS, MaxLOS, Closed to Arrival, Closed to Departure, etc..) as well as the room availabilities. Check the corresponding chapters to see use cases |
<OTA_HotelAvailNotifRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.opentravel.org/OTA/2003/05" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelAvailNotifRQ" Version="1.000"> <POS> <Source> <RequestorID ID="MASTERUSERNAME" MessagePassword="MASTERPASSWORD" Type="13"></RequestorID> </Source> </POS> <AvailStatusMessages HotelCode="HOTELCODE"> <AvailStatusMessage> <StatusApplicationControl InvCode="00P5519245316dc1" Start="2015-09-25" End="2015-09-28" RatePlanCode="00P551924536469f" /> <BestAvailableRates> <BestAvailableRate Amount="111.33" DecimalPlaces="2" CurrencyCode="CHF" /> </BestAvailableRates> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ> |
OTA_HotelAvailNotifRQ
Parent: None (Root element)
Mandatory: yes
Attributes:
Name | Mandatory | Description |
---|---|---|
TimeStamp | Yes | The format should respect the ISO 8601 2015-11-16T22:23:48+00:00 |
Target | Yes | When sending updates to the staging environment "Test" must be used. When sending updates to the production environment "Production" must be used. |
Version | Yes | The default value should be "1.000" |
EchoToken | Yes | This string should be returned in the response |
Child elements: POS (when using POS authentication. See Authentication methods for more information), AvailStatusMessages
AvailStatusMessages
Parent: OTA_HotelAvailNotifRQ
Mandatory: yes
Attributes:
Name | Mandatory | Description |
---|---|---|
HotelCode | Yes | The ID of the hotel on the online booking system |
Child elements: AvailStatusMessage
AvailStatusMessage
Parent: Inventories
Mandatory: yes
Attributes: None
Child elements: StatusApplicationControl
StatusApplicationControl
Parent: Inventory
Mandatory: yes
Attributes:
Name | Mandatory | Description |
---|---|---|
InvCode/InvTypeCode/RoomID | Yes | The ID of the room type on the online booking system By default our system will search for the InvCode attribute. Should you have been using InvTypeCode in a previous development (for example: OTA version of the Booking.com interface ), we can configure our interface to work with InvTypeCode. The same goes for the RoomID attribute. |
RatePlanCode/RatePlanType/RatePlanID | No | The ID of the rate plan on the online booking system By default our system will search for the RatePlanCode atttribute. Should you have been using RatePlanType in a previous development, we can configure our interface to work with RatePlanType. The same goes for the RatePlanID attribute. |
Start | Yes | The format will respect ISO 8601 2015-11-16 |
End | Yes | The format will respect ISO 8601 2015-11-16 |
Mon | No | Does this update apply to a Monday |
Tue | No | Does this update apply to a Tuesday |
Weds | No | Does this update apply to a Wednesday |
Thur | No | Does this update apply to a Thursday |
Fri | No | Does this update apply to a Friday |
Sat | No | Does this update apply to a Saturday |
Sun | No | Does this update apply to a Friday |
Child elements: None
The RatePlanCode/RatePlanType/RatePlanID attribute will only be transmitted if the online booking system manages multiple rate plans. |
BestAvailableRates
Parent: AvailStatusMessage
Mandatory: yes
Attributes: None
Child elements: BestAvailableRate
BestAvailableRate
Parent: BestAvailableRates
Mandatory: yes
Attributes:
Name | Mandatory | Description |
---|---|---|
Amount | Yes | The new price to apply on the online booking system |
DecimalPlaces | Yes | The number of decimal places that have been transferred with the price |
CurrencyCode | Yes | The currency in which the price has been transmitted |
Child elements: None
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2015-11-25T17:21:43+01:00" EchoToken="" CorrelationID="" Version="1.0"> <Success /> </OTA_HotelAvailNotifRS> |
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2015-11-25T17:21:43+01:00" EchoToken="" CorrelationID="" Version="1.0"> <Errors> <Error Code="3008" Type="13" Status="NotProcessed" ShortText="Processing error" Tag="/">Hotel ID invalid</Error> </Errors> </OTA_HotelAvailNotifRS> |
OTA_HotelAvailNotifRS
Parent: None (Root element)
Mandatory: yes
Attributes:
Name | Mandatory | Description |
---|---|---|
TimeStamp | Yes | The format should respect the ISO 8601 2015-11-16T22:23:48+00:00 |
Target | Yes | When sending updates to the staging environment "Test" must be used. When sending updates to the production environment "Production" must be used. |
Version | Yes | The default value should be "1.000" |
EchoToken | Yes | This string should be returned in the response |
Child elements: Success, Errors
Success
Parent: OTA_HotelAvailNotifRS
Mandatory: no
Attributes: None
Child elements: None
Errors
Parent: OTA_HotelAvailNotifRS
Mandatory: No
Attributes: None
Child elements: Error
Error
Parent: Errors
Mandatory: yes
Attributes:
Name | Mandatory | Description |
---|---|---|
Code | Yes | The unique error code assigned by the online booking system |
Type | Yes | |
Status | Yes | Possible values are:
|
ShortText | Yes | A short textual explanation of the error. Max 64 characters. |
Tag | Yes | Indicates which element and/or attribute provoked the error to occur |
Child elements: None