Recupere una lista de hoteles por ubicación o una lista de parámetros específicos hotelIds.

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 todas las propiedades activas 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 todas las propiedades activas 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 base
Nombre Valor Obligatorio Descripción
apiExperience cadena

Use este atributo para identificar el origen de su solicitud. Para cada solicitud que envíe, elija un valor aplicable del conjunto siguiente.

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 dispositivos móviles
PARTNER_MOBILE_APP - solicitud de una aplicación para dispositivos 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/API que sirve a su propia base de afiliación

arrivalDate cadena para búsqueda de disponibilidad

Fecha de registro de entrada con el formato MM/DD/AAAA

Incluya la fecha de hoy para solicitar disponibilidad en el mismo día. Las reservas se pueden realizar hasta las 23:59 de la hora local del hotel (21:59 para PST y las islas del Pacífico).

departureDate cadena para búsqueda de disponibilidad La fecha de registro de salida con el formato MM/DD/AAAA.

Se puede buscar la disponibilidad con un máximo de 500 días de antelación a partir de 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 devuelven por respuesta (antes de tener que pasar de página para ver más resultados). Se acepta un intervalo de valores de 1 a 200. El valor predeterminado es 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 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 infantiles.

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

Las propiedades 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. Obligatorio para todas las propiedades. Se utiliza junto con childAges para determinar la disponibilidad y las tarifas.
Room.childAges lista
separada por comas o matriz de enteros
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. Si no se proporcionan las edades de los niños antes de efectuar la reserva, se podrá incurrir en tasas por persona adicional inesperadas.
includeDetails booleano no

Devuelve políticas de cancelación de cada habitación, tipos de camas y preferencias para fumadores, según corresponda.

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. Está 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[room number, starting with 1]=
[number of adults],
[comma-delimited list of children's ages]


Por ejemplo, para declarar que una habitación tiene un adulto y dos niños de 5 y 12 años, debe enviar &room1=1,5,12. No existe una declaración independiente para el número de niños, ya que 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 hotelIds específicos.
Use únicamente uno de estos métodos a la vez.


Método 1: búsqueda por ciudad, estado o país
Nombre Valor Obligatorio para el método de búsqueda Descripción
city cadena
La ciudad donde se realizarán búsquedas. Utilice solo los nombres completos de las ciudades.
stateProvinceCode cadena para US,
CA, AU
Se trata de un código de dos caracteres correspondiente al estado o la provincia de la ciudad especificada. En el caso de Australia, debe usar los códigos especiales que se indican a continuación.

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 Australiana - AC
  • Nueva Gales del Sur - NW
  • Territorio del Norte - NO
  • Queensland - QL
  • Australia Meridional - SA
  • Tasmania - TS
  • Victoria - VC
  • Australia Occidental -WT
countryCode cadena
Código ISO-3166 de dos caracteres correspondiente al país de la ciudad especificada. Utilice solo los códigos de país que se muestran como "asignados de forma oficial" en la tabla de codificación de ISO-3166.


Método 2: uso de una cadena de destino de texto sin formato
Nombre Valor Obligatorio para el método de búsqueda Descripción
destinationString cadena Una cadena que contiene, al menos, el nombre de una ciudad. También puede enviar la ciudad y el estado; la ciudad y el país; la ciudad, el estado o el país, etc.

Este parámetro constituye la mejor opción para recopilar información directa del cliente.

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


Método 3: uso de una lista de parámetros hotelIds
Nombre Valor Obligatorio para el método de búsqueda Descripción
hotelIdList lista de enteros largos
separada por comas
Compruebe la disponibilidad de un conjunto determinado de hoteles. Envíe los valores 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 en 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. Utilice POST en lugar de GET al enviar listas de enteros largos mediante REST. El límite absoluto es de 2500 ID de hotel por solicitud.


Método 4: búsqueda en un área geográfica
Nota: puede utilizar este método para buscar aeropuertos junto con el archivo de coordenadas de aeropuertos.
Nombre Valor Obligatorio para el método de búsqueda Descripción
latitude cadena La coordenada de latitud del punto de origen de la búsqueda en el formato GGG.MMmmm.
longitude cadena Las coordenadas de longitud del punto de origen de la búsqueda en el formato GGG.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.
Mínimo de 1 MI o 2 KM; máximo de 50 MI u 80 KM. Los valores que excedan del máximo se reducirán automáticamente antes de que se devuelvan los resultados.
El valor predeterminado es 20 MI.
searchRadiusUnit cadena no Establece 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, se aplicará el orden de clasificación predeterminado a cualquier hotel que se encuentre 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 Busque una dirección postal local cercana. En la respuesta se incluirá la proximidad de cada propiedad con respecto a la dirección determinada.

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 Incluya el código postal de una dirección si lo desea.

Requiere que se definan los parámetros city y countryCode.
propertyName cadena Nombre con el que se buscará por disponibilidad. El valor puede ser un nombre exacto o parte de un nombre; por ejemplo, "Holiday" o "Best"
.
En la respuesta se incluirán todas las propiedades cuyos nombres contengan el valor comprendido en este parámetro.

Si se envía el nombre de una propiedad concreta, puede que se devuelva una respuesta vacía si no hay disponibilidad para las fechas de estancia proporcionadas.

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 utilizarse para actualizar de forma dinámica una página de resultados de la búsqueda existente. También se pueden utilizar de forma interna para limitar los resultados disponibles para los clientes; por ejemplo, para restringir propiedades con un determinado nivel mínimo de estrellas.

Nombre Valor Obligatorio 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.
Utilícelo si desea evitar que aparezcan en sus resultados hoteles de ciudades cercanas o de la periferia.
propertyCategory entero o lista de enteros delimitada por comas no

Filtra resultados por categoría de propiedades. Envíe un solo valor o una lista de valores con el fin de que se devuelva una combinación de categorías de propiedades.

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 de vacaciones/apartamento
5: cama y desayuno
6: todo incluido

maxStarRating flotante no Filtra resultados por una clasificación por estrellas máxima.
Son valores válidos del 1.0 al 5.0 en incrementos de 0.5.
minStarRating flotante no Filtra resultados por una clasificación por estrellas mínima.
Son valores válidos del 1.0 al 5.0 en incrementos de 0.5.
minRate flotante no Filtra resultados por propiedades con tarifas iguales o superiores al valor proporcionado.
Busca en el valor de respuesta de averageRate (media de las tarifas por noche individual durante las fechas de la estancia). Válido únicamente en búsquedas de disponibilidad.
maxRate flotante no Filtra resultados por propiedades con tarifas iguales o inferiores al valor proporcionado.
Busca en el valor de respuesta de averageRate (media de las tarifas por noche individual durante las fechas de la estancia). Válido únicamente en búsquedas de disponibilidad.
numberOfBedRooms entero no Este parámetro solo es válido para alquileres de vacaciones/apartamentos. Especifica el número de habitaciones solicitadas (cuatro como máximo).
maxRatePlanCount entero no Define el número de tipos de habitación que se devolverán con cada propiedad.

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

El valor predeterminado es 1, donde solamente se devuelve el primer tipo de habitación en cada propiedad. Durante la prueba de usuarios de Expedia se determinó que, con este valor, se obtenían las mejores tasas de conversión. Se recomienda que no se modifique; de este modo, no se mostrarán habitaciones adicionales durante la fase de selección de la habitación.

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 las propiedades preferidas y con mejor tasa de conversión se muestren en la parte superior. En lugar de ello, deje que los clientes elijan un orden de clasificación distinto después de que se devuelva la lista inicial.
Nombre Valor Obligatorio Descripción
sort cadena no La preferencia de clasificación para las propiedades que se devuelven.

Valores:
DEFAULT

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

BUDGET

Ordena por rentabilidad y da preferencia a los hoteles más económicos de cada mercado. Sitúa al principio los hoteles económicos con la tasa de consultas de reserva más rentable.

CHAMPION

Ordena por rentabilidad y da preferencia a los hoteles que se encuentran en el término medio de cada mercado. Sitúa al principio los hoteles de gama media con la tasa de consultas de reserva más rentable.

PREMIUM

Ordena por rentabilidad y da preferencia a los mejores hoteles de cada mercado. Sitúa al principio los hoteles de alta gama con la tasa de consultas de reserva más rentable.

PROMO Sitúa las propiedades con una tarifa de promoción o valor añadido por encima de las propiedades que no disponen de ninguna promoción activa.
PRICE_AVERAGE Clasifica los establecimientos por tarifa media por noche, de forma creciente. Esta clasificación no es perfecta, ya que se aplican algoritmos con funciones empresariales y de marketing a las listas de propiedades mediante la API. La mejor manera de obtener una clasificación precisa por precios dentro de su propio código es esperar a recibir los resultados.
PRICE_REVERSE Ordena las propiedades por tarifa por noche de forma decreciente. Tal y como hemos mencionado anteriormente, esta clasificación no es perfecta.
QUALITY Ordena las propiedades por clasificación por estrellas de forma decreciente.
QUALITY_REVERSE Ordena las propiedades por clasificación por estrellas de forma creciente.
PROXIMITY Ordena según la proximidad al punto de origen definido mediante los parámetros latitude y longitude.
TRIP_ADVISOR Si dispone de una integración con TripAdvisor aprobada, este valor ordenará los resultados por valoraciones de huéspedes de forma decreciente.
NO_SORT Se utilizan solamente junto con hotelIdList. Devuelve hoteles en el orden exacto que se indicó en la solicitud.
HIGH_MARGIN

Basada en la 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. HIGH_MARGIN Esta opción de clasificación 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. Normalmente se utiliza junto con los archivos de nuestra base de datos de hoteles como fuentes de información estática que normalmente suministra la API. Con las integraciones que utiliza este parámetro en conjunto con las bases de datos sin conexión, se obtendrán tiempos de respuesta mucho más rápidos que si se confía únicamente en las respuestas de la API.

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

Valores:
DEFAULT Devuelve todos los tres tipos de datos siguientes. 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 dinámica de tarifas. Se trata de la respuesta de disponibilidad con menos detalles.

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. Debe omitirse el resto de los 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 una duración habitual de 15-30 minutos.

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


Nombre Tipo Obligatorio 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 La clave de la respuesta en caché específica solicitada. Utilice el valor que se ha devuelto en la respuesta de lista de hoteles anterior.
cacheLocation cadena Define la ubicación del servidor de EAN de la memoria caché solicitada. Utilice el valor que se ha 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 se encuentran disponibles más resultados de propiedades en la página.

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 La clave para la memoria caché de la respuesta actual que se ha devuelto. Utilice este valor en la siguiente solicitud de paginación.
cacheLocation cadena Define la ubicación del servidor de EAN de la memoria caché de la respuesta actual que se ha devuelto. Utilice este valor en la siguiente solicitud de paginación.
HotelList contenedor de la matriz de HotelSummary

Contenedor de establecimientos individuales, proporcionado como una matriz de HotelSummary.

Atributos:
size cadena Indica el número de establecimientos individuales proporcionados en la respuesta. Permite un máximo de 200.
activePropertyCount cadena Indica el número total de establecimientos activos (no necesariamente disponibles) en la ubicación especificada.

Cuando se devuelve un gran número de establecimientos total y se paginan resultados adicionales, el valor de activePropertyCount se reducirá con cada respuesta consecutiva hasta que el recuento total sea menor que el máximo de 200 por respuesta.

Por ejemplo, si la respuesta inicial indica size=200 y activePropertyCount=1454, paginar para obtener más resultados devolverá el resultado size=200 y activePropertyCount=1254; después size=200 y activePropertyCount=1054, etc., hasta llegar a size < 200.

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 largo El ID de la propiedad. Este mismo ID se utilizará en todas las solicitudes de reserva o habitaciones posteriores.
HotelSummary.name cadena El nombre del hotel.
HotelSummary.address1 cadena Dirección postal del hotel
HotelSummary.city cadena Ciudad del hotel
HotelSummary.stateProvinceCode cadena Se trata de un código de dos caracteres correspondiente al estado o la provincia de la ciudad especificada. Solo devuelve códigos de país de EE. UU., Canadá y Australia.

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 El código ISO-3166 de dos caracteres correspondiente al país donde se ubica el hotel.
HotelSummary.postalCode cadena El código postal del hotel.
HotelSummary.airportCode cadena El código de aeropuerto asociado al hotel.
HotelSummary.supplierType cadena El proveedor del hotel. Este mismo proveedor se utilizará para procesar cualquier reserva que se realice.

Valores:
E: Expedia Collect
HotelSummary.propertyCategory cadena La categoría de la propiedad que se ha devuelto.

Valores:
1: hotel
2: suite
3: complejo turístico
4: alquiler de vacaciones/apartamento
5: cama y desayuno
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 deberán 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. Utilice las estrellas para mostrar hotelRating.

Alternate indica que hotelRating es un valor asignado por Expedia; no estaba disponible una clasificació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.

Se devuelve solo para minorRev=30 y superior.
HotelSummary.shortDescription cadena El texto de descripción breve que ha escrito la propiedad. Truncado si la entrada supera los 200 caracteres.
Para un mejor rendimiento, añada un signo de puntos suspensivos (…) al final de este valor y configúrelo para enlazarlo a la página de disponibilidad de la habitación de la propiedad.
HotelSummary.locationDescription cadena La propiedad introduce la ubicación general, por ejemplo, "cerca del mercado Pike Place Market".
HotelSummary.lowRate cadena No use este campo. Este valor ya no es objeto de mantenimiento.
HotelSummary.highRate cadena No use este campo. Este valor ya no es objeto de mantenimiento.
HotelSummary.rateCurrencyCode cadena El código de moneda de las tarifas altas o bajas que se devuelve.
HotelSummary.latitude flotante La coordenada de latitud del hotel.
HotelSummary.longitude flotante La coordenada de longitud del hotel.
HotelSummary.proximityDistance flotante La distancia del hotel desde las coordenadas del origen especificado inicialmente si se ha utilizado ese método de búsqueda.
HotelSummary.proximityUnit cadena La unidad de distancia que proporciona proximityDistance. MI o KM.
HotelSummary.hotelInDestination booleano Indica si la propiedad se encuentra en la ciudad especificada inicialmente o en un área ampliada; es decir, un barrio principal u otra ciudad 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 La ruta URL de una imagen en miniatura de la propiedad, siempre y cuando se haya proporcionado.

No se devuelven rutas URL completas. Debe complementar este valor con http://media.expedia.com. Se admite HTTPS con SSL.
cadena En desuso. No utilice los valores que devuelva.
HotelSummary.RoomRateDetailsList contenedor de la matriz de RoomRate
Details
Solo el contenedor, sin atributos. Contiene todos los datos de elementos específicos de la habitación.
RoomRateDetailsList.RoomRateDetails matriz Contiene los detalles de la primera habitación que devuelve el hotel. Se devuelven nodos adicionales para cada habitación adicional si el valor de maxRatePlanCount que se envió fue >1.
RoomRateDetails.roomTypeCode cadena El código del tipo de habitación para la habitación.
RoomRateDetails.rateCode cadena El código de la tarifa que se muestra.
RoomRateDetails.maxRoomOccupancy entero Cantidad máxima de huéspedes que se admite en la habitación, incluidos aquellos que puedan incurrir en tasas por persona adicional.
RoomRateDetails.quotedRoomOccupancy entero Cantidad máxima de huéspedes que se admite en la habitación sin incurrir en tasas por persona adicional.
RoomRateDetails.minGuestAge entero La edad mínima del huésped que se permite en la habitación.
RoomRateDetails.roomDescription cadena Descripción de la habitación asociada al parámetro roomTypeCode que se devuelve.
RoomRateDetails.promoId cadena El ID de la oferta de promoción que se devuelve, si lo hubiera. En REST, este valor devuelve un entero.
RoomRateDetails.promoDescription cadena La descripción de la oferta de promoción que se devuelve, si la hubiera. Se devolverán un máximo de 255 caracteres.
RoomRateDetails.promoDetailText cadena Los detalles adicionales de la oferta de promoción que se devuelve, si los hubiera.
RoomRateDetails.currentAllotment entero El número de habitaciones que se pueden reservar todavía en la propiedad. 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. Simplemente no se cumplieron las reglas necesarias para calcular el valor (este valor no indica disponibilidad total).
RoomRateDetails.propertyAvailable booleano Solo para referencia interna de inventario.
|Solo se devolverán inventarios disponibles en solicitudes estándar.
RoomRateDetails.propertyRestricted booleano Solo para referencia interna de inventario. Consulte la política de cancelación para conocer las restricciones específicas.
RoomRateDetails.expediaPropertyId cadena El 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 tipo de cama para la habitación individual. Es posible que se muestre un tipo de cama individual o una opción que se incluirá en el momento de 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 Las preferencias para fumadores disponibles correspondientes a la habitación, si las hubiera.

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.

En la minorRev=28 y la 29, no devolverá el atributo numérico id, ya que solo se proporciona description.

En la minorRev=30, devuelve el atributo numérico id con un conjunto de valores distinto al devuelto en la 26 y las anteriores a esta. Ambos conjuntos de valores están disponibles en nuestra página de referencia de servicios 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 de RateInfos.

RateInfos.RateInfo objeto Contiene la información de todas las tarifas correspondientes a una habitación individual en diferentes objetos y valores.

Atributos:
priceBreakdownbooleano Indica si se ha incluido un desglose del precio sin descuento que incluye los impuestos y el precio total que se cobrarán.
promo booleano Indica si la tarifa que se ha devuelto es promocional.
rateChange booleano Indica si la tarifa es diferente para, al menos, una de las noches de la estancia.
RateInfo.promoId cadena El ID de la oferta de promoción que se devuelve, si lo hubiera.
RateInfo.promoDescription cadena La descripción de la oferta de promoción que se devuelve, si la hubiera. Se devolverán un máximo de 255 caracteres.
RateInfo.promoDetailText cadena Los detalles adicionales de la oferta de promoción que se devuelve, si los hubiera.
RateInfo.currentAllotment entero El número de habitaciones que se pueden reservar todavía en la propiedad. 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. Simplemente no se cumplieron las reglas necesarias para calcular el valor (este valor no indica disponibilidad total).
RateInfo.cancellationPolicy cadena La política de cancelación del hotel para esta habitación. Se debe mostrar en las páginas de las habitaciones individuales, así como en las páginas de reserva y confirmación de la reserva.
Solo se devuelve si se ha enviado includeDetails=true en la solicitud.
RateInfo.CancelPolicyInfoList contenedor de Cancel
PolicyInfo
Los detalles específicos de la política de cancelación, normalmente las fechas que determinan el período de penalización, así como las sanciones que se aplicarán por dicha cancelación.
Solo se devuelve si se ha enviado includeDetails=true en la solicitud.
RateInfo.rateType cadena Indica si la tarifa que se devuelve se ha pagado previamente mediante EAN o 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 expresamente si se puede reembolsar la reserva después de efectuarla. Se debe indicar también en la política de cancelación que se devuelve. Este valor siempre tiene preferencia sobre otros datos diferentes de la directiva.
Solo se devuelve con disponibilidad.
RateInfo.promoType cadena Indica si se han devuelto promociones estándar o específicas para dispositivos móviles. 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 cobrará por la reserva, así como las tarifas medias y totales. Los nodos del objeto proporcionan detalles sobre los recargos y las tarifas por noche individuales.

Atributos:
total cadena El total de todos los recargos, impuestos y tarifas por noche que se cobrarán por la reserva. Se trata del valor total que se debe mostrar al cliente e incluir en la solicitud de reserva.
surchargeTotal cadena Total de TaxAndServiceFee y ExtraPersonFee de la matriz de 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 que se devuelven
currencyCode cadena Código de moneda de las tarifas que se devuelven.
commissionableUsdTotal cadena Importe en USD que se utiliza para calcular las compensaciones a los socios. Total de las tarifas por noche menos los recargos.
averageRate cadena Media de todas las tarifas por noche con cualquier valor de promoción aplicado (sin recargos).
averageBaseRate cadena Media de todas las tarifas por noche sin ningún valor de promoción aplicado (sin recargos). Se devolverá el mismo valor anterior si no existen promociones.
ChargeableRateInfo.
nightlyRatesPerRoom
matriz 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. Se devuelven las tarifas en orden secuencial para toda la duración de la estancia.
nightlyRatesPerRoom.
NightlyRate
n/a

Indica la tarifa para una sola noche dentro del período 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). Solo contiene atributos.

En el caso de solicitudes de varias habitaciones, este valor es la media del coste por noche en 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 ha aplicado una tarifa de promoción para esta tarifa por noche.
rate cadena Se aplica la tarifa por noche después de la promoción, si la hubiera.
baseRate cadena Se aplica la tarifa por noche antes de la promoción, si la hubiera.
ChargeableRateInfo.Surcharges matriz Contenedor de la matriz de Surcharge. Esta matriz desglosa los recargos 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 e importe de un solo recargo. Solo contiene atributos.

Atributos:
amount flotante El importe del recargo específico.
type cadena El nombre del recargo.
Valores posibles:
  • TaxAndServiceFee
  • ExtraPersonFee
  • Tax
  • ServiceFee
  • SalesTax
  • HotelOccupancyTax

Solo TaxAndServiceFee y ExtraPersonFee contribuyen a surchargeTotal. El resto de los valores son componentes individuales del valor TaxAndServiceFee.


Nota: los tipos de recargo SalesTax (Impuesto de ventas) y HotelOccupancyTax (Impuesto de ocupación del hotel) se deben mostrar por ley estatal en Nueva York. No se olvide de tener esto en cuenta y obtener estos valores para que se muestren como "Ocupación del hotel e impuesto sobre las ventas" en el desglose del precio final.
RateInfo.rateType cadena Indica si la tarifa que se devuelve se ha pagado previamente mediante EAN o posteriormente en el hotel. Se devuelve con un valor de MerchantStandard para la disponibilidad pagada previamente, o bien no se devuelve nada para aquellas pagadas posteriormente.
Está disponible con un valor de minorRev=18 o superior.
RateInfo.HotelFees matriz

Este elemento genera determinados impuestos y tasas que recopila el hotel y no se detallan en la matriz de recargos.

El hotel carga todos los valores de este elemento al registrar la entrada o la salida. No forman parte del pago que se realiza al efectuar 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.
Está 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 ninguno Contiene atributos para la descripción, el importe y la moneda de una sola 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 moneda de la reserva que se indicó en el atributo currencyCode de ChargeableRateInfo.

Atributos:
description cadena El tipo de cargo. Valores posibles:
  • MandatoryFee
  • MandatoryTax
  • ResortFee
amount cadena El 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 tarifa que se proporciona en el elemento HotelFee y con qué frecuencia.

Nota: todos los valores de amount 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 de frequency para obtener el cargo por noche/día/semana, si lo desea.

Está disponible con un valor de minorRev=24 o superior.

Atributos:
unit cadena Cómo se distribuye la tarifa. Valores posibles:
  • Per Person
  • Per Room
  • Per accommodation
  • Per house
  • Per apartment
  • Per adult
frequency cadena Frecuencia de la tarifa. Valores posibles:
  • Per Night
  • Per Day
  • Per Stay
  • Per week
ConvertedRateInfo objeto La información de la tarifa convertida a la moneda solicitada del cliente. Se devuelve solo si el hotel no puede facturar con la divisa solicitada o si esta se encuentra en la región de 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 La clave para la tarifa y los parámetros que determinan la tarifa.

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 en orden secuencial para toda 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 para minorRev=29 y superior.
ChargeableNightlyRates.
NightlyRate
objeto Indica la tarifa para una sola noche dentro del período 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). Solo contiene atributos.

Devuelve minorRev=29 y superior.

Atributos:
promo booleano Indica si se ha aplicado una tarifa de promoción para esta tarifa por noche.
rate cadena Se aplica la tarifa por noche después de la promoción, si la hubiera.
baseRate cadena Se aplica la tarifa por noche antes de la promoción, si la hubiera.
ChargeableNightlyRates.
ConvertedNightlyRates
objeto La información de la tarifa convertida a la moneda solicitada del cliente. Se devuelve solo si el hotel no puede facturar con la divisa solicitada o si esta se encuentra en la región de mercado del cliente. Contiene los mismos atributos que ChargeableNightyRates. Devuelve minorRev=29 y superior.
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 acerca de los datos en caché (uso interno). Solo se devuelve con respuestas en caché.
cacheEntryHitNum entero Interno.
cacheEntryMissNum entero Interno.
cacheEntryExpiredNum entero Interno.
cacheRetrievalTime largo El tiempo de recuperación de caché.
supplierRequestNum entero El número de resultados solicitado al proveedor.
supplierResponseNum entero El número resultados que devuelve el proveedor.
supplierResponseTime largo La velocidad con la que el proveedor devuelve los resultados.
candidatePrepTime largo El tiempo para determinar o preparar la lista de solicitud de propiedades.
tpidUsed entero El identificador interno basado en la moneda y la configuración regional.
matchedCurrency booleano Devuelve datos coincidentes o convertidos (extrapolados) desde la memoria caché.
matchedLocale booleano Devuelve datos coincidentes o traducidos desde la memoria caché.
extrapolatedCurrency booleano Devuelve datos coincidentes o convertidos (extrapolados) desde la memoria caché. (Los resultados del proveedor se almacenan en la memoria caché en inglés y USD, pero se convierten a la moneda y el idioma solicitados durante la respuesta).
extrapolatedLocale booleano Devuelve datos coincidentes o traducidos desde la memoria caché.