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.
Endpoint: https://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 | S | 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 | S | 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
}