Change in availability status and Restrictions

Requirements:

  • RoomType and RatePlan Information: Any change in availability status or restrictions must include both RoomType and RatePlan information.

  • Availability Updates: The PMS must send availability updates at the room type level.

  • Availability Status and Restrictions Updates: These updates should be sent at the product level, which is a combination of RoomType and RatePlan.

Handling Multiple Products:

  • If multiple products are associated with a single room type, and the availability notification message does not specify a rate type, the update will be applied to all rate types associated with that room type.

<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"  
TimeStamp="2004-05-01T06:39:09" 
 
Target="Production" 
 
Version="1.002" EchoToken="25525379hyyds63" 
 
 <AvailStatusMessages HotelCode="ATLPE" HotelName="The Sheraton"> 
 
 <AvailStatusMessage> 
 
 	<StatusApplicationControl Start="2011-12-02" End="2011-12-05" 
 
 InvCode="STD" RatePlanCode="BAR"> </StatusApplicationControl> 
 
<RestrictionStatus Status="Open"/> 
 
 	<UniqueID Type="16" ID="1"/> 
 
 </AvailStatusMessage> 
 
 <AvailStatusMessage> 
 
 	<StatusApplicationControl Start="2011-12-02" End="2011-12-05" 
 
 InvCode="STD" RatePlanCode="BAR"> </StatusApplicationControl> 
 
<LengthsOfStay> 
 
<<LengthOfStay MinMaxMessageType="SetMinLOS" 
TimeUnit="Day" Time="1"/></LengthOfStay> 
 	</LengthsOfStay> 
 
 	<UniqueID Type="16" ID="2"/> 
 
 </AvailStatusMessage> 
 
 <AvailStatusMessage> 
 
 	<StatusApplicationControl Start="2011-12-02" End="2011-12-05" 
 
 InvCode="STD" RatePlanCode="BAR"> </StatusApplicationControl> 
 
<LengthsOfStay> 
 
<<LengthOfStay MinMaxMessageType="SetMaxLOS" 
TimeUnit="Day" Time="10"/></LengthOfStay> 
 	</LengthsOfStay> 
 
 	<UniqueID Type="16" ID="3"/> 
 
 </AvailStatusMessage> 
 
</AvailStatusMessages> 
</OTA_HotelAvailNotifRQ>

Availability request XML sample

Element/@Attribute

Parent XPath

Description

Occurrences

@TimeStamp

/OTA_HotelAvailNotifRQ

Time of the transaction in xml schema date-time format

1

@EchoToken

/OTA_HotelAvailNotifRQ

Unique Identifier to track the RQ/RS message

1

@Target

/OTA_HotelAvailNotifRQ

Always set to “Production”

1

@Version

/OTA_HotelAvailNotifRQ

Always set to “1.0”

1

AvailStatusMessages

/OTA_HotelAvailNotifRQ

Contains list of availability messages (AvailStatusMessage)

1

@HotelCode

/OTA_HotelAvailNotifRQ/AvailStatusMessages

The code of the property whose availability is being updated

1

@HotelName

/OTA_HotelAvailNotifRQ/AvailStatusMessages

The name of the property whose availability is being updated

0..1

AvailStatusMessage

/OTA_HotelAvailNotifRQ/AvailStatusMessages

An availability message. One of the BookingLimit or RestrictionStatus or LengthsOfStay must be included

1..n

@BookingLimit

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage

The number of rooms available.

Optional,tobeset atRoom level

0…1

@BookingLimitMessageType

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage

Always set to “SetLimit”.

Mandatory if “BookingLimit” is available.

0…1

StatusApplicationControl

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage

The date range, room type code and rate code for which this

notification is sent is specified in this element

1

@Start

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/

StatusApplicationControl

The start date for which the availability update is being set

1

@End

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/

StatusApplicationControl

The end date for which the availability update is being set

1

@InvCode

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/

StatusApplicationControl

Identifies the room type for which the availability is being updated. The room type code + rate code

identify a unique product for which this update applies.

1

@RatePlanCode

Identifies the rate plan for which the availability is being updated.

Optional, in case of Inventory count (“BookingLimit”) only.

0..1

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/

StatusApplicationControl

@Mon @ Tue @Weds @Thur @Fri @Sat @Sun /OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/ StatusApplicationControl

The day of the week indicators are used to communicate which days of the week the update pertains to. For example, if Mon, Tue and Weds are set to "1", and the other days are set to "0", the availability will only be updated for Mondays, Tuesdays and Wednesdays. Optional.

If not set, all are assumed to be set to true. NOTE: If one is sent they must all be sent.

0..1

UniqueID /OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage

Unique identifier for each availability message

1

LengthsOfStay

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage

Availability based on length of stay can be set using this.

Optional

0..1

LengthOfStay

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage

/LengthsOfStay

Mandatory if LengthsOfStay present.

1

@Time

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage

/LengthsOfStay /LengthOfStay

Mandatory if LengthOfStay is present. Sets the minimum number of days required for a stay.

1

@TimeUnit

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage

/LengthsOfStay /LengthOfStay

Mandatory if LengthOfStay is present. Always set to“Day”

1

@MinMaxMessageType

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage

/LengthsOfStay /LengthOfStay

Mandatory if LengthOfStay is present. Stay control type. Can be any of the options below:

SetMinLOS : To set minimum length of stay.

SetMaxLOS: To set maximum length of stay.

SetForwardMinStay: To set minimum length of stay through.

SetForwardMaxStay: To set maximum length of stay through.

1

RestrictionStatus

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage

Availability status assigned to the room rate combination.

0..1

@Status

/OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/

RestrictionStatus

The restriction status. Mandatory if RestrictionStatus is present. Can be any of the options below:

Open: The Sale is open.

Close: The Sale is closed.

ClosedOnArrival: Arrival is closed.

ClosedOnDeparture: Departure is closed.

OpenOnArrival: Arrival is open.

OpenOnDeparture: Departure is open.

ClosedOnArrivalDeparture: Both Arrival & Departure is closed.

MaxAdvancedBookingOffset: Maximum number of days before the arrival date the hotel is bookable.

MinAdvancedBookingOffset: Minimum number of days before the arrival date the hotel is bookable.

1

Last updated