Hotel List

The Hotel List method returns a comprehensive hotel list from a supplier's access to the Buyer, granting access to all the properties configured by the Seller for a given set of credentials. The returned fields include: Hotel Code, GiataId, Name, Address, ZipCode, Contact, CategoryCode etc.

HotelList Request

<soapenv:Envelope xmlns:soapenv = "http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns = "http://schemas.xmltravelgate.com/hub/2012/06" xmlns:wsse = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
   <soapenv:Header>
      <wsse:Security>
         <wsse:UsernameToken>
            <wsse:Username>username</wsse:Username>
            <wsse:Password>password</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <ns:HotelList>
         <ns:hotelListRQ>
            <ns:timeoutMilliseconds>20000</ns:timeoutMilliseconds>
            <ns:version>1</ns:version>
            <ns:providerRQ>
               <ns:code>suppliercode</ns:code>
               <ns:id>1</ns:id>
               <ns:rqXML>
                  <HotelListRQ xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd = "http://www.w3.org/2001/XMLSchema">
                     <timeoutMilliseconds>19700</timeoutMilliseconds>
                     <source>
                        <languageCode>en</languageCode>
                     </source>
                     <filterAuditData>
                        <registerTransactions>true</registerTransactions>
                     </filterAuditData>
                     <Configuration>
                        <User>user</User>
                        <Password>password</Password>
                        <UrlAvail>www.supplier.com/avail</UrlAvail>
                        <UrlReservation>www.supplier.com/reservation</UrlReservation>
                        <UrlValuation>www.supplier.com/valuation</UrlValuation>
                        <UrlGeneric>www.supplier.com/generic</UrlGeneric>
                        <Parameters>
                           <Parameter key = "UrlListHotels" value = "http://www.supplier.com/ListHotels"></Parameter>
                           <Parameter key = "Access" value = "2"></Parameter>
                        </Parameters>
                     </Configuration>
                  </HotelListRQ>
               </ns:rqXML>
            </ns:providerRQ>
         </ns:hotelListRQ>
      </ns:HotelList>
   </soapenv:Body>
</soapenv:Envelope>

Request Data Breakdown

HotelList request does not require any elements.

HotelList Response

After each request, you will have to process the data and provide a response. Upon receiving a HotelList request, you will need to send a corresponding HotelList response.

<HotelListRS xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd = "http://www.w3.org/2001/XMLSchema">
   <UpgradeUTCDate>2016-10-18T13:18:03+02:00</UpgradeUTCDate>
   <Hotels>
      <Hotel>
         <Code>5</Code>  
         <ProviderCode>27</ProviderCode>                          
         <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>
   </Hotels>
</HotelListRS>

Response Data Breakdown

Element	Rel	Type	Description
HotelListRS/UpgradeUTCDate	1	DateTime	Indicates the update date of the information in UTC format.
HotelListRS/Hotels	0..n
Hotels/Hotel	0..n
Hotel/Code	1	String	Internal code to perform availability and/or supplier code.
Hotel/ProviderCode	0..1	String	Internal code established by the supplier (see MetaData).
Hotel/GiataId	0..1		Giata code
@source	0..1	String	Giata url
Hotel/Name	1	String	Hotel name
Hotel/Address	1	String	Hotel address
Hotel/Airports	0..1
Airports/Airport	1..n
Airport/IATACode	1	String	IATA airport Code (airport near the hotel).
Hotel/Town	1	String	Town
Hotel/ZipCode	0..1	String	ZipCode
Hotel/CountryISOCode	1	String	CountryISOCode
Hotel/AvailDestination	0..1
@code	1	String	Avail destination code (lowest destination level).
@name	1	String	Avail destination name (lowest destination level).
Hotel/GeographicDestination	1
@code	1	String	Geographic Destination code (lowest destination level).
@name	1	String	Geographic Destination name (lowest destination level).
@avail	1	Boolean	Indicates if it is allowed in availability.
Hotel/Latitude	0..1	String	Latitude. Format is Decimal Degrees (e.g. 37.207295).
Hotel/Longitude	0..1	String	Longitude. Format is Decimal Degrees (e.g. -7.23768).
Hotel/Contact	0..1
Contact/Email	0..1	String	Contact email
Contact/Telephone	0..1	String	Contact telephone
Contact/Fax	0..1	String	Contact fax
Hotel/CategoryCode	1	String	Hotel category code.
Hotel/Type	0..1	String	Hotel Type codes Code Name H Hotel A Apartment AH Apartment Hotel C Club AT Agrotourism HS Hostel CA House V Ville B Bungalows D Disco Club
Hotel/PaymentOptions	0..1		Type of cards allowed by the supplier. This tag is only mandatory if payment type is different than MerchantPay.
@cash	1	Boolean	Cash indicates whether payment will be made in cash (true) or by card (false).
@bankAcct	1	Boolean	BankAcct specifies whether payment will be made via bank transfer (true) or not (false).
PaymentOptions/Cards	1
Cards/Card	1..n		Type of card allowed.
@code	1	String	Credit Card codes Code Name VI Visa AX American Express BC BC Card CA MasterCard CB Carte Blanche CU China Union Pay DS Discover DC Diners Club T Carta Si R Carte Bleue N Dankort L Delta E Electron JC Japan Credit Bureau TO Maestro S Switch EC Electronic Cash EU EuroCard TP Universal air travel card OP optima ER Air Canada/RnRoute XS access O others
Hotel/ExclusiveDeal	0..1	Boolean	Indicates that the Hotel has an Exclusive Deal.
Hotel/PropertyCategory	0..1		Hotels property type. Similar to Type, but on supplier’s side.
PropertyCategory/Code	1	String	Supplier’s property code.
PropertyCategory/Name	1	String	Supplier’s property name.