# 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.

```xml
<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**

| <p><strong>Element/@Attribute</strong></p><p> </p><p><strong>Parent XPath</strong></p>                                                                                                                                                                                                                 | <p> </p><p><strong>Description</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | **Occurrences**             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| <p>@TimeStamp</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                       | <p> </p><p>Time of the transaction in xml schema date-time format</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                           |
| <p>@EchoToken</p><p>  </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                              | Unique Identifier to track the RQ/RS message                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                           |
| <p>@Target</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                          | <p> </p><p>Always set to “Production”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                           |
| <p>@Version</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                         | <p> </p><p>Always set to “1.0”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                           |
| <p>AvailStatusMessages</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                              | <p> </p><p>Contains list of availability messages (AvailStatusMessage)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| <p>@HotelCode</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages</strong></p>                                                                                                                                                                                                   | <p> </p><p>The code of the property whose availability is being updated</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                           |
| <p>@HotelName</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages</strong></p>                                                                                                                                                                                                   | <p> </p><p>The name of the property whose availability is being updated</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                        |
| <p>AvailStatusMessage</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages</strong></p>                                                                                                                                                                                           | An availability message. One of the BookingLimit or RestrictionStatus or LengthsOfStay must be included                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1..n                        |
| <p>@BookingLimit</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                             | <p> </p><p>The number of rooms available.</p><p>Optional,tobeset atRoom level</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 0…1                         |
| <p>@BookingLimitMessageType</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                  | <p>Always set to “SetLimit”.</p><p>Mandatory if “BookingLimit” is available.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 0…1                         |
| <p> </p><p>StatusApplicationControl</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                          | <p>The date range, room type code and rate code for which this</p><p>notification is sent is specified in this element</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| <p>@Start</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                                   | <p> </p><p>The start date for which the availability update is being set</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                           |
| <p>@End</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                                     | <p> </p><p>The end date for which the availability update is being set</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| <p> </p><p>@InvCode</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                         | <p>Identifies the room type for which the availability is being updated. The room type code + rate code</p><p>identify a unique product for which this update applies.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| @RatePlanCode                                                                                                                                                                                                                                                                                          | <p>Identifies the rate plan for which the availability is being updated.</p><p>Optional, in case of Inventory count (“BookingLimit”) only.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 0..1                        |
| <p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                                                                | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p><br></p>                 |
| <p> @Mon<br>@ Tue<br><br>@Weds<br>@Thur<br>@Fri<br>@Sat<br>@Sun<br><br>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/<br>StatusApplicationControl<br><br></p>                                                                                                                         | <p>The day of the week indicators are used to communicate which days of the week the update pertains to.<br>For example, if Mon, Tue and Weds are set to "1", and the other days are set to "0", the availability will<br>only be updated for Mondays, Tuesdays and Wednesdays. Optional.</p><p>If not set, all are assumed to be set to true.<br><br>NOTE: If one is sent they must all be sent.</p>                                                                                                                                                                                                                             | 0..1                        |
| <p>UniqueID<br>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</p>                                                                                                                                                                                                                      | <p> </p><p>Unique identifier for each availability message</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                           |
| <p>LengthsOfStay</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                     | <p>Availability based on length of stay can be set using this.</p><p><br></p><p>Optional</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                        |
| <p>LengthOfStay</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay</strong></p>                                                                                                                        | <p> </p><p>Mandatory if LengthsOfStay present.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                           |
| <p>@Time</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay /LengthOfStay</strong></p>                                                                                                                 | <p> </p><p>Mandatory if LengthOfStay is present. Sets the minimum number of days required for a stay.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                           |
| <p>@TimeUnit</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay /LengthOfStay</strong></p>                                                                                                             | <p> </p><p>Mandatory if LengthOfStay is present. Always set to“Day”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1                           |
| <p> </p><p> </p><p>@MinMaxMessageType</p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay /LengthOfStay</strong></p>            | <p>Mandatory if LengthOfStay is present. Stay control type. Can be any of the options below:</p><p>SetMinLOS : To set minimum length of stay.</p><p>SetMaxLOS: To set maximum length of stay.</p><p>SetForwardMinStay: To set minimum length of stay through.</p><p>SetForwardMaxStay: To set maximum length of stay through.</p>                                                                                                                                                                                                                                                                                                 | 1                           |
| <p>RestrictionStatus</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                 | <p> </p><p>Availability status assigned to the room rate combination.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 0..1                        |
| <p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p>@Status</p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>RestrictionStatus</strong></p> | <p>The restriction status. Mandatory if RestrictionStatus is present. Can be any of the options below:</p><p>Open: The Sale is open.</p><p>Close: The Sale is closed.</p><p>ClosedOnArrival: Arrival is closed.</p><p>ClosedOnDeparture: Departure is closed.</p><p>OpenOnArrival: Arrival is open.</p><p>OpenOnDeparture: Departure is open.</p><p>ClosedOnArrivalDeparture: Both Arrival & Departure is closed.</p><p>MaxAdvancedBookingOffset: Maximum number of days before the arrival date the hotel is bookable.</p><p>MinAdvancedBookingOffset: Minimum number of days before the arrival date the hotel is bookable.</p> | <p>        1</p><p><br></p> |