HotelList

Method Goals

This method returns a list of hotels with basic information (code, name, address, phone, etc.) for each hotel

Request Format

The request does not require any elements. Empty request.

Response Format

The result returns a list of Hotel (hotels).

Remarks

The maximum time permitted in our system before the connection is closed is 240000 milliseconds.

This method may be preloaded in XML Travelgate’s system if it takes more than 3 minutes to download.

The ContinuationToken can be used in this request - the specification can be found in the ‘Common Elements’ section.

HotelListRQ Example

In the request of this call it is only necessary to use the object: “HotelBaseRQ”. You can find the info in the ‘Common Elements’ section.

    <HotelListRQ>
    </HotelListRQ>

Important information about Number (Cardinal):

Go to Common-Elements for more information.

HotelListRQ Description

Element Number Type Description
HotelListRQ 1 Root node.

HotelListRS Example

    <HotelListRS>
        <UpgradeUTCDate>2016-10-18T13:18:03+02:00</UpgradeUTCDate>
        <Hotels>
            <Hotel>
                <Code>5</Code>              
                <GiataId source = "http://urlGiata">1200</GiataId>
                <Name>BADAJOZ</Name>
                <Address>CTRA.NACIONAL V, KM 393</Address>
                <Airports>
                    <Airport>
                        <IATACode>BJZ</IATACode>
                    </Airport>
                </Airports>
                <Town>BADAJOZ</Town>
                <ZipCode>06002</ZipCode>
                <CountryISOCode>ES</CountryISOCode>
                <AvailDestination code = "06" name = "BADAJOZ"/>
                <GeographicDestination code = "06" name = "BADAJOZ" avail = "true"/>
                <Latitude>38.893839</Latitude>
                <Longitude>-7.014112</Longitude>
                <Contact>
                    <Email>badajoz@xxx.com</Email>
                    <Telephone>91425891</Telephone>
                    <Fax>910200200</Fax>
                </Contact>
                <CategoryCode>4 Estrellas</CategoryCode>
                <PaymentOptions cash="false" bankAcct="false">
                    <Cards>
                        <Card code="VI"/>
                        <Card code="AX"/>
                        <Card code="CA"/>  
                    </Cards> 
                <PaymentOptions/>               
                <ExclusiveDeal>true</ExclusiveDeal>     
                <PropertyCategory>
                     <Code>1</Code>
                     <Name>Hotel</Name>             
                </PropertyCategory>                 
            </Hotel>
            <Hotel>
                <Code>65#7</Code>
                <ProviderCode>7</ProviderCode>              
                <GiataId source = "http://urlGiata">1200</GiataId>
                <Name>ILLA</Name>
                <Address>AVDA. ILLA S/N</Address>
                <Town>HUELVA</Town>
                <ZipCode>21449</ZipCode>
                <CountryISOCode>ES</CountryISOCode>
                <AvailDestination code = "2" name = "HUELVA"/>
                <GeographicDestination code = "2" name = "HUELVA" avail = "true"/>
                <Latitude>37.207295</Latitude>
                <Longitude>-7.23768</Longitude>
                <Contact>
                    <Email>emailhotel@xxx.es</Email>
                    <Telephone>95124578</Telephone>
                    <Fax>910200200</Fax>
                </Contact>
                <CategoryCode>4 Estrellas</CategoryCode>   
                <PropertyCategory>
                     <Code>2</Code>
                     <Name>Home</Name>              
                </PropertyCategory>                 
            </Hotel>
            <Hotel>...</Hotel>
        </Hotels>
    </HotelListRS>

HotelListRS Description

Element Number Type Description
HotelListRS /UpgradeUTCDate 1 DateTime Indicates the update date of the information in UTC format.
HotelListRS /Hotels /Hotel 0..n Root node. Hotel sheet.
Code 1 String Internal code to perform availability and/or supplier code.
ProviderCode 0..1 String Internal code established by the supplier (see MetaData).
GiataId 0..1 Giata System ID.
@source 0..1 String Giata url
@value 0..1 String Giata code (more on detailed description)
Name 1 String Name.
Address 1 String Address.
Airports / 0..1 List of airports.
Airports /Airport 1..n Specific airport near the hotel.
Airports /Airport/IATACode 1 String IATA airport Code.
Town 1 String Town.
ZipCode 0..1 String ZipCode.
CountryISOCode 1 String CountryISOCode.
AvailDestination 0..1 Avail Destination.
@code 1 String Destination code.
@name 1 String Destination name.
GeographicDestination 1 Geographic Destination.
@code 1 String Destination code.
@name 1 String Destination name.
@avail 1 Boolean Indicates if it is allowed in availability.
Latitude 0..1 String Latitude. Format is Decimal Degrees (e.g., 37.207295).
Longitude 0..1 String Longitude. Format is Decimal Degrees (e.g., -7.23768).
Contact / 0..1 Contact.
Contact /Email 0..1 String Email.
Contact /Telephone 0..1 String Telephone.
Contact /Fax 0..1 String Fax.
CategoryCode 1 String CategoryCode.
Type 0..1 String Hotel type: please see detailed description
PaymentOptions / 0..1 String Type of cards allowed by the supplier. This tag is only mandatory if payment type is different than MerchantPay.
PaymentOptions /Cards / 1 List of cards allowed.
PaymentOptions /Cards /Card 1..n Type of card allowed.
@code 1 String Code card (see Lists of Data (VI,AX,BV,CA…)).
ExclusiveDeal 0..1 Boolean Indicates that the Hotel has an Exclusive Deal.
PropertyCategory / 0..1 Hotels property type. Similar to , but on supplier’s side.
PropertyCategory /Code 1 String Supplier’s property code.
PropertyCategory /Name 1 String Supplier’s property name.

Detailed Description

Giata Code:

A Giata code is a hotel code that provides information of said hotel. This code is common for all the suppliers.

For example:

For the supplier TravellingTest:

    <Hotel>
        <Code>5</Code>
        <GiataFormatCode>254</GiataFormatCodez>
        <Name>BADAJOZ</Name>
    </Hotel>

For the supplier TestOnTour:

    <Hotel>
        <Code>14</Code>
        <GiataFormatCode>254</GiataFormatCodez>
        <Name>BADAJOZ</Name>
    </Hotel>

Please note that for the same hotel, the internal code of each supplier is different, but the Giata code stays the same. Giata system is an external company that does a generic mapping of all of the hotels information.

AvailDestination & GeographicDestination:

Please note that the code for these parameters needs to be the lowest destination level and these values are available in AvailDestinationTree & GeographicDestinationTree, respectively.

Hotel types:

H (Hotel)

A (Apartment)

AH (Apartment Hotel)

C (Club)

AT (Agrotourism)

HS (Hostel)

CA (House)

V (Ville)

B (Bungalows)

D (Disco Club)

Supplier Code:

The hotel code can be returned combined with other codes, like the city code. In this case, you as a Supplier will need to generate this code, combining the city code and the hotel code, and not returning only your supplier’s Hotel native code. This can also happen with other code types instead of city code (i.e. country code).