Este mensaje devuelve una lista de establecimientos en base a los parámetros que se indique en el mensaje de solicitud.

Es importante tener en cuenta que sólo se devolverán aquellos establecimientos a los que el usuario tenga acceso.

 

En la respuesta se devolverá el listado de establecimientos agrupados por vendorCode (grupo de establecimientos) y además se incluirá la información básica de cada establecimiento. Si se quiere consultar información en más detalle será necesario lanzar la petición del mensaje hotelInformation descrito en el siguiente apartado de la documentación.


Endpointhttps://hotel.new.hotetec.com/webservice/integrations/pull/listHotels

 


Mensaje de petición listHotels

 

El mensaje está compuesto por los siguientes elementos:

 

Elemento

Obligatorio

Valores / Formato

Descripción

sessionId

S

Alfanumérico

ID de la sesión generado

languageCode

N

DE, EN, ES, FR, IT, NL, PT

Idioma en el que queremos recibir la respuesta. Si no se indica, se devolverá el valor que Hotetec tenga por defecto para el usuario

 

Se utilizan los códigos ISO 639-1. Actualmente sólo se aceptan los indicados en valores.

currency

N

EUR, USD, GBP, EGP, MXN, CHF, CUP

Divisa en la que queremos recibir los precios de la solicitud. Si no se indica, se devolverá el valor que Hotetec tenga por defecto para el usuario.

 

Se utilizan los códigos ISO 639-1. Actualmente sólo se aceptan las indicadas en valores.

vendorCode

N

Alfanumérico

Código de proveedor/empresa de un conjunto de hoteles/establecimientos

hotelCode

N

Alfanumérico

Código individual de un hotel/establecimiento

hotelName

N

Alfanumérico

Nombre del establecimiento. Se puede indicar una parte del nombre y se hará una búsqueda de aquellos establecimientos que contengan esos nombres.

hotelFacilityCode

N

Alfanumérico

Tipo de instalaciones del establecimiento. Ejemplo: PISCINA

locationCode

N

Alfanumérico

Código de la zona geográfica donde se encuentra el establecimiento

categoryCode

N

Alfanumérico

Categoría del establecimiento

chainCode

N

Alfanumérico

Código de cadena

establishmentTypeCode

N

Alfanumérico

Código de tipo de establecimiento.

roomCode

N

Alfanumérico

Código interno de la habitación. Uso interno.

rateCode

N

Alfanumérico

Código de tarifa

onlyWithRates

N

 

 

true

false

Indica si queremos recibir únicamente establecimientos con tarifas definidas

True: Si

False: No

 


Ejemplo de mensaje con todos los elementos cumplimentados (JSON):

{

    "sessionId"" HPH#20077#682164202862402",

    "languageCode""ES",

    "currency""EUR",

    "vendorCode": [“DEMOHTT”],

    "hotelCode": [“45501”],

    "hotelName": “Playa”,

    "hotelFacilityCode": [”PISCINA”],

    "locationCode"”ESBAL03”,

    "categoryCode": [”5*”],

    "chainCode": [”DEMO”],

    "establishmentTypeCode": [”HOTL”],

    "roomCode": [”DBL#STD”],

    "rateCode"“30006”,

    "onlyWithRates": “false”

}

 

Mensaje de respuesta listHotels

 

El mensaje está compuesto por los siguientes elementos:

 

Elemento

Descripción

sessionId

ID de la sesión generado

notification

Tipo de notificación.

Error: importante revisarlo para corregir la incidencia que esté indicando el sistema

Aviso

Información

notificationDetail

Descripción de la notificación indicada.

vendorCode

Código de proveedor/empresa de un conjunto de hoteles/establecimientos

 

hotel

code

Código individual de un hotel/establecimiento

name

Nombre completo del establecimiento

chain

Cadena a la que pertenece el establecimiento

 

establishmentType

code

Código del tipo de establecimiento. (Ejemplo: HOTL)

name

Descripción del tipo de establecimiento (Ejemplo: Hotel)

 

category

code

Código de la categoría (Ejemplo: 5*)

name

Descripción de la categoría. (Ejemplo: Cinco estrellas)

 

address – country

code

Código del país (Ejemplo: ES)

name

Descripción del país (Ejemplo: España)

state

Tipificación adicional del árbol de destino

county

Población del establecimiento

province

Tipificación adicional del árbol de destino

 

address – location

code

Código de la zona geográfica.

name

Descripción de la zona geográfica

postalCode

Código postal del establecimiento

adressText

Dirección del establecimiento

 

address - gps

latitude

Latitud

longitude

Longitud

 

contact

Datos de contacto del establecimiento

 

Ejemplo de mensaje (JSON):

{   

"sessionId""HPH#20077#280227446359930",

    "notification"null,

    "notificationDetail"null,

    "hotelsByVendor": [

        {

            "vendorCode""DEMOHTT",

            "hotel": [

                {

                    "code""30621",

                    "name""Boutique Hotel Elena",

                    "chain"null,

                    "establishmentType": {

                        "code""HOTL",

                        "name""Hotel"

                    },

                    "category": {

                        "code""4*",

                        "name""Cuatro estrellas"

                    },

                    "address": {

                        "country": {

                            "code""ES",

                            "name""ESPAÑA"

                        },

                        "state"null,

                        "county""Adeje",

                        "province"null,

                        "location": {

                            "code""ES-48245",

                            "name""Adeje"

                        },

                        "postalCode""38670",

                        "addressText""Av. Adeje",

                        "gps": {

                            "latitude"28.15039046107699,

                            "longitude"-16.44536361524011

                        }

                    },

                    "contact"null

 }