Skip to content

OTA_HotelAvailRQ

This is an alternative to OTA_HotelRatePlanRQ

This request is an alternative to the OTA_HotelRatePlanRQ request. Depending on your use case or how you connect your channel manager to the corresponding channels, the connectivity provides compatbility for most combinations in the market. There are no advantages or disadvantages of the different combinations of requests.

The hotel availability request allows the retrieval of the rate plan and room combinations for the hotel for which the hotel code was provided in the request body. The property for which the property id was provided as the hotel code needs to be mapped to this user.

<?xml version="1.0"?>
<soap:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
        <AccessHeader>
            <UserName>MyUserName</UserName>
            <Password>MyPassword</Password>
        </AccessHeader>
    </soap:Header>
    <soap:Body>
        <OTA_HotelAvailRQ xmlns="http://www.opentravel.org/OTA/2003/05" 
            AvailRatesOnly="true" 
            EchoToken="66899191-67f6-4092-b82e-0321ebf75601"
            TimeStamp="2021-09-16T06:58:10+00:00" Version="1.0">
            <AvailRequestSegments>
                <AvailRequestSegment AvailReqType="Room">
                    <HotelSearchCriteria>
                        <Criterion>
                            <HotelRef HotelCode="my-hotel-code" />
                        </Criterion>
                    </HotelSearchCriteria>
                </AvailRequestSegment>
            </AvailRequestSegments>
        </OTA_HotelAvailRQ>
    </soap:Body>
</soap:Envelope>

Response contents and data

The response to the request will include all rooms and their associated rates with their codes and names.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <OTA_HotelAvailRS EchoToken="66899191-67f6-4092-b82e-0321ebf75601" 
            Version="1.0" TimeStamp="2021-09-29T18:43:57.771Z" 
            PrimaryLangID="en-US" 
            xmlns="http://www.opentravel.org/OTA/2003/05">
            <Success />
            <RoomStays>
                <RoomStay>
                    <RoomTypes>
                        <RoomType RoomTypeCode="doppelzimmer">
                            <RoomDescription Name="Doppelzimmer" />
                        </RoomType>
                    </RoomTypes>
                    <RatePlans>
                        <RatePlan RatePlanCode="nonref-double">
                            <RatePlanDescription Name="Nonref Double" />
                        </RatePlan>
                    </RatePlans>
                </RoomStay>
                <RoomStay>
                    <RoomTypes>
                        <RoomType RoomTypeCode="doppelzimmer">
                            <RoomDescription Name="Doppelzimmer" />
                        </RoomType>
                    </RoomTypes>
                    <RatePlans>
                        <RatePlan RatePlanCode="standard-double">
                            <RatePlanDescription Name="Standard Double" />
                        </RatePlan>
                    </RatePlans>
                </RoomStay>
                <RoomStay>
                    <RoomTypes>
                        <RoomType RoomTypeCode="einzelzimmer">
                            <RoomDescription Name="Einzelzimmer" />
                        </RoomType>
                    </RoomTypes>
                    <RatePlans>
                        <RatePlan RatePlanCode="standard-single">
                            <RatePlanDescription Name="Standard Single" />
                        </RatePlan>
                    </RatePlans>
                </RoomStay>
                <RoomStay>
                    <RoomTypes>
                        <RoomType RoomTypeCode="suite">
                            <RoomDescription Name="Suite" />
                        </RoomType>
                    </RoomTypes>
                    <RatePlans>
                        <RatePlan RatePlanCode="standard-2568">
                            <RatePlanDescription Name="Standard 2568" />
                        </RatePlan>
                    </RatePlans>
                </RoomStay>
            </RoomStays>
        </OTA_HotelAvailRS>
    </soap:Body>
</soap:Envelope>

Response field definitions

The output contains the rate plan with the rates and the description including the following fields.

Field Description
RoomTypeCode Code of the room/unit
RoomDescription Name Name of the room/unit
RatePlanCode Code of the rate plan
RatePlanDescription Name of the rate plan