Recupera los datos de las habitaciones de un hotel específico que admiten el recuento de huéspedes proporcionado y cualquier otro criterio.

Esta solicitud puede realizarse con el fin de proporcionar datos para las páginas de selección de habitaciones u otras áreas de compra previas a la reserva, o bien para verificar los datos de precios antes de enviar una reserva.

El método 2 debe usarse antes de realizar una reserva. Este confirma los datos de disponibilidad y precios más actuales que se precisan para realizar correctamente una reserva.


Método 1: devolución de la disponibilidad y los precios de todas las habitaciones

Use este método para las páginas de selección de habitaciones u otras áreas de compra donde se requiera información sobre varias habitaciones de una propiedad.

Además de los elementos básicos que se requieren, también puede enviar los opcionales que se indican para solicitar imágenes de habitaciones o personalizar el tipo de información del hotel incluido en la respuesta.

Método 2: verificación de la habitación seleccionada durante el momento del pago

Use esta opción solo cuando el cliente haya seleccionado una habitación específica para reservar.

Con esta configuración de solicitud se recuperarán los datos de precios más actuales de la habitación que ha seleccionado el cliente. De este modo, se contribuye a reducir las probabilidades de que la reserva no se realice correctamente debido a un error de habitación completa o discrepancia de precio.

Name Required
apiExperience
hotelId
arrivalDate
departureDate
RoomGroup
includeRoomImages
includeHotelFeeBreakdown
options
Name Required
apiExperience
hotelId
arrivalDate
departureDate
RoomGroup
rateCode
roomTypeCode
includeDetails
includeHotelFeeBreakdown
Formatos de solicitud
URL de XML/REST: GET http://api.ean.com/ean-services/rs/hotel/v3/avail?
Elemento principal de XML: <HotelRoomAvailabilityRequest>
Requisitos de protocolo únicos
REST: Los recuentos de habitaciones y huéspedes tienen un formato diferente a XML. Consulte la sección de formato de habitaciones para REST de la página de lista de hoteles.

Tenga en cuenta lo siguiente: los parámetros requeridos para este servicio ahora están desglosados con los dos métodos de servicio proporcionados más arriba.

Parámetros de solicitud

Parámetros base
Nombre Valor Obligatorio para el método Descripción
apiExperience cadena 1&2 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

hotelId largo 1&2 El ID de la propiedad para consultar la disponibilidad de habitaciones.
arrivalDate cadena 1&2

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   1&2 Fecha de salida, en 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.
RoomGroup objeto 1&2 Contenedor de las matrices de Room que definen el recuento de habitaciones y huéspedes. Si ha utilizado REST en la solicitud de lista, recuerde continuar cumpliendo el formato de REST único.
RoomGroup.Room matriz 1&2 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 1&2 Cantidad 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.

Para evitar errores "sin resultados", limite siempre la ocupación a la maxRoomOccupancy máxima que se devuelve en la respuesta de la lista de hoteles del establecimiento.

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 1 y 2 en caso de que el recuento de niños sea > 0 Recuento de huéspedes infantiles de la habitación. Obligatorio para todas las propiedades si hay niños. Se utiliza junto con childAges para determinar la disponibilidad y las tarifas.
Room.childAges lista de enteros
separada por comas
1 y 2 en caso de que el recuento de niños sea > 0 Envía las edades individuales de los niños de la habitación como una lista separada por comas.

Algunos hoteles definen a los adultos de forma distinta a los niños, por lo que exija siempre esta información a los clientes cuando se especifique la presencia de niños entre los huéspedes. P. ej, un niño de 17 años puede considerarse adulto en un establecimiento e incurrir en tasas por persona adicional si una habitación ya está completa con los huéspedes adultos definidos previamente.
roomTypeCode cadena Solo 2 Se utiliza solo si ya se conoce la selección de habitación específica del cliente. Esto devolverá la política de cancelación, los tipos de cama y las preferencias para fumadores de la habitación.

Envíelo junto a rateCode
rateCode cadena Solo 2 Se utiliza solo si ya se conoce la selección de habitación específica del cliente. Esto devolverá la política de cancelación, los tipos de cama y las preferencias para fumadores de la habitación.

Envíelo junto a roomTypeCode
includeDetails booleano Solo 2 Se utiliza para el método 2 una vez que el cliente haya seleccionado una habitación.

Envíelo como true para devolver datos de tarifa listos para reservar para los códigos de habitación y de tarifa proporcionados.

Envíelo junto con roomTypeCode y rateCode
includeRoomImages booleano no Recupera las imágenes de nivel de habitación para el hotelId especificado.

También se encuentra disponible como solicitud independiente.
includeHotelFeeBreakdown booleano no Devuelve 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.
options cadena o lista de cadenas
separada por comas
no Utilice este parámetro en lugar de una solicitud de información sobre hoteles independiente cuando utilice el método 1 para rellenar las opciones de habitación de un establecimiento.

Envíe un solo valor o una combinación de valores en una lista separada por comas.

Valores:
HOTEL_DETAILS Recupera solo los detalles del hotel (descripción de la propiedad).
ROOM_TYPES Recupera tipos de habitación.
ROOM_AMENITIES Recupera la lista de servicios de la habitación (cocina básica, TV, etc.).
PROPERTY_AMENITIES Recupera la lista de servicios de la propiedad (spa, gimnasio o salas de conferencia).
HOTEL_IMAGES Recupera solo las URL de imágenes de hoteles (no las imágenes de las habitaciones).
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).
supplierType cadena no Proporcione el mismo valor que se ha devuelto en la respuesta de lista de hoteles anterior.

Valores:
E: Expedia Collect
rateKey cadena no La clave de los parámetros que determinaron la tarifa proporcionada en la respuesta de lista de hoteles anterior.
Respuesta de habitación de hotel
Devuelve las habitaciones del hotel concreto solicitado que admitan el recuento de huéspedes indicado durante los días de estancia especificados, o confirma la disponibilidad y los precios de los roomTypeCode y rateCode proporcionados.

Esta respuesta también devuelve instrucciones de registro de entrada, más detalles de propiedades, información de tarifas detalladas y, lo que resulta más importante, el rateKey requerido para la reserva.

Si el objeto options se incluyó en la solicitud del método 1, también se devolverán los detalles especificados en el objeto, si los hubiera.

Contenido de la respuesta
Elemento principal: HotelRoomAvailabilityResponse
Atributo: size: número de habitaciones que se devuelven.

Nombre Valor Descripción
hotelId largo El ID de la propiedad. Este mismo ID se utilizará en todas las solicitudes de reserva posteriores.
arrivalDate cadena Confirma la fecha de registro de entrada de la solicitud.
departureDate cadena Confirma la fecha de registro de salida de la solicitud.
hotelName cadena El nombre del hotel.
hotelAddress cadena Dirección postal del hotel
hotelCity cadena Ciudad del hotel
hotelStateProvince 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 estado 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
hotelCountry cadena El código ISO-3166 de dos caracteres correspondiente al país donde se ubica el hotel.
numberOfRoomsRequested entero Confirma el número de nodos de Room enviados en la solicitud.
checkInInstructions cadena Se debe mostrar si la propiedad lo devuelve.
Puede incluir las tasas que se aplicarán en el registro de entrada, las instrucciones para registros de entrada tardíos, etc.
specialCheckInInstructions cadena Contiene información crucial para el registro de entrada, como un requisito de notificar al establecimiento la hora de llegada estimada. Muestre esta información en el mismo área que las instrucciones para realizar la entrada primarias.
HotelRoomResponse matriz Cada nodo contiene las tarifas y los detalles de una habitación individual del hotel. El formato de respuesta JSON de este matriz podría provocar problemas en Axis.
HotelRoomResponse.policy cadena Las políticas diversas adicionales; por ejemplo, el documento de identidad con fotografía que se requiere en el registro de entrada.
HotelRoomResponse.rateCode cadena El código de la tarifa que se muestra.
HotelRoomResponse.roomTypeCode cadena El código del tipo de habitación para la habitación.

Si el parámetro options se ha enviado en la solicitud de disponibilidad de habitaciones, no se devolverá este elemento. En lugar de ello, el valor se envía como atributo de roomCode del objeto RoomType.
HotelRoomResponse.rateDescription cadena

Una breve descripción de la habitación y la tarifa que se va a cargar, por ejemplo, Habitación de lujo con cama de matrimonio (todo incluido).

Recomendado para la visualización principal

HotelRoomResponse.roomTypeDescription cadena Una breve descripción del tipo de habitación, por ejemplo, Habitación de lujo con cama de matrimonio.

Si el parámetro options se ha enviado en la solicitud de disponibilidad de habitaciones, no se devolverá este elemento. En lugar de ello, el valor se envía como el elemento de description del objeto RoomType.
HotelRoomResponse.supplierType cadena El proveedor del hotel. Este mismo proveedor se utilizará para procesar cualquier reserva que se realice.

Valores:
E: Expedia Collect
HotelRoomResponse.otherInformation cadena Otra información diversa del hotel, si procede.
HotelRoomResponse.propertyId cadena El ID de Expedia para el hotel. Utilice este valor para asignarlo a un parámetro hotelId cuando se remita a Expedia.
HotelRoomResponse.smokingPreferences lista de cadenas separada por comas Las preferencias para fumadores disponibles correspondientes a la habitación, si procede.

Valores:
NS: no fumadores
S: fumadores
E: indiferente
HotelRoomResponse.minGuestAge entero La edad mínima de cualquiera de los huéspedes de la habitación, por ejemplo, 18 o 21 si no se admiten niños. Se devolverá como 0 (no se devolverá si no hay edad mínima).
HotelRoomResponse.quotedOccupancy entero Cantidad máxima de huéspedes que se admite en la habitación sin incurrir en tasas por persona adicional.
HotelRoomResponse.rateOccupancyPerRoom entero Cantidad máxima de huéspedes que se admite en la habitación, incluidos aquellos que puedan incurrir en tasas por persona adicional. maxRoomOccupancy equivalente en la respuesta de la lista.

Si este valor supera el de quotedOccupancy, consulte las tasas por persona adicional en la matriz Surcharges y notifíquelas a los usuarios según corresponda.
cadena En desuso. No utilice los valores que devuelva.
HotelRoomResponse.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.
HotelRoomResponse.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 minorRev=28 y superior, no devolverá el atributo numérico id; solo se proporciona description. Debe usar al menos minorRev=28 para devolver valores añadidos en sus respuestas de itinerario y reserva.

Cuando se utilice minorRev=26 o inferior, se devolverán los siguientes atributos conocidos de id con sus valores description.

ID description
1 Pensión completa
2 Desayuno continental
4 Desayuno completo
8 Desayuno inglés
16 Almuerzo gratuito
32 Cena gratuita
64 Crédito para comida y bebida
128 Aparcamiento gratuito
256 Aparcamiento en aeropuerto gratuito
512 alojamiento Todo incluido
1024 Internet de alta velocidad gratuito
2048 Internet inalámbrico gratuito
4096 Desayuno continental para 2
8192 Desayuno para 2
16384 Aparcamiento con asistencia gratuito
32768 Transporte desde/hasta el aeropuerto gratuito
65536 Mejora de categoría de la habitación gratuita
131072 Crédito para complejo turístico incluido
262144 Detalle de bienvenida a la llegada
524288 Crédito para spa
1048576 Crédito para golf
2097152 Acceso VIP a clubes nocturnos
4194304 2 x 1 en bufé
8388608 Alquiler y entrada de telesilla gratuitos
16777216 Bufé de desayuno
33554432 Media pensión
67108864 Pensión completa
134217728 Cocina completa
268435456 Juego en máquinas tragaperras
536870912 Crédito para casino
1073741824 Cupón de juego
HotelRoomResponse.RoomImages matriz La matriz de las URL de imágenes de nivel de habitaciones disponibles, en caso de que se haya solicitado mediante el parámetro includeRoomImages .
HotelRoomResponse.RoomType objeto Se devuelve cuando se envía el parámetro options con un valor de ROOM_TYPES o ROOM_AMENITIES.

Atributos:
roomCode: sustituye al elemento roomTypeCode
roomTypeId
RoomType.description cadena Sustituye al elemento roomTypeDescription. 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.
RoomType.descriptionLong cadena Una descripción más detallada de la habitación, si se encuentra disponible.
RoomType.roomAmenities matriz Una lista de servicios de la habitación si se encuentra disponible (el mismo contenido y la misma estructura que se muestra en la respuesta de información del hotel).
RoomType.HotelDetails objeto Contendido de la descripción del hotel (el mismo contenido y la misma estructura que se muestra en la respuesta de información del hotel).
RoomType.PropertyAmenities objeto Información de los servicios del hotel (el mismo contenido y la misma estructura que se muestra en la respuesta de información del hotel).
RoomType.HotelImages objeto Información de las imágenes del hotel (el mismo contenido y la misma estructura que se muestra en la respuesta de información del hotel).
HotelRoomResponse.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 con minorRev=6 o una versión anterior, RateInfo devolverá el resultado sin el contenedor RateInfos.
RateInfos.RateInfo objeto Contiene la información de todas las tarifas correspondientes a una habitación individual en diferentes objetos y valores.

Atributos:
priceBreakdown booleano 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.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 objeto Los elementos secundarios del objeto confirman el valor de numberOfAdults, numberOfChildren y childAges específicos que se utilizan para calcular las tarifas que se proporcionan.
Room.rateKey objeto La clave para los parámetros de búsqueda y otros valores que determinan la tarifa

Tenga en cuenta que este valor siempre será diferente del valor que se devuelve en la respuesta de disponibilidad del hotel; siempre se omite el valor de este respuesta en la solicitud de respuesta.

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.

Para un valor de minorRev=18 e inferior, este elemento se devolverá en el cuerpo principal de la respuesta.
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 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 flotante Se aplica la tarifa por noche después de la promoción, si la hubiera.
baseRate flotante Se aplica la tarifa por noche antes de la promoción, si la hubiera.
ChargeableNightlyRates.NightlyRate 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.

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.
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.nonRefundable booleano Indica si la reserva no se puede reembolsar. Se debe mostrar si se devuelve; todos los cargos son definitivos después de que la reserva se efectúe correctamente. Este valor siempre tiene preferencia sobre otros datos diferentes de la directiva.
RateInfo.depositRequired booleano Siempre se devuelve como true para Expedia Collect.
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.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 propiedades populares.

Si el valor se devuelve como 0, no indicará la ausencia de habitaciones en la propiedad. 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.
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.
Revise los detalles de la matriz de CancelPolicyInfo (Información de la política de cancelación)
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 flotante 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 flotante Total de TaxAndServiceFee y ExtraPersonFee de la matriz de Surcharges. Expedia cobra estas tarifas al efectuar la reserva.
nightlyRateTotal flotante El total de todos los valores de la matriz de nightlyRatesPerRoom que se incluye en este objeto.
maxNightlyRate flotante 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 flotante Importe en USD que se utiliza para calcular las compensaciones a los socios. El total de las tarifas por noche menos los recargos.
averageRate flotante Media de todas las tarifas por noche con cualquier valor de promoción aplicado (sin recargos).
averageBaseRate flotante La 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 flotante Se aplica la tarifa por noche después de la promoción, si la hubiera.
baseRate flotante Se aplica la tarifa por noche antes de la promoción, si la hubiera.
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.
ChargeableRateInfo.Surcharges matriz

Contenedor de la matriz de Surcharge. Detalles de los cargos que contribuyen a TaxAndServiceFee y surchargeTotal.

Expedia aplica y cobra todos los impuestos y las tasas contenidos en esta matriz al efectuar la reserva.

Contiene 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. Solamente contiene atributos.

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

Atributos:

amount flotante El importe del recargo específico.
type cadena

El nombre del recargo.
Valores posibles:

Componentes de surchargeTotal:

  • TaxAndServiceFee
  • ExtraPersonFee

Componentes de TaxAndServiceFee:

  • Tax
  • ServiceFee
  • SalesTax
  • HotelOccupancyTax
  • PropertyFee

Reglas de visualización importantes:

• Los tipos de recargos SalesTax y HotelOccupancyTax deben mostrarse obligatoriamente por imposición de la legislación estatal en el Estado de 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.

• El recargo PropertyFee debe mostrarse al empezar la página de selección de habitación de hotel inicial, inmediatamente después de su página de resultado de búsqueda de hoteles. Este es un requisito de la Comisión federal de comercio de EE. UU. (Federal Trade Commission, FTC).

Debe mostrar este recargo como "Tasa del establecimiento" en su página de selección de habitaciones, según se describe más arriba, en todos los desgloses de precios subsiguientes para los siguientes puntos de venta:

  • EE. UU.
  • Canadá
  • Brasil
  • América Latina
RateInfo.HotelFees matriz

El hotel aplica y cobra todas las tasas o tarifas detalladas dentro de esta matriz durante el registro de llegada o salida.

Estas tarifas no las aplica ni cobra Expedia; son completamente independientes de las que se detallan en la matriz Surcharges.

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 contiene.

HotelFees.HotelFee ninguno

Contiene atributos de la descripción, el importe y la divisa de una tasa.

Detalla el total de cualesquiera tasas de IVA, impuestos estatales o locales, tasas del complejo turístico o cualesquiera otras tarifas cobradas que no se puedan evitar de una forma razonable.

Ejemplo: Un cargo de 10 USD por una estancia de cuatro días se representa mediante un valor de 40.00

Los cargos se indican en la moneda indicada por el atributo currencyCode de ChargeableRateInfo.

Atributos:

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

Atributos:
unit cadena Cómo se distribuye la tarifa. Valores posibles:
  • Per Person
  • Per Room
  • Per acommodation
  • Per house
  • Per apartment
  • Per adult
frequency cadena Frecuencia de la tarifa. Valores posibles:
  • Per Night
  • Per Day
  • Per Stay
  • Per week

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

RateInfo.ConvertedRateInfo objeto La información de la tarifa convertida a la moneda solicitada del cliente. Se devuelve solo si la moneda que se cargará y la convertida son diferentes; es decir, si el hotel no puede aceptar la moneda solicitada del cliente. Contiene los mismos atributos que ChargeableRateInfo.