Skip to main content

ARI Push - Availability

9.8
Hotel
ARI
SOAP API

The OTA_HotelAvailNotifRQ message is used to communicate product level availability restriction values to client systems. The restriction types that are supported are Open, Close, Close to Arrival, Close to Departure, Min and Max Length of Stay, Min and Max Length of Stay Thru.

Target Audience
Hospitality
Current Version
9.8
Authentication
Security Credentials
Service Action Code
OTA_HotelAvailNotifRQ

Each OTA_HotelAvailNotifRQ message will contain restrictions for one hotel and product.

Each AvailStatusMessage element contains one restriction type. Min and Max Length of Stay will be grouped into one AvailStatusMessage element. Min and Max Length of Stay Thru will be grouped into one AvailStatusMessage element.

When Length of Stay (LOS) based ARI is in use, stay restrictions will be provided as usual. Additionally, we will include Full Pattern Length of Stay (FPLOS) updates, which are Closed to Arrival by LOS.

Restrictions with the same value will be consolidated into date ranges.

Each AvailStatusMessage element will contain a counter that will be used for error handling to determine which update(s) in a message failed.

 

NOTE: Use of PUSH ARI APIs is limited to qualified OTAs with advance permission only.

Sample Request
<OTA_HotelAvailNotifRQ xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05/OTA_HotelAvailNotifRQ.xsd" EchoToken="" TimeStamp="2015-10-01T09:41:51.982" ="1.001" MessageContentCode="3" xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <AvailStatusMessages HotelCode="10001">
    <AvailStatusMessage>
      <UniqueID Type="16" ID="1" />
      <StatusApplicationControl Start="2015-01-01" End="2015-02-28" InvTypeCode="King" RatePlanCode="Rack" Mon="true" Tue="true" Weds="true" Thur="true" Fri="true" Sat="true" Sun="true">
        <DestinationSystemCodes>
          <DestinationSystemCode>330</DestinationSystemCode>
        </DestinationSystemCodes>
      </StatusApplicationControl>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
    <AvailStatusMessage>
      <UniqueID Type="16" ID="2" />
      <StatusApplicationControl Start="2015-03-01" End="2015-03-31" InvTypeCode="King" RatePlanCode="Rack" Mon="true" Tue="true" Weds="true" Thur="true" Fri="true" Sat="true" Sun="true">
        <DestinationSystemCodes>
          <DestinationSystemCode>330</DestinationSystemCode>
        </DestinationSystemCodes>
      </StatusApplicationControl>
      <RestrictionStatus Restriction="Arrival" Status="Close" />
    </AvailStatusMessage>
    <AvailStatusMessage>
      <UniqueID Type="16" ID="3" />
      <StatusApplicationControl Start="2015-04-01" End="2015-04-30" InvTypeCode="King" RatePlanCode="Rack" Mon="true" Tue="true" Weds="true" Thur="true" Fri="true" Sat="true" Sun="true">
        <DestinationSystemCodes>
          <DestinationSystemCode>330</DestinationSystemCode>
        </DestinationSystemCodes>
      </StatusApplicationControl>
      <RestrictionStatus Restriction="Departure" Status="Close" />
    </AvailStatusMessage>
    <AvailStatusMessage>
      <UniqueID Type="16" ID="4" />
      <StatusApplicationControl Start="2015-05-01" End="2015-12-31" InvTypeCode="King" RatePlanCode="Rack" Mon="true" Tue="true" Weds="true" Thur="true" Fri="true" Sat="true" Sun="true">
        <DestinationSystemCodes>
          <DestinationSystemCode>330</DestinationSystemCode>
        </DestinationSystemCodes>
      </StatusApplicationControl>
      <RestrictionStatus Restriction="Master" Status="Close" />
    </AvailStatusMessage>
    <AvailStatusMessage>
      <UniqueID Type="16" ID="5" />
      <StatusApplicationControl Start="2015-01-01" End="2015-01-31" InvTypeCode="King" RatePlanCode="Rack" Mon="true" Tue="true" Weds="true" Thur="true" Fri="true" Sat="true" Sun="true">
        <DestinationSystemCodes>
          <DestinationSystemCode>330</DestinationSystemCode>
        </DestinationSystemCodes>
      </StatusApplicationControl>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
        <LengthOfStay MinMaxMessageType="SetMaxLOS" Time="5" TimeUnit="Day" />
      </LengthsOfStay>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <UniqueID Type="16" ID="6" />
      <StatusApplicationControl Start="2015-02-01" End="2015-02-28" InvTypeCode="King" RatePlanCode="Rack" Mon="true" Tue="true" Weds="true" Thur="true" Fri="true" Sat="true" Sun="true">
        <DestinationSystemCodes>
          <DestinationSystemCode>330</DestinationSystemCode>
        </DestinationSystemCodes>
      </StatusApplicationControl>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetForwardMinStay" Time="3" TimeUnit="Day" />
        <LengthOfStay MinMaxMessageType="SetForwardMaxStay" Time="6" TimeUnit="Day" />
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Sample Response
<OTA_HotelAvailNotifRS xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05/OTA_HotelAvailNotifRS.xsd" EchoToken="" TimeStamp="2015-10-01T09:41:59.982" MessageContentCode="3" xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Success/>
</OTA_HotelAvailNotifRS>