he OTA_HotelBookingRuleNotifRQ / OTA_HotelBookingRuleNotifRS can be used to transmit the booking rules on all the agreed levels. A request will be send every time a change in the booking rules has been detected on our system.
| Tip | ||
|---|---|---|
| ||
To indicate for which level (hotel, room type, rate plan or product) a booking rule should be applied, the attributes InvCode and/or RatePlanCode are used. In the Hotel-Spider system all the booking rules can be managed on all 4 levels. However a specific booking rule will only be accessible if at least one connected channel requires it. |
...
| Code Block | ||||
|---|---|---|---|---|
| ||||
<OTA_HotelBookingRuleNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelBookingRuleNotifRQ.xsd" Version="1.000" Target="Test" TimeStamp="2011-08-01T12:05:56">
<POS>
<Source>
<RequestorID ID="MASTERUSERNAME" MessagePassword="MASTERPASSWORD" Type="13"></RequestorID>
</Source>
</POS>
<RuleMessages HotelCode="HOTELCODE">
<RuleMessage>
<StatusApplicationControl InvCode="00P5519245316dc1" RatePlanCode="00P551924536469f" Start="2015-08-24" End="2015-08-24"/>
<BookingRules>
<BookingRule>
<LengthsOfStay>
<LengthOfStay MinMaxMessageType="MinLOSSetMinLOS" Time="2"/>
<LengthOfStay MinMaxMessageType="MaxLOSSetMaxLOS" Time="4"/>
</LengthsOfStay>
<RestrictionStatus Restriction="Arrival" Status="Open"/>
</BookingRule>
<BookingRule>
<RestrictionStatus Restriction="Departure" Status="Close"/>
</BookingRule>
<BookingRule>
<RestrictionStatus Restriction="Master" Status="Open"/>
</BookingRule>
</BookingRules>
</RuleMessage>
</RuleMessages>
</OTA_HotelBookingRuleNotifRQ>
|
...
Child elements: POS (when using POS authentication. See Authentication methods for more information), RuleMessages
RuleMessages
Parent: OTA_HotelBookingRuleNotifRQ
...
Child elements: RuleMessage
RuleMessage
Parent: RuleMessages
...
Name | Mandatory | Description |
|---|---|---|
| InvCode | No | The ID of the room type on the online booking system |
| RatePlanCode | No | The ID of the rate plan on the online booking system |
| 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
BookingRules
Parent: RuleMessage
...
Child elements: BookingRule
BookingRule
Parent: BookingRules
...
Child elements: LengthsOfStay, RestrictionStatus
LengthsOfStay
Parent: BookingRule
...
Name | Mandatory | Description |
|---|---|---|
| Time | Yes | The new price to apply on the online booking system |
| MinMaxMessageType | Yes | Possible values are:
|
Child elements: None
RestrictionStatus
Parent: AvailStatusMessage
...
The online booking system must respond with either of the following formats
| Code Block | ||||
|---|---|---|---|---|
| ||||
<OTA_HotelBookingRuleNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2015-11-25T17:21:43+01:00" EchoToken="" CorrelationID="" Version="1.0"> <Success /> </OTA_HotelBookingRuleNotifRS> |
| Code Block | ||||
|---|---|---|---|---|
| ||||
<OTA_HotelBookingRuleNotifRS 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_HotelBookingRuleNotifRS>
|
...
Response structure
OTA_HotelBookingRuleNotifRS
...
Attributes: None
Child elements: None
Errors
Parent: OTA_HotelBookingRuleNotifRS
...
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 |
...
These rules are not the OTA booking rules, there are specifics for each partner.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<AdditionalRules>
<AdditionalRule AdditionalRule="Cancellation">Free</AdditionalRule>
</AdditionalRules> |
...
Name | Mandatory | Description |
|---|---|---|
| AdditionalRule | Yes | Rule name |
Value : string
Child elements: None