Retrieving the room types and the rate plans based on OTA_HotelRoomListRQ

Before the Hotel-Spider system can send inventories, rates and stay restrictions to an online booking system, we need to perform the room type mapping. If in addition, the online booking solution also works with rate plans, these also need to be provided.

The Hotel-Spider system will send the following request

OTA_HotelRoomListRQ
<OTA_HotelRoomListRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" Target="Production" TimeStamp="2015-11-24T16:00:00+02:00" EchoToken="123456789">
  <POS>
    <Source>
    <RequestorID ID="MASTERUSERNAME" MessagePassword="MASTERPASSWORD" Type="13" />
    </Source>
  </POS>
  <HotelRoomLists>
    <HotelRoomList HotelCode="HotelCode" />
  </HotelRoomLists>
</OTA_HotelRoomListRQ>


Request structure

OTA_HotelRoomListRQ

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), HotelRoomLists


HotelRoomLists

Parent: OTA_HotelRoomListRQ

Mandatory: yes

Attributes: None

Child elements: HotelRoomList


HotelRoomList

Parent: HotelRoomLists

Mandatory: yes

Attributes:

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

Child elements: None


The online booking system must respond with the following format

OTA_HotelRoomListRS response with rooms and rates
<OTA_HotelRoomListRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2015-11-25T14:03:12+01:00" CorrelationID="00Q5655b19087479">
  <Success></Success>
  <HotelRoomLists>
    <HotelRoomList HotelName="Hotel Monopole" HotelCode="00P5519244d6895d">
      <RoomStays>
        <RoomStay>
          <RoomTypes>
            <RoomType IsRoom="true" RoomID="00P55192452c758a">
              <Occupancy MinOccupancy="1" MaxOccupancy="2" />
              <RoomDescription Name="Double"/>
            </RoomType>
          </RoomTypes>
          <RatePlans>
            <RatePlan RatePlanID="00P551924532f2f7" RatePlanName="Standard"/>
            <RatePlan RatePlanID="00P5519245339021" RatePlanName="Non refundable"/>
            <RatePlan RatePlanID="00P5519245344243" RatePlanName="Hot Deal"/>
          </RatePlans>
        </RoomStay>
        <RoomStay>
          <RoomTypes>
            <RoomType IsRoom="true" RoomID="00P55192452dc947">
              <Occupancy MinOccupancy="1" MaxOccupancy="1" />
              <RoomDescription Name="Single"/>
            </RoomType>
          </RoomTypes>
          <RatePlans>
            <RatePlan RatePlanID="00P551924532f2f7" RatePlanName="Standard"/>
            <RatePlan RatePlanID="00P5519245339021" RatePlanName="Non refundable"/>
          </RatePlans>
        </RoomStay>
      </RoomStays>
    </HotelRoomList>
  </HotelRoomLists>
</OTA_HotelRoomListRS>


Response structure

OTA_HotelRoomListRS

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, HotelRoomLists


Success

Parent: OTA_HotelRoomListRS

Mandatory: yes

Attributes: None

Child elements: None


HotelRoomLists

Parent: OTA_HotelRoomListRS

Mandatory: yes

Attributes: None

Child elements: HotelRoomList


HotelRoomList

Parent: HotelRoomLists

Mandatory: yes

Attributes:

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

Child elements: RoomStays


RoomStays

Parent: HotelRoomList

Mandatory: yes

Attributes: None

Child elements: RoomStay


RoomStay

Parent: RoomStays

Mandatory: yes

Attributes: None

Child elements: RoomTypes


RoomTypes

Parent: RoomStay

Mandatory: yes

Attributes: None

Child elements: RoomType


RoomType

Parent: RoomTypes

Mandatory: yes

Attributes:

Name
Mandatory
Description
RoomTypeCodeYesThe ID of the room type on the online booking system

Child elements: RoomDescription, Occupancy


Occupancy

Parent: RoomType

Mandatory: yes

Attributes:

Name
Mandatory
Description
MinOccupancyYesThe minimum number of occupants possible for this room type
MaxOccupancyYesThe maximum number of occupants possible for this room type

Child elements: None


RoomDescription

Parent: RoomType

Mandatory: yes

Attributes:

Name
Mandatory
Description
NameYesThe name of the room type on the online booking system

Child elements: None


RatePlans

Parent: RoomStay

Mandatory: yes

Attributes: None

Child elements: RatePlan


RatePlan

Parent: RatePlans

Mandatory: yes

Attributes:

Name
Mandatory
Description
RatePlanCodeYesThe ID of the rate plan on the online booking system
RatePlanNameYesThe name of the rate plan on the online booking system

Child elements: RatePlanDescription