Transmission of the inventories based on OTA_HotelInvCountNotifRQ / OTA_HotelInvCountNotifRS

The Hotel-Spider system will send an OTA_HotelInvCountNotifRQ request to the online booking system every time a change in room availabilities has been detected on our system.

The Hotel-Spider system will send the following request

OTA_HotelAvailRQ
<OTA_HotelInvCountNotifRQ 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_HotelInvCountNotifRQ.xsd" Version="1.000" Target="Test" TimeStamp="2011-07-28T11:05:03">
  <POS>
    <Source>
      <RequestorID ID="MASTERUSERNAME" MessagePassword="MASTERPASSWORD" Type="13"></RequestorID>
    </Source>
  </POS>
  <Inventories HotelCode="HOTELCODE">
    <Inventory>
      <StatusApplicationControl InvCode="00P5519245316dc1" Start="2015-11-24" End="2015-11-25" />
      <InvCounts>
        <InvCount Count="1" />
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

 

Request structure

OTA_HotelInvCountNotifRQ

Parent: None (Root element)

Mandatory: yes

Attributes:

Name
Mandatory
Description
TimeStampYesThe format should respect the ISO 8601 2015-11-16T22:23:48+00:00
TargetYes

When sending updates to the staging environment "Test" must be used.

When sending updates to the production environment "Production" must be used.

VersionYesThe default value should be "1.000"
EchoTokenYesThis string should be returned in the response

Child elements: POS (when using POS authentication. See Authentication methods for more information), Inventories

 

Inventories

Parent: OTA_HotelInvCountNotifRQ

Mandatory: yes

Attributes:

Name
Mandatory
Description
HotelCodeYesThe ID of the hotel on the online booking system

Child elements: Inventory

 

Inventory

Parent: Inventories

Mandatory: yes

Attributes: None

Child elements: StatusApplicationControl, InvCounts


StatusApplicationControl

Parent: Inventory

Mandatory: yes

Attributes:

Name
Mandatory
Description
InvCodeYesThe ID of the room type on the online booking system
RatePlanCodeNoThe ID of the rate plan on the online booking system
StartYesThe format will respect ISO 8601 2015-11-16
EndYesThe format will respect ISO 8601 2015-11-16
MonNoDoes this update apply to a Monday
TueNoDoes this update apply to a Tuesday
WedsNoDoes this update apply to a Wednesday
ThurNoDoes this update apply to a Thursday
FriNoDoes this update apply to a Friday
SatNoDoes this update apply to a Saturday
SunNoDoes this update apply to a Friday

Child elements: None

RatePlanCode attribute use scenario

The RatePlanCode attribute will only be transmitted if the online booking system manages the availabilities on product level.

 

InvCounts

Parent: Inventory

Mandatory: yes

Attributes: None

Child elements: InvCount


InvCount

Parent: InvCounts

Mandatory: yes

Attributes:

Name
Mandatory
Description
CountYesThe number of available rooms

Child elements: None


The online booking system must respond with either of the following formats

 

Use case 1. OTA_HotelAvailRS with only rooms
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2015-11-25T17:21:43+01:00" EchoToken="" CorrelationID="" Version="1.0">
  <Success />
</OTA_HotelInvCountNotifRS>
Use case 2. OTA_HotelAvailRS with rooms and rates
<OTA_HotelInvCountNotifRS 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_HotelInvCountNotifRS>

 

Response structure

OTA_HotelInvCountNotifRS

Parent: None (Root element)

Mandatory: yes

Attributes:

Name
Mandatory
Description
TimeStampYesThe format should respect the ISO 8601 2015-11-16T22:23:48+00:00
TargetYes

When sending updates to the staging environment "Test" must be used.

When sending updates to the production environment "Production" must be used.

VersionYesThe default value should be "1.000"
EchoTokenYesThis string should be returned in the response

Child elements: Success, Errors


Success

Parent: OTA_HotelInvCountNotifRS

Mandatory: no

Attributes: None

Child elements: None

 

 

Errors

Parent: OTA_HotelInvCountNotifRS

Mandatory: No

Attributes: None

Child elements: Error


Error

Parent: Errors

Mandatory: yes

Attributes:

Name
Mandatory
Description
CodeYesThe unique error code assigned by the online booking system
TypeYes 
StatusYes

Possible values are:

  • NotProcessed
  • Incomplete
  • Complete
  • Unknown
ShortTextYesA short textual explanation of the error
TagYesIndicates which element and/or attribute provoked the error to occur

Child elements: None