Recupere una lista de hoteles por ubicación o una lista de identificadores hotelIds específicos.

Este método puede utilizarse para que se devuelvan hoteles con habitaciones disponibles en un intervalo de fechas proporcionado, o bien para que se devuelva una lista de todos los establecimientos activos en la ubicación especificada sin información sobre disponibilidad.

Este procedimiento admite varios filtros y métodos para especificar la ubicación deseada con el fin de permitir diversas opciones de búsqueda en una interfaz de usuario (por ejemplo, mediante el código de aeropuerto o visualizando la localización en un mapa).

Formatos de solicitud
URL de XML/REST: GET http://api.ean.com/ean-services/rs/hotel/v3/list?
Elemento principal de XML: <HotelListRequest>

Requisitos de protocolo únicos
REST
Parámetros de solicitud
En cada búsqueda de hoteles disponibles se requieren, como mínimo, un intervalo de fechas, un recuento de habitaciones y huéspedes adultos, así como una lista de ubicaciones o de parámetros hotelId.

Para obtener una lista sin fechas o una lista de todos los establecimientos activos en una ubicación sin información sobre disponibilidad específica, basta con que omita los parámetros arrivalDate, departureDate y RoomGroup en la solicitud.

Parámetros básicos
Nombre Valor Requerido Descripción
apiExperience cadena

Utilice este atributo para identificar el origen de su solicitud. Para cada solicitud que envíe, elija un valor aplicable del conjunto de opciones que se proporciona a continuación.

Valores:
PARTNER_CALL_CENTER - solicitud de un agente de su centro de llamadas
PARTNER_WEBSITE - solicitud de un sitio web para clientes
PARTNER_MOBILE_WEB - solicitud de un sitio web para móviles
PARTNER_MOBILE_APP - solicitud de una aplicación para móviles
PARTNER_BOT_CACHE - solicitud de un bot de caché
PARTNER_BOT_REPORTING - solicitud de un bot de informes
PARTNER_AFFILIATE - solicitud de una plataforma o API que sirve a su propia base de afiliación

arrivalDate cadena para búsqueda de disponibilidad

Fecha de entrada, en formato MM/DD/AAAA.

Incluya la fecha actual para solicitar la disponibilidad ese mismo día. Las reservas se pueden efectuar hasta las 23:59 hora local del hotel (21:59 para la Hora Estándar del Pacífico y las islas del Pacífico).

departureDate cadena para búsqueda de disponibilidad Fecha de salida, en formato MM/DD/AAAA.

La disponibilidad se puede consultar hasta con 500 días de antelación respecto a esta fecha.

La duración total de la estancia no puede superar 28 noches.
numberOfResults entero no Número máximo de hoteles que se devolverán por cada respuesta (antes de que sea necesario realizar una paginación para mostrar más resultados). Se acepta un intervalo de valores de 1 a 200. Predeterminado: 20

No limita resultados en solicitudes de listas sin fechas.
RoomGroup objeto para búsqueda de disponibilidad Contenedor de las matrices de Room que definen el recuento de habitaciones y huéspedes. Consulte la sección siguiente más abajo para REST.
RoomGroup.Room matriz para búsqueda de disponibilidad El número de nodos de Room define el número de habitaciones solicitadas. Cada nodo tiene su propio recuento de huéspedes adultos o niños.

Los establecimientos permiten hasta 8 habitaciones por reserva.
Room.numberOfAdults entero para búsqueda de disponibilidad Recuento de huéspedes adultos de la habitación.

Los establecimientos admiten normalmente un máximo de 4 huéspedes antes de incurrir en tasas por persona adicional.

No ofrezca más de 8 huéspedes por habitación, ya que no se devolverán resultados por encima de este número de huéspedes para la mayoría de los mercados.
Room.numberOfChildren entero en caso de que > 0 Recuento de huéspedes infantiles de la habitación. Requerido para todos los establecimientos. Se utiliza junto con childAges para determinar la disponibilidad y las tarifas.
Room.childAges lista o matriz de enteros
separados por comas
en caso de que el recuento de niños sea > 0 Envíe las edades de los niños de la habitación como lista separada por comas para XML y REST, y como matriz de valores individuales de childAges para SOAP.

Solicite siempre esta información a los clientes cuando se especifiquen huéspedes infantiles. Se pueden aplicar cargos adicionales por personas no previstos si las edades de los niños no se indican antes de la reserva.
includeDetails booleano no

Devuelve las políticas de cancelación, los tipos de camas y las preferencias para fumadores por cada habitación, si esos datos están disponibles.

Devuelve elementos adicionales solo con valores de minorRev=22 o superior.

includeHotelFeeBreakdown booleano no Devuelve el elemento HotelFeeBreakdown, que contiene una estructura de respuesta más detallada para la matriz de HotelFees, que incluye la frecuencia y la forma en que se aplica cada tarifa. Disponible con un valor de minorRev=24 y superior.
Formato de habitaciones para REST
El formato de REST compacta los valores de los elementos anteriores en una lista delimitada por comas. Para declarar una habitación y sus ocupantes, utilice el siguiente formato:

&room[número de habitación, empezando por 1]=
[número de adultos],
[lista de edades de niños, delimitadas por comas]


Por ejemplo, para declarar que una habitación la ocupan un adulto y dos niños de 5 y 12 años de edad, debería enviar &room1=1,5,12. No hay una declaración separada para el número de niños; se asume que cada valor de edad pertenece a un niño.


Métodos principales de búsqueda
Hay cuatro métodos principales disponibles para limitar la selección de hoteles que se devuelven en la solicitud. Se presentan a continuación en ningún orden concreto.
Tres de ellos limitan la selección según una ubicación definida y el restante permite la devolución de un conjunto explícito de hoteles mediante una lista de identificadores de hoteles hotelIds específicos.
No use más de uno de estos métodos a la vez.


Método 1: Búsqueda de localidad/estado/país
Nombre Valor Se requiere para el método de búsqueda Descripción
city cadena
Localidad donde buscar. Use únicamente nombres de localidades completos.
stateProvinceCode cadena para US,
CA, AU
Código de dos caracteres correspondiente al estado o la provincia donde esté situada la localidad indicada. En el caso de Australia, debe usar los códigos especiales que se indican más abajo.

Referencias:
Códigos de estados de EE. UU.
Códigos de provincias y territorios de Canadá
Códigos de provincias y territorios de Australia
  • Capital de Australia: AC
  • Nueva Gales del Sur: NW
  • Territorio del Norte: NO
  • Queensland: QL
  • Australia del Sur: SA
  • Tasmania: TS
  • Victoria: VC
  • Australia Occidental: WT
countryCode cadena
Código ISO-3166 de dos caracteres correspondiente al país donde esté situada la localidad indicada. Utilice solamente códigos de país designados como "oficiales" en la tabla de códigos ISO-3166.


Método 2: Use una cadena de destino con texto libre.
Nombre Valor Se requiere para el método de búsqueda Descripción
destinationString cadena Una cadena que contiene al menos el nombre de una localidad. También puede enviar el nombre de una localidad y un estado, una localidad y un país, ciudad/estado/país, etc.

Este parámetro es la mejor opción para que el cliente introduzca datos directamente.

Las entradas ambiguas devolverán un error que contendrá una lista de ubicaciones que podrían ser la buscada.


Método 3: Use una lista de identificadores de hoteles hotelIds.
Nombre Valor Se requiere para el método de búsqueda Descripción
hotelIdList lista de enteros largos
separados por comas
Compruebe la disponibilidad consultando un conjunto fijo de hoteles. Envíe los valores de hotelId deseados como una lista delimitada por comas.

Si no se especifica ningún orden de clasificación, el algoritmo optimizado predeterminado de EAN clasifica los hoteles. Utilice la opción de clasificación NO_SORT para conservar el orden de su lista.

Todo valor de hotelId no válido se devolverá en el encabezado de respuesta de Invalid-Hotel-Ids como una lista separada por comas:
Vary: Accept-Encoding 
Content-Length: 1562
Avail-Source: 1
Invalid-Hotel-Ids: 1234,6645353
Transaction-Id: d85a243e-b61d-11e5-a89b-0b34b1565000
Al utilizar listas de enteros largos (long), tenga en cuenta que los tiempos de respuesta pueden aumentar de forma considerable en comparación con el uso de listas de menor tamaño en varias solicitudes. Use POST en lugar de GET para enviar listas largas por medio de REST. El límite absoluto es de 2500 ID de hotel por solicitud.


Método 4: Buscar dentro de un área geográfica.
Nota: También puede utilizar este método para buscar aeropuertos junto con el archivo de coordenadas de aeropuertos.
Nombre Valor Se requiere para el método de búsqueda Descripción
latitude cadena Coordenada de latitud del punto de origen de la búsqueda, con formato DD.MMmmm.
longitude cadena Coordenada de longitud del punto de origen de la búsqueda, con formato DDD.MMmmm.
searchRadius entero no Define el radio de una zona de búsqueda circular, estando su centro definido con los valores proporcionados de latitude y longitude.
El mínimo es de 1 MI o 2 KM, el máximo de 50 MI o 80 KM. Los valores que superen el máximo se reducirán automáticamente antes de devolver los resultados.
El valor predeterminado es de 20 MI.
searchRadiusUnit cadena no Define la unidad de distancia para el radio de búsqueda. Envíe
MI o KM. El valor predeterminado es MI si está vacío o no se incluye.
sort cadena no Debe enviar un valor de PROXIMITY si desea que los resultados se ordenen por distancia desde el punto de origen. De lo contrario, el orden de clasificación se aplica a cualquier hotel situado dentro del radio de búsqueda.

Consulte la definición completa de este elemento en la siguiente sección para comprobar todos los valores disponibles.

No se aplica para los resultados de solicitudes de listas sin fechas.
Métodos de búsqueda adicionales
Ofrezca los siguientes métodos de búsqueda como alternativas con el fin de que los clientes pueden realizar búsquedas por una dirección cercana o un hotel concreto.


Nombre Valor Requiere otros parámetros Descripción
address cadena Busca en las proximidades una dirección postal local. La respuesta contendrá la proximidad de cada establecimiento a la dirección indicada.

Aunque se introduzca la dirección de un hotel específico, no se anulará su posición en la clasificación predeterminada si ya no se encuentra en la parte superior.

Requiere que se definan los parámetros city y countryCode.
postalCode cadena Opcionalmente, se puede incluir el código postal de una dirección.

Requiere que se definan los parámetros city y countryCode.
propertyName cadena Nombre que se buscará para comprobar la disponibilidad. El valor puede ser un nombre exacto o parte de un nombre; por ejemplo, "Holiday" o "Best."

La respuesta contendrá todos los establecimientos cuyos nombres contengan el valor incluido en este parámetro.

Si se envía un nombre de establecimiento específico, es posible que se devuelva una respuesta vacía si no hay disponibilidad para las fechas de estancia indicadas.

Requiere que se definan los parámetros city y countryCode.

Métodos de filtro
Con estos métodos se filtran resultados por servicios, precios, clasificación por estrellas y otros criterios de compra habituales. Se pueden ofrecer antes de la búsqueda inicial, junto con un método principal, o bien usarlos para actualizar de forma dinámica una página de resultados de búsqueda existente. También se pueden usar internamente para limitar los resultados disponibles para los clientes; por ejemplo, para restringir los establecimientos a un determinado nivel de estrellas o niveles superiores.

Nombre Valor Requerido Descripción
includeSurrounding booleano no Cuando se envía como false, este parámetro excluirá los hoteles que se encuentren fuera del área que definió en sus parámetros de búsqueda.
Úselo si desea evitar que aparezcan en sus resultados hoteles de otras localidades cercanas o áreas adyacentes.
propertyCategory entero o lista de enteros separada por comas no

Filtra los resultados según la categoría de los establecimientos. Puede enviar un solo valor o una lista de valores para obtener una combinación de categorías de establecimientos.

Nota:
Estos valores no se corresponden con las categorizaciones de los archivos de nuestra base de datos estática ni con ningún otro dato suministrado por Expedia.

Valores:
1: hotel
2: suite
3: complejo turístico
4: alquiler vacacional/apartamento
5: bed and breakfast
6: todo incluido

amenities entero o lista de enteros separada por comas no

Se recomienda dejar de utilizar este elemento. Los valores de este elemento no coinciden con los servicios de Expedia ni con nuestros propios archivos de la base de datos de servicios.
La alternativa recomendada es descargar el archivo de base de datos AttributeList de forma local para filtrar hoteles que se encuentran en la ubicación solicitada y que incluyen los servicios indicados en los filtros.

maxStarRating flotante no Filtra los resultados por una clasificación por estrellas máxima.
Los valores válidos son de 1.0 a 5.0 en saltos de 0.5.
minStarRating flotante no Filtra los resultados por una clasificación por estrellas mínima.
Los valores válidos son de 1.0 a 5.0 en saltos de 0.5.
minRate flotante no Filtra los resultados por establecimientos con tarifas iguales o superiores al valor indicado.
Busca en el valor de respuesta de averageRate (media de las tarifas por noche individual durante las fechas de la estancia). Solamente es válido para búsquedas de disponibilidad.
maxRate flotante no Filtra los resultados por establecimientos con tarifas iguales o inferiores al valor indicado.
Busca en el valor de respuesta de averageRate (media de las tarifas por noche individual durante las fechas de la estancia). Solamente es válido para búsquedas de disponibilidad.
numberOfBedRooms entero no Este parámetro solamente es válido para alquileres vacacionales o apartamentos. Especifica el número de dormitorios solicitado, siendo 4 el máximo.
maxRatePlanCount entero no Define el número de tipos de habitaciones que se debe devolver con cada establecimiento.

Al establecer un valor superior, se intentará devolver el número correspondiente de tipos de habitación de cada establecimiento en la respuesta según las disponibilidades de cada establecimiento.

El valor predeterminado es 1, donde solamente se devuelve el primer tipo de habitación en cada establecimiento. Dentro de las pruebas de usuarios de Expedia, este valor ha demostrado proporcionar las mejores tasas de conversión y se recomienda dejarlo como está, guardando las habitaciones adicionales para mostrarlas durante la fase de selección de habitaciones.

Opciones de clasificación
Se recomienda enviar búsquedas iniciales sin especificar un orden de clasificación, ya que el orden de clasificación predeterminado se calcula con objeto de que los establecimientos preferidos y con mejor tasa de conversión se muestren en la parte superior. En vez de ello, permita que los clientes elijan un orden de clasificación distinto tras devolver la lista inicial.
Nombre Valor Requerido Descripción
sort cadena no Preferencia de clasificación para los establecimientos devueltos.

Valores:
DEFAULT

Clasificación optimizada según rentabilidad, valor predeterminado.

BUDGET

Clasifica según rentabilidad, dando preferencia a los hoteles más económicos de cada mercado. Sitúa en los primeros lugares a los hoteles económicos con la relación más rentable entre consulta y reserva.

CHAMPION

Clasifica según rentabilidad, dando preferencia a los hoteles situados en la zona media de cada mercado. Sitúa en los primeros lugares a los hoteles de gama media con la relación más rentable entre consulta y reserva.

PREMIUM

Clasifica según rentabilidad, dando preferencia a los hoteles del segmento más alto cada mercado. Sitúa en los primeros lugares a los hoteles de gama alta con la relación más rentable entre consulta y reserva.

PROMO Sitúa a los establecimientos con tarifa de promoción o valor añadido por encima de los establecimientos que no tienen promociones.
PRICE_AVERAGE Clasifica los establecimientos por tarifa media por noche, de forma creciente. El orden no es perfecto debido a los algoritmos de la oficina de negocio/marketing que se aplican a las listas de establecimientos a las que accede la API. Para conseguir una clasificación por precios más precisa es mejor trabajar con su propio código después de recibir los resultados.
PRICE_REVERSE Clasifica los establecimientos por tarifa por noche, de forma decreciente. Lo habitual es que la clasificación no sea perfecta, como hemos explicado antes.
QUALITY Ordena los establecimientos por clasificación por estrellas, de forma decreciente.
QUALITY_REVERSE Ordena los establecimientos por clasificación por estrellas, de forma creciente.
PROXIMITY Ordena los establecimientos basándose en la proximidad respecto al punto de origen definido mediante los parámetros latitude y longitude.
TRIP_ADVISOR Si tiene una integración con TripAdvisor autorizada, este valor ordenará los resultados según las clasificaciones de los huéspedes, en orden decreciente.
NO_SORT Se utiliza solamente junto con hotelIdList. Devuelve hoteles en el orden exacto enumerado en la solicitud.
HIGH_MARGIN

Basada en la opción de clasificación CHAMPION, la clasificación HIGH_MARGIN va un paso más adelante y otorga preferencia a los establecimientos con el mayor porcentaje de margen, asegurando así que los establecimientos con márgenes y tasas de conversión elevados aparezcan cerca de las primeras posiciones. La opción de clasificación HIGH_MARGIN toma en consideración los costes adicionales a nivel de establecimiento y otorga preferencia al porcentaje de margen para el asociado.

Solicitud de datos adicionales

Utilice este parámetro para limitar la respuesta a tipos específicos de datos dinámicos. Se utiliza habitualmente junto con nuestros archivos de base de datos de hoteles como fuentes de información estática que normalmente suministra la API. Las integraciones que utilicen este parámetro junto con bases de datos sin conexión disfrutarán de tiempos de respuesta notablemente más cortos que aquellas que solamente se basen en las respuestas de la API.

Nombre Valor Requerido Descripción
options cadena o lista de cadenas
separada por comas
no Define el tipo de datos limitado que se debe devolver. Envíe un solo valor o una combinación en forma de lista separada por comas.

Valores:
DEFAULT Devuelve los tres tipos de datos que se enumeran a continuación, valor predeterminado. La respuesta será la misma que si se omitiese options por completo.
HOTEL_SUMMARY

Devuelve información de hoteles dinámica con una pequeña cantidad de información estática de identificación (nombre y dirección del hotel, descripción de la ubicación, hotelId, etc.).
No contiene información de tarifas dinámica. Es la respuesta de disponibilidad más escueta posible.

ROOM_RATE_DETAILS Devuelve información dinámica de tarifas de habitaciones y una cantidad mínima de información estática mediante los parámetros hotelId y roomDescription.
Paginación para obtener más hoteles

Si la respuesta inicial devuelve moreResultsAvailable como true, se puede solicitar la siguiente página de resultados mediante el proceso que se detalla a continuación.

Para realizar la paginación con el fin de obtener más resultados, solo se pueden enviar supplierType, cacheLocation y cacheKey en la solicitud de disponibilidad posterior. Se deben omitir todos los demás parámetros no comunes.

Deberá incluir el valor supplierType=E en su solicitud. Si no incluye este valor, moreResultsAvailable puede devolver erróneamente true cuando la lista se haya agotado.

Finalmente, si se devuelve un error que indica "cacheLocation cannot be found", significa que la memoria caché ha caducado y que debe volver a realizarse la búsqueda original. Las respuestas en caché tienen normalmente una duración de 15-30 minutos.

Consulte Paginación para obtener más resultados si desea ver más ejemplos.


Nombre Tipo Se requiere para el método Descripción
supplierType cadena Debe enviarse con el valor E para que el sistema de paginación pueda indicar de forma precisa los resultados adicionales.
cacheKey cadena Es la clave de la respuesta en caché específica solicitada. Utilice el valor devuelto en la respuesta de lista de hoteles anterior.
cacheLocation cadena Define la ubicación en el servidor de EAN de la caché solicitada. Utilice el valor devuelto en la respuesta de lista de hoteles anterior.
Respuesta de lista de hoteles
Devuelve hoteles en la ubicación especificada con habitaciones disponibles para las fechas de la estancia y el recuento de huéspedes proporcionados.

Si se ha solicitado una "lista sin fechas" mediante la omisión de los elementos arrivalDate, departureDate y RoomGroup, la respuesta incluirá todos los hoteles activos en la ubicación especificada sin ninguna información sobre disponibilidad específica.

Contenido de la respuesta
Elemento principal: HotelListResponse


Nombre Valor Descripción
moreResultsAvailable booleano Indica si hay más resultados de establecimientos disponibles para paginar.

Si el valor es true, se pueden obtener más resultados mediante el proceso de paginación.
numberOfRoomsRequested entero Confirma el número de habitaciones que se solicitaron originalmente (número de nodos de Room).
cacheKey cadena Es la clave para la caché de la respuesta devuelta actual. Utilice este valor en la siguiente solicitud de paginación.
cacheLocation cadena Define la ubicación en el servidor de EAN de la caché de la actual respuesta devuelta. Utilice este valor en la siguiente solicitud de paginación.
HotelList El contenedor de la matriz de HotelSummary.

Contiene atributos de size para indicar el número de establecimientos de la respuesta, así como activePropertyCount para indicar el número total de establecimientos activos (no necesariamente disponibles) en la ubicación especificada.

HotelList.HotelSummary objeto Matriz de hoteles individuales. La información de cada resultado de hotel está incluida en su propio nodo de HotelSummary.
Contiene el atributo order, que indica el orden numérico original de cada hotel con el fin de ayudar a iniciar la restauración a partir de la ordenación dinámica ulterior (la secuencia comienza en 0 y no en 1).
HotelSummary.hotelId cadena larga El ID del establecimiento. Este mismo identificador se usará en cualquier solicitud de reserva o habitación subsiguiente.
HotelSummary.name cadena El nombre del hotel.
HotelSummary.address1 cadena Dirección postal del hotel.
HotelSummary.city cadena Localidad donde está el hotel.
HotelSummary.stateProvinceCode cadena Código de dos caracteres correspondiente al estado o la provincia donde esté situada la localidad indicada. Este valor solamente se devuelve para los códigos de país US, CA y AU.

Referencias:
Códigos de estados de EE. UU.
Códigos de provincias y territorios de Canadá
Códigos de provincias y territorios de Australia
HotelSummary.countryCode cadena Código ISO-3166 de dos caracteres correspondiente al país donde esté situado el hotel.
HotelSummary.postalCode cadena El código postal del hotel.
HotelSummary.airportCode cadena El código de aeropuerto asociado con el hotel.
HotelSummary.supplierType cadena El proveedor del hotel. Ese mismo proveedor se utilizará para procesar cualquier reserva que se efectúe.

Valores:
E: Expedia Collect
HotelSummary.propertyCategory cadena La categoría del establecimiento devuelto.

Valores:
1: hotel
2: suite
3: complejo turístico
4: alquiler vacacional/apartamento
5: bed and breakfast
6: todo incluido
HotelSummary.hotelRating flotante Clasificación por estrellas (0-5) del hotel. Un valor de 0.0 o un valor en blanco indicarán que no hay ninguno disponible.
HotelSummary.hotelRatingDisplay cadena Devuelve un elemento Star o Alternate para indicar la fuente y el tipo de visualización requerido para el valor hotelRating.

Actualmente, solo los puntos de venta de Australia deben seguir los indicadores de visualización que se ofrecen. En el futuro, se añadirán jurisdicciones adicionales.

Star indica que la puntuación se realiza según el organismo de clasificación por estrellas local del hotel. Use las estrellas para mostrar hotelRating.

Alternate indica que hotelRating es un valor asignado por Expedia; no se disponía de una puntuación oficial. Utilice una visualización alternativa, como círculos o cuadrados, para indicar que no se trata de una puntuación oficial otorgada por un organismo local.

Devuelve valores solo para minorRev=30 y superior.
HotelSummary.shortDescription cadena Breve texto descriptivo aportado por el establecimiento. Si supera los 200 caracteres de máximo, aparecerá cortado.
Para un mejor rendimiento, añada un signo de elipsis (…) al final de este valor y configúrelo para enlazarlo a la página de disponibilidad de la habitación del establecimiento.
HotelSummary.locationDescription cadena El establecimiento introduce la ubicación general, por ejemplo, "cerca del mercado de Pike Place Market"
HotelSummary.lowRate cadena Tarifa mínima devuelta por el hotel en las consultas recientes. Se trata de una cifra estadística, que no supone necesariamente una tarifa para la disponibilidad actual.
Estos valor se devuelven siempre en USD.
HotelSummary.highRate cadena Tarifa máxima devuelta por el hotel en las consultas recientes. Se trata de una cifra estadística, que no supone necesariamente una tarifa para la disponibilidad actual.
Estos valor se devuelven siempre en USD.
HotelSummary.rateCurrencyCode cadena Código de divisa de las tarifas altas o bajas devueltas.
HotelSummary.latitude flotante Coordenada de latitud del hotel.
HotelSummary.longitude flotante Coordenada de longitud del hotel.
HotelSummary.proximityDistance flotante Distancia del hotel respecto a las coordenadas de origen especificadas originalmente, si se utilizó ese método de búsqueda.
HotelSummary.proximityUnit cadena La unidad de distancia que proporciona proximityDistance. MI o KM.
HotelSummary.hotelInDestination booleano Indica si el establecimiento está dentro de la localidad especificada originalmente o en un área más amplia, es decir, en un gran suburbio o una localidad cercana.

Los hoteles que se encuentran fuera del destino se agrupan por distancia con respecto al área original; por ejemplo, a menos de 10 millas, a menos de 20 millas, etc.
HotelSummary.thumbNailUrl cadena Ruta URL de una imagen en miniatura del establecimiento, si se ha proporcionado.

No se devuelven las URL completas. Debe complementar este valor con http://images.travelnow.com o con su propio subdominio de imágenes configurando un CNAME con origin-images.travelnow.com como destino. Se admite HTTPS con SSL.
cadena Enlace profundo que lleva a la página del hotel correspondiente en su plantilla. El formato devuelto solamente es compatible con cuentas de plantilla heredadas.
HotelSummary.RoomRateDetailsList contenedor de RoomRate
matriz de Details
Solamente es un contenedor, no se trata de atributos. Contiene todos los datos de elementos específicos de la habitación.
RoomRateDetailsList.RoomRateDetails matriz Contiene los detalles de la primera habitación devuelta por el hotel. Se devuelven nodos adicionales para cada habitación adicional si el valor de maxRatePlanCount que se envió fue >1
RoomRateDetails.roomTypeCode cadena Código de tipo de habitación de la habitación.
RoomRateDetails.rateCode cadena Código de la tarifa mostrada.
RoomRateDetails.maxRoomOccupancy entero Número máximo de huéspedes que puede alojar la habitación, incluidos los huéspedes que puedan provocar el cobro de tasas o cargos por añadir más personas.
RoomRateDetails.quotedRoomOccupancy entero Número máximo de huéspedes que puede alojar la habitación sin incurrir en el cobro de tasas o cargos por añadir más personas.
RoomRateDetails.minGuestAge entero Edad mínima de los huéspedes permitidos en la habitación.
RoomRateDetails.roomDescription cadena Descripción de la habitación asociada con el código roomTypeCode devuelto.
RoomRateDetails.promoId cadena ID de la oferta de promoción devuelta, si hay alguna. Bajo REST, este valor se devuelve como un número entero.
RoomRateDetails.promoDescription cadena Descripción de la oferta de promoción devuelta, si hay alguna. Se devolverá un máximo de 255 caracteres.
RoomRateDetails.promoDetailText cadena Los detalles adicionales de la promoción devuelta, si hay alguna.
RoomRateDetails.currentAllotment entero El número de habitaciones que se pueden reservar y quedan libres en el establecimiento. Utilice este valor para crear reglas de mensajería urgente con el fin de advertir a los usuarios de la baja disponibilidad en fechas de temporada alta o en establecimientos populares.

Si el valor se devuelve como 0, no indicará la ausencia de habitaciones en el establecimiento. Sencillamente, no se cumplieron las reglas necesarias para calcular el valor. Este valor no indica la disponibilidad absoluta.
RoomRateDetails.propertyAvailable booleano Solamente para referencia interna de inventario.
En las solicitudes estándar, solamente se devolverán los inventarios disponibles.
RoomRateDetails.propertyRestricted booleano Solamente para referencia interna de inventario. Consulte la política de cancelación para conocer las restricciones específicas que pueda haber.
RoomRateDetails.expediaPropertyId cadena El identificador o ID de Expedia para el hotel. Utilice este valor para asignarlo a un parámetro hotelId cuando se remita a Expedia.
RoomRateDetails.BedTypes matriz Las opciones de tipos de cama correspondientes a la habitación. Puede devolver un solo tipo de cama o una opción de elegir que se deba incluir al efectuar la reserva. Consulte los detalles de los tipos de cama.
Está disponible con un valor de minorRev=22 o superior. Solo se devuelve si se ha enviado includeDetails=true en la solicitud.
RoomRateDetails.smokingPreferences lista de cadenas separada por comas Preferencias para fumadores disponibles para la habitación, si es que las hay.

Valores:
NS: no fumadores
S: fumadores
E: indiferente

Está disponible con un valor de minorRev=22 o superior. Solo se devuelve si se ha enviado includeDetails=true en la solicitud.
RoomRateDetails.ValueAdds Contenedor de ValueAdd. Contiene una matriz de elementos de ValueAdd , si la hubiera, para la tarifa y habitación proporcionados. Tiene un atributo size con objeto de indicar el número de adiciones de valores que se devuelven.
ValueAdds.ValueAdd matriz

Contiene un elemento description para un servicio gratuito individual que se ofrece con la habitación y la tarifa proporcionadas, tales como desayuno o internet inalámbrico gratuitos.

Para los valores minorRev=28 y 29, no se devolverá el atributo numérico id y solamente se proporciona el valor description.

Para minorRev=30, se devuelve el atributo numérico id con un conjunto de valores diferentes de los devueltos para 26 y cifras inferiores. Ambos conjuntos de valores están disponibles en nuestra página de referencia de valores añadidos.

RoomRateDetails.RateInfos contenedor de RateInfo Contiene una matriz de elementos de RateInfo que proporcionan información de tarifas detallada para habitaciones individuales.

Si está utilizando una integración más antigua que se ejecuta en el valor de minorRev=6 o inferior, RateInfo se devolverá sin el contenedor RateInfos.

RateInfos.RateInfo objeto Contiene toda la información sobre tarifas correspondiente a una habitación dentro de varios objetos y valores individuales diferentes.

Atributos:
priceBreakdownbooleano Indica si se incluye un desglose completo del precio, incluidos impuestos y precio total que se cargará.
promo booleano Indica si la tarifa devuelta es una tarifa de promoción.
rateChange booleano Indica si la tarifa es diferente para al menos una de las noches que comprende la estancia.
RateInfo.promoId cadena ID de la oferta de promoción devuelta, si hay alguna.
RateInfo.promoDescription cadena Descripción de la oferta de promoción devuelta, si hay alguna. Se devolverá un máximo de 255 caracteres.
RateInfo.promoDetailText cadena Los detalles adicionales de la promoción devuelta, si hay alguna.
RateInfo.currentAllotment entero El número de habitaciones que se pueden reservar y quedan libres en el establecimiento. Utilice este valor para crear reglas de mensajería urgente con el fin de advertir a los usuarios de la baja disponibilidad en fechas de temporada alta o en establecimientos populares.

Si el valor se devuelve como 0, no indicará la ausencia de habitaciones en el establecimiento. Sencillamente, no se cumplieron las reglas necesarias para calcular el valor. Este valor no indica la disponibilidad absoluta.
RateInfo.cancellationPolicy cadena La política de cancelación del hotel correspondiente a esta habitación. Debe mostrarse en las páginas de habitaciones específicas, así como en cualquier página de reserva y de confirmación de reserva.
Solo se devuelve si se ha enviado includeDetails=true en la solicitud.
RateInfo.CancelPolicyInfoList contenedor de Cancel
PolicyInfo
Detalla datos específicos de la política de cancelaciones; generalmente, los plazos que determinan los períodos de penalización y las penalizaciones impuestas en caso de cancelación.
Solo se devuelve si se ha enviado includeDetails=true en la solicitud.
RateInfo.rateType cadena Indica si la tarifa devuelta se debe pagar por adelantado a través de EAN o se paga posteriormente en el hotel. Se devuelve con un valor de MerchantStandard para la disponibilidad de prepago, o bien no se devuelve nada para aquellas pagadas posteriormente.
RateInfo.nonRefundable booleano Indica de forma explícita si se puede reembolsar el importe de la reserva o no después de efectuar dicha reserva. También debería indicarse dentro de la política de cancelación devuelta. Este valor siempre tiene precedencia sobre cualquier dato divergente de la política.
Se devuelve solamente con la disponibilidad.
RateInfo.promoType cadena Indica si alguna de las promociones devueltas son específicas para dispositivos móviles o son promociones estándar. Devuelve Mobile en las promociones para dispositivos móviles y Standard en el resto.
Con objeto de que se devuelvan promociones para dispositivos móviles, debe identificar su sitio o aplicación para móviles mediante la cadena customerUserAgent apropiada.
RateInfo.ChargeableRateInfo objeto Los atributos de este objeto contienen el total absoluto que se cargará por la reserva, así como las medias y los totales de tarifas. Los nodos incluidos dentro del objeto proporcionan detalles sobre las tarifas por noches individuales y los recargos o cargos adicionales.

Atributos:
total cadena Total de tarifas por noche, impuestos y cargos adicionales que se cargará por la reserva. Es el valor total que se debe mostrar al cliente y se debe incluir en la solicitud de reserva.
surchargeTotal cadena Total de TaxAndServiceFee y ExtraPersonFee derivado de la matriz Surcharges.
nightlyRateTotal cadena El total de todos los valores de la matriz de nightlyRatesPerRoom que se incluye en este objeto.
maxNightlyRate cadena Tarifa por noche más alta de todas las tarifas devueltas.
currencyCode cadena Código de divida correspondiente a las tarifas devueltas.
commissionableUsdTotal cadena Importe utilizado para calcular las comisiones de asociados, en USD. Total de tarifas por noche menos cargos adicionales.
averageRate cadena Media de todas las tarifas por noche con los posibles valores de promoción aplicados, sin cargos adicionales.
averageBaseRate cadena Media de todas las tarifas por noche sin ningún valor de promoción aplicado, sin cargos adicionales. Devolverá el mismo valor anterior que si no hubiese presente ninguna promoción.
ChargeableRateInfo.
nightlyRatesPerRoom
matriz El contenedor de la matriz de NightlyRate. Tiene el atributo size para indicar el número de nodos de la matriz, que se corresponderá con el número de noches de la solicitud. Las tarifas se devuelven por orden secuencial a lo largo de la duración de la estancia.
nightlyRatesPerRoom.
NightlyRate
n/a

Proporciona la tarifa correspondiente a una sola noche dentro del ámbito de la estancia solicitada.

Indica la presencia de una tarifa de promoción, la tarifa base y la tarifa después de aplicar la promoción (si procede). Solamente contiene atributos.

Para solicitudes de varias habitaciones, este valor es la media del coste por noche entre todas las habitaciones. EAN recomienda el empleo de la nueva matriz ChargeableNightlyRates por habitación para la conversión de tarifas de varias habitaciones.

En caso de solicitudes de varias habitaciones con un valor de minorRev=28 e inferior, este elemento ofrece tarifas únicamente para la primera habitación en lugar de proporcionar la tarifa media.

Atributos:

promo booleano Indica si se aplica una tarifa de promoción a la tarifa de esta noche.
rate cadena Tarifa por noche después de aplicar la promoción, si es que se aplica alguna promoción.
baseRate cadena Tarifa por noche antes de aplicar la promoción, si es que se aplica alguna promoción.
ChargeableRateInfo.Surcharges matriz El contenedor de la matriz de Surcharge. Esta matriz desglosa los cargos adicionales individuales que conforman el valor que se devuelve para surchargeTotal. Tiene el atributo size para indicar el número de nodos de la matriz.
Surcharges.Surcharge n/a Detalla el tipo y el importe de un solo cargo adicional. Solamente contiene atributos.

Atributos:
amount flotante Importe del cargo adicional específico.
type cadena Nombre del cargo adicional.
Valores posibles:
  • TaxAndServiceFee
  • ExtraPersonFee
  • Tax
  • ServiceFee
  • SalesTax
  • HotelOccupancyTax

Solamente TaxAndServiceFee y ExtraPersonFee suman para el total de cargos adicionales surchargeTotal. El resto de los valores son componentes individuales del valor TaxAndServiceFee.


Nota: Los tipos de cargos adicionales SalesTax y HotelOccupancyTax se deben mostrar por ley estatal en Nueva York. Asegúrese de esperar y captar estos valores para mostrarlos como "Impuestos sobre ventas e impuestos por la estancia" en el desglose del precio final.
RateInfo.rateType cadena Indica si la tarifa devuelta se debe pagar por adelantado a través de EAN o se paga posteriormente en el hotel. Se devuelve con un valor de MerchantStandard para la disponibilidad de prepago, o bien no se devuelve nada para aquellas pagadas posteriormente.
Disponible con un valor de minorRev=18 o superior.
RateInfo.HotelFees matriz

Este elemento desglosa ciertos impuestos y tasas que cobra el hotel y que no se detallan específicamente en ningún otro lugar de la matriz de cargos adicionales "Surcharges".

El hotel carga todos los valores comprendidos en este elemento en la entrada o la salida del cliente. No forman parte de ningún cargo cobrado en el momento de realizar la reserva.

Al completarse, utilice este elemento para satisfacer los requisitos del formato de visualización de tarifas, impuestos y tasas que exigen los principales agregadores y motores de búsqueda.

Contiene el atributo size para indicar el número de cargos que se incluyen.
Disponible con un valor de minorRev=19 o superior.

Tenga en cuenta que el elemento secundario HotelFeeBreakdown se debe solicitar específicamente y requiere un valor de minorRev=24 o superior.

HotelFees.HotelFee ninguna Contiene atributos de la descripción, el importe y la divisa de una tasa. Detalla cualquier tasa del complejo turístico, impuestos estatales/locales, IVA o cualquier otra tarifa que sea obligatorio pagar.
Los cargos se devuelven en la divisa de la reserva que se indició en el atributo currencyCode de ChargeableRateInfo.

Atributos:
description cadena El tipo del cargo. Valores posibles:
  • MandatoryFee
  • MandatoryTax
  • ResortFee
amount cadena Valor total del cargo.
HotelFee.HotelFeeBreakdown ninguno Se devuelve si se ha enviado el elemento includeHotelFeeBreakdown en la solicitud. Detalla cómo se aplica la tasa que se proporciona en el elemento HotelFee y con qué frecuencia.

Nota: Todos los valores amount de HotelFee son totales. No los multiplique por ningún valor de frequency que se proporcione aquí.

Puede hacer una división por el valor de amount tal como se indica en el valor frequency para obtener el cargo por noche/día/semana, si lo desea.

Disponible con un valor de minorRev=24 o superior.

Atributos:
unit cadena Cómo se distribuye la tasa. Valores posibles:
  • Per Person
  • Per Room
  • Per accommodation
  • Per house
  • Per apartment
  • Per adult
frequency cadena Frecuencia de la tasa. Valores posibles:
  • Per Night
  • Per Day
  • Per Stay
  • Per week
ConvertedRateInfo objeto Información sobre la tarifa convertida a la divisa solicitada por el cliente. Este valor solamente se devuelve si el hotel no puede facturar con la divisa solicitada o no se puede facturar con esa divisa dentro de la región a la que pertenece el mercado del cliente. Contiene los mismos atributos que ChargeableRateInfo.
RoomGroup objeto Confirma el contenido del mismo objeto RoomGroup que se envió en la solicitud cuando se aplica a las tarifas proporcionadas.

Para el valor minorRev=29 y superior, contiene detalles sobre las tarifas por noche de cada habitación.
RoomGroup.Room matriz Confirma los valores de la habitación para numberOfAdults, numberOfChildren y childAges según se indica en la solicitud original.
Room.rateKey cadena Clave de la tarifa y los parámetros que la determinan.

Cada vez que se cambian los parámetros de búsqueda (cambio del recuento de huéspedes, diferentes fechas de la estancia, adición de niños, etc.), se debe enviar una nueva solicitud con el fin de obtener un nuevo valor para este parámetro.
Room.ChargeableNightlyRates matriz Contenedor de matriz de NightlyRate de la habitación. Las tarifas devueltas son específicas de la habitación individual y se devuelven por orden secuencial según la duración de la estancia.

Para obtener el coste medio por noche en varias habitaciones, utilice los valores proporcionados por el elemento nightlyRatesPerRoom.

Devuelve resultados solamente para minorRev=29 y valores superiores.
ChargeableNightlyRates.
NightlyRate
objeto Proporciona la tarifa correspondiente a una sola noche dentro del ámbito de la estancia solicitada. Al devolverlo en esta ubicación, las tarifas siempre son específicas para la Room correspondiente.

Indica la presencia de una tarifa de promoción, la tarifa base y la tarifa después de aplicar la promoción (si procede). Solamente contiene atributos.

Devuelve resultados solamente para minorRev=29 y valores superiores.

Atributos:
promo booleano Indica si se aplica una tarifa de promoción a la tarifa de esta noche.
rate cadena Tarifa por noche después de aplicar la promoción, si es que se aplica alguna promoción.
baseRate cadena Tarifa por noche antes de aplicar la promoción, si es que se aplica alguna promoción.
ChargeableNightlyRates.
ConvertedNightlyRates
objeto Información sobre la tarifa convertida a la divisa solicitada por el cliente. Este valor solamente se devuelve si el hotel no puede facturar con la divisa solicitada o no se puede facturar con esa divisa dentro de la región a la que pertenece el mercado del cliente. Contiene los mismos atributos que ChargeableNightyRates. Devuelve resultados solamente para minorRev=29 y valores superiores.
CachedSupplierResponse


El elemento CachedSupplierResponse se devuelve cuando se proporciona una respuesta en caché de lista de hoteles.

Atributos para el elemento CachedSupplierResponse:
Nombre Valor Descripción
cachedSupplierResponse objeto Contiene información sobre datos almacenados en caché, de uso interno. Se devuelve solamente con respuestas almacenadas en caché.
cacheEntryHitNum entero Interno
cacheEntryMissNum entero Interno
cacheEntryExpiredNum entero Interno
cacheRetrievalTime cadena larga Tiempo de recuperación de la caché.
supplierRequestNum entero Número de resultados solicitados del proveedor.
supplierResponseNum entero Número de resultados devueltos por el proveedor.
supplierResponseTime cadena larga Cómo de rápido devolvió el proveedor los resultados.
candidatePrepTime cadena larga Tiempo necesario para determinar o preparar la lista de solicitud de establecimientos.
tpidUsed entero Identificador interno basado en la divisa y los datos de ubicación.
matchedCurrency booleano Devuelve datos coincidentes o datos convertidos (extrapolados) desde la caché.
matchedLocale booleano Devuelve datos coincidentes o datos traducidos desde la caché.
extrapolatedCurrency booleano Devuelve datos coincidentes o datos convertidos (extrapolados) desde la caché. Los resultados del proveedor están en caché en inglés y USD, pero se convierten a la divisa y el idioma solicitados en el momento de efectuar la solicitud.
extrapolatedLocale booleano Devuelve datos coincidentes o datos traducidos desde la caché.