Solicita una reserva de las habitaciones especificadas. Esta solicitud se debe enviar con el método POST mediante HTTPS para proteger la información de pago del cliente. La información remitida en esta solicitud está sujeta a los métodos de validación de seguridad y de fraude propios de EAN.

La información de la tarjeta de crédito facilitada en la solicitud se utilizará para efectuar un prepago directo de la reserva. La reserva del cliente se paga en su totalidad (salvo extras como el servicio de habitaciones) en cuanto se recibe una respuesta correctamente, aunque la reserva se efectúe con meses de antelación.

Asegúrese de utilizar el par cid/apiKey correcto en las reservas activas. Es esencial para realizar reservas correctamente y para garantizar que cualquier comisión obtenida se abone en la cuenta correcta.

Si experimenta errores de validación de entrada en los valores city, address o firstName y lastName, tenga en cuenta que actualmente la API solo admite los conjuntos de caracteres UTF-8 Basic Latin y Latin-1 Supplement. Aquellos idiomas que empleen caracteres que estos conjuntos no admitan, como "ő" o "ű" se deben filtrar o convertir para evitar errores de entrada.


Formatos de solicitud
URL de XML/REST: POST https://book.api.ean.com/ean-services/rs/hotel/v3/res
Elemento principal de XML: <HotelRoomReservationRequest>

Para evitar problemas de restricción de longitud de las URL, envíe todos los valores del cuerpo de POST como datos application/x-www-form-urlencoded. No envíe parámetros dentro de la cadena de la URL en sí.
Para las solicitudes XML, es preciso enviar elementos comunes con el mismo formato utilizado para solicitudes GET. No intente adaptar el formato de estos valores como elementos XML dentro del cuerpo de POST.



Parámetros de la solicitud

Parámetros de URL específicos del servicio
Nombre Valor Requerido Descripción
currencyCode cadena Utilice siempre el valor de atributo que se ha devuelto en el nodo de ChargeableRateInfo (Información sobre el importe a cargar) de la respuesta anterior al rellenar este parámetro para una solicitud de reserva.
Utilizar otras fuentes para este valor podría causar errores de coincidencia.
additionalData contenedor de MapEntry no

Utilice este parámetro exclusivo de reservas para ayudar a realizar un seguimiento de las reservas en el Centro de afiliados de EAN. En nuestra página sobre seguimiento de reservas puede consultar la documentación completa.



Parámetros básicos
Nombre Tipo 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

hotelId cadena larga ID del establecimiento para la reserva que se va a solicitar
arrivalDate cadena

Fecha de entrada, en formato MM/DD/AAAA. Transfiera el valor de la respuesta sobre la habitación.

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 Fecha de salida, en formato MM/DD/AAAA. Transfiera el valor de la respuesta sobre la habitación.
supplierType cadena Define el proveedor que se utilizará para efectuar la reserva. Transfiera el valor de la respuesta sobre la habitación.

Valores:
E: Expedia Collect
rateKey cadena Valida los parámetros indicados en la solicitud de reserva. Transfiera el valor de la respuesta sobre la habitación. Utilice la rateKey devuelta en el primer objeto Room de la respuesta de habitación para lograr un rendimiento óptimo.

Si se utiliza cualquier otro valor diferente al que se proporcionó en la respuesta de habitación, se producirá un error en la reserva.

Si opta por permitir que los clientes modifiquen cualquier parámetro en la fase de reserva, reenvíe esos parámetros en una nueva solicitud de habitación para obtener un nuevo valor válido para este parámetro.

Los errores de "Invalid QueryId" o los errores de caché de tarifas indican que la clave ha caducado o no es válida. Vuelva a enviar la solicitud de habitación anterior para obtener un nuevo valor, aunque no haya cambiado ningún parámetro.
roomTypeCode cadena Código que designa la habitación específica solicitada. Obténgalo siempre de forma dinámica a partir de la respuesta de habitación anterior.

Envíelo junto con rateCode
rateCode cadena Código que designa la tarifa relacionada con la habitación específica solicitada. Obténgalo siempre de forma dinámica a partir de la respuesta de habitación anterior.

Envíelo junto con roomTypeCode
RoomGroup objeto Contenedor de las matrices de Room que definen el recuento de habitaciones y huéspedes. Utilice los mismos valores para adultos, niños y edades de los niños según estaban definidos en la anterior solicitud de habitación.

En las reservas se requieren específicamente parámetros adicionales para este objeto; véase a continuación.
RoomGroup.Room matriz El número de nodos de Room define el número de habitaciones solicitadas. Incluya el mismo número de nodos y los mismos parámetros de edades o el mismo recuento de huéspedes que estaban definidos en la anterior solicitud de habitación.
Room.numberOfAdults entero Recuento de huéspedes adultos de la habitación. Utilice el mismo valor que estaba definido en la anterior solicitud de habitación.
Room.numberOfChildren entero en caso de que > 0 Recuento de huéspedes infantiles de la habitación. Utilice el mismo valor que estaba definido en la anterior solicitud de habitación.
Room.childAges lista de enteros
separada por comas
en caso de que el recuento de niños sea > 0 Edades de los huéspedes infantiles, si hay alguno. Utilice el mismo valor que estaba definido en la anterior solicitud de habitación. EAN considera que las personas comprendidas entre los 0 y 17 años de edad son niños.
Room.firstName cadena Nombre de pila completo del huésped que realiza la entrada de registro para la reserva. El nombre debe coincidir con el ID de la foto del huésped cuando registre su entrada en el establecimiento.

Se permite un máximo de 25 caracteres y no se pueden utilizar fórmulas de encabezamiento ni nombres de empresa. No es necesario que los nombres de los huéspedes sean exclusivos para cada habitación.
Room.lastName cadena Apellidos completos del huésped que realiza la entrada de registro para la reserva. El nombre debe coincidir con el ID de la foto del huésped cuando registre su entrada en el establecimiento.

Se permite un máximo de 40 caracteres y no se pueden utilizar fórmulas de encabezamiento ni nombres de empresa. No es necesario que los nombres de los huéspedes sean exclusivos para cada habitación.
Room.bedTypeId cadena Código de la opción de cama elegida por el cliente (o un valor único si no se ofrecieron distintas opciones).

Transfiera el valor que coincida desde el atributo BedType ID desde la habitación seleccionada por el cliente en la respuesta de habitación.

Las opciones entre diferentes tipos de cama para la misma habitación solo son solicitudes que puede que el hotel no atienda si no hay disponibilidad.
Room.numberOfBeds entero no Valor de 1 de 2. Solo para solicitudes: ofrézcalo solamente si resulta lógico basándose en las opciones de BedType devueltas en la respuesta de habitación.
Room.smokingPreference cadena si se utiliza Preferencia para fumadores solicitada. Omita este elemento por completo de su solicitud si no es necesario para una reserva concreta.

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

Incluya solo los valores devueltos en la respuesta de habitación. No use los valores anteriores como selecciones no modificables. Incluir un valor no proporcionado en la respuesta provocará un error en la reserva. No envíe varios valores.
affiliateConfirmationId cadena Valor designado para realizar un seguimiento de las reservas y ayudar a prevenir la duplicación de reservas.

Genere un valor único como ID de GUID (máximo 36 caracteres) antes de enviar la reserva. Si la API detecta el valor asociado con una reserva existente, evitará todas las reservas y duplicaciones subsiguientes.

Para evitar el rechazo de reintentos de reserva válidos, cree siempre un valor nuevocuando trate de volver a realizar una reserva que no se haya efectuado correctamente debido a un error que no se deba a una finalización del tiempo de espera.
affiliateCustomerId cadena no ID de cliente opcional adicional para usar con el sistema de seguimiento del asociado. Utilice este ID solo internamente, ya que una revelación accidental puede permitir que se recuperen itinerarios que no pertenezcan al cliente.
itineraryId largo no

Si una solicitud de reserva inicial devuelve un error de tarjeta de crédito, tome este valor de la respuesta e inclúyalo en cualquier intento subsiguiente de reserva.

Cuando se vuelva a transferir, este valor se empareja con el registro del itinerario existente que se generó en la primera solicitud. Cualquier rechazo o error repetido de tarjeta de crédito se confinará a un único registro, para evitar la aparición de varias cancelaciones en las estadísticas.

Solamente debe mostrar este valor a los clientes si utiliza el servicio de atención al cliente de EAN (no tiene sus propios agentes de atención al cliente).

No vuelva a enviar este valor si se devuelve como -1. Eso indica que no se creó un itinerario. Vuelva a empezar con una solicitud nueva después de enviar el error con un mensaje y permitir que el cliente realice correcciones si son necesarias.

chargeableRate cadena Importe total que se cargará por la reserva.

Transfiera el valor de total del objeto ChargeableRateInfo devuelvo en la respuesta de habitación.

Cuando se envíe la solicitud, se validará esta tarifa con respecto a la última conocida para los códigos de tarifa y habitación proporcionados. Si la última tarifa es superior, se devolverá un error con la nueva tarifa superior y su valor de rateKey coincidente. Si es inferior, la solicitud pasa con la nueva tarifa más baja.
specialInformation cadena no

Permite que el cliente añada información adicional o solicitudes para enviar al establecimiento.

La información que aquí se incluye es solo una solicitud y no está garantizada. No utilice este campo para comunicar solicitudes de servicio de atención al cliente B2B o enviar información financiera/personal confidencial.

Tiene una longitud máxima de 256 caracteres sin saltos de líneas ni retornos de carro. Cualquier salto de línea o retorno de carro para los que no se haya eliminado este parámetro provocará un error irreparable.

sendReservationEmail booleano no

Envíelo como false si envía sus propios correos electrónicos de confirmación, de lo contrario, omítalo.

Utilice este parámetro solamente si ya ha consultado a su gestor responsable de cuentas o al servicio de atención al cliente sobre su propio sistemas de correo electrónico para confirmación.

Parámetros de información de pago
Estos parámetros definen la información que se utiliza para validar y cargar la tarjeta de crédito del cliente a la hora de efectuar los pagos.

La información de pago se proporciona mediante los objetos ReservationInfo y AddressInfo. Los valores aplicables para ambos objetos se validan comparándolos con la información de la entidad bancaria emisora correspondiente al titular de la tarjeta.

Algunos sistemas que se usan para la validación y el procesamiento de pagos no admiten caracteres no latinos. Compruebe que solamente se permiten valores en caracteres latinos para todos los parámetros, así evitará errores de validación de datos.

Consulte nuestras mejores prácticas para solicitar y procesar la información de la tarjeta en la
sección de validación de nuestra página acerca de tipos de tarjetas de crédito.

Nombre Valor Requerido Descripción
ReservationInfo objeto Contiene la información de contacto y de la tarjeta de crédito del cliente.
ReservationInfo.email cadena Dirección de correo electrónico del cliente. El correo electrónico de confirmación de EAN (travelnow.com) se envía automáticamente a esta dirección. Debe ser una dirección de correo electrónico, aunque su integración trate este campo como si fuese solamente de uso interno.
Se permite un máximo de 50 caracteres para la dirección completa, incluidos los símbolos @ y .
ReservationInfo.firstName cadena Nombre de pila completo del titular de la tarjeta de crédito.
Se permite un máximo de 25 caracteres y no se pueden utilizar fórmulas de encabezamiento ni nombres de empresa.
ReservationInfo.lastName cadena Apellidos completos del titular de la tarjeta de crédito.
Se permite un máximo de 40 caracteres y no se pueden utilizar fórmulas de encabezamiento ni nombres de empresa.
ReservationInfo.homePhone cadena

Número de teléfono del domicilio del cliente. Lo utilizará un agente del servicio de atención al cliente si es necesario ponerse en contacto con el cliente para resolver un problema relacionado con su reserva.

Los números deben tener como mínimo 5 dígitos de extensión. Restrinja los caracteres a 0-9, +, - y ( ).

ReservationInfo.workPhone cadena no Número de teléfono del trabajo del cliente. Los números deben tener como mínimo 5 dígitos de extensión. Restrinja los caracteres a 0-9, +, - y ( ).
ReservationInfo.extension cadena no Extensión del número de teléfono del trabajo del cliente, si es necesaria. Se permiten 5 caracteres como máximo.
ReservationInfo.faxPhone cadena no Número de fax del cliente. Los números deben tener como mínimo 5 dígitos de extensión. Restrinja los caracteres a 0-9, +, - y ( ).
ReservationInfo.companyName cadena no Nombre de la empresa, si es necesario para emitir facturas de viaje como empleado o a efectos fiscales.
ReservationInfo.creditCardType cadena Tipo de tarjeta de crédito utilizada. Revise esta página para conocer los valores específicos correspondientes a los tipos de tarjetas de crédito y detalles sobre la validación.
ReservationInfo.creditCardNumber cadena Número de la tarjeta de crédito del cliente.
ReservationInfo.creditCardIdentifier cadena Número de identificación de la tarjeta de crédito o valor de seguridad de la tarjeta (CSV o CVV), situado en la parte posterior de la tarjeta. Nunca guarde este valor después de la entrada inicial y del intento de reserva del cliente.
ReservationInfo.creditCardExpirationMonth cadena Mes de caducidad de la tarjeta de crédito, con formato MM.
ReservationInfo.creditCardExpirationYear cadena Año de caducidad de la tarjeta de crédito, con formato AAAA.
Información de dirección
La información de la dirección del propietario de la tarjeta se envía en un objeto independiente a partir de los detalles de la tarjeta de pago en el elemento ReservationInfo. En este objeto se pueden usar valores especiales durante el desarrollo para realizar reservas de prueba estáticas.
Nombre Valor Requerido Descripción
AddressInfo objeto Contiene la información de dirección del titular de la tarjeta. Esta información debe coincidir con los registros del proveedor de tarjeta de crédito para que el pago se procese correctamente.
AddressInfo.address1 cadena Dirección postal del cliente; permite 28 caracteres como máximo. Asegúrese de que los caracteres especiales se codifiquen correctamente.
AddressInfo.address2 cadena no Segunda línea opcional para la dirección postal del cliente; permite 28 caracteres como máximo.
AddressInfo.address3 cadena no Tercera línea opcional para la dirección postal del cliente; permite 28 caracteres como máximo.
city cadena Localidad del cliente.
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.
postalCode cadena Código postal para facturación del cliente. Permite un máximo de 10 caracteres. Las reservas de EE. UU. deben usar únicamente códigos postales de 5 dígitos.
Este valor debe coincidir con los registros del proveedor de la tarjeta de crédito; de lo contrario, la reserva no será válida.
Etiquete este campo como "Código postal para facturación" o "CP para facturación" para reducir los errores. Se admiten como válidos caracteres alfanuméricos, espacios, guiones bajos ( _ ) y guiones ( - ).


Respuesta de reserva
Confirma que la reserva de las habitaciones solicitadas es correcta o proporciona información sobre el estado de la reserva en caso de que no se haya confirmado como correcta.

La respuesta para una reserva correcta también contiene el número de itinerario del cliente, el número de confirmación y una confirmación de la selección de la habitación y el precio pagado.

Dado que esta respuesta contiene datos del cliente, debe devolver los datos a los usuarios de forma segura, mediante HTTPS.

Contenido de la respuesta
Elemento principal: HotelRoomReservationResponse


Nombre Valor Descripción
itineraryId largo ID único de EAN para la reserva.

Se utiliza junto con el número de confirmación de la reserva para cualquier comunicación con el cliente que establezca EAN o su propio departamento de servicio de Atención al cliente. Asegúrese de que ambos valores se proporcionan con claridad al cliente.
confirmationNumbers matriz

Números de confirmación de la reserva, uno por cada habitación reservada. Generados por la base de datos de reservas de EAN.

Este valor se utiliza junto con el ID de itinerario para cualquier comunicación con el cliente que establezca EAN. Si envía sus propios correos electrónicos y recurre al servicio de atención al cliente de EAN (no dispone de sus propios agentes), asegúrese de que ambos valores se proporcionen con claridad al cliente. Si utiliza el servicio de asistencia de agente a agente, no proporcione este valor a los clientes.

Las reservas de varias habitaciones devolverán un número de confirmación estándar para la primera habitación. Las salas restantes tendrán el mismo número de confirmación, al que se le añadirá un guion y un número, que empezará por 1, p. ej., 120467481181, 120467481181-1, 120467481181-2

processedWithConfirmation booleano Indica si el propio hotel ha confirmado la reserva al procesarla.

Cuando se devuelve como false, indica que el establecimiento aún no ha devuelto un número de confirmación de la reserva. Es probable que la reserva se devuelva con el estado PS.

En estos casos, un agente de EAN supervisará la reserva hasta que esté complemente confirmada. El correo electrónico de confirmación avisará al cliente de que un agente le reenviará un número de confirmación en cuanto esté disponible.
errorText cadena Cualquier texto de error que pueda haberse generado durante el proceso de reserva, además del contenido del elemento común EanWSError.
hotelReplyText cadena Cualquier información recibida del hotel en el momento de la reserva.
supplierType cadena Confirma el sistema utilizado por el proveedor para procesar la reserva.
reservationStatusCode cadena Indica el estado de la reserva dentro del sistema del proveedor en el momento en que se efectuó la reserva. Debe prever mensajes apropiados para enviar a los clientes, correspondientes a todos los valores sin confirmación.

Valores:
CF Confirmada.
CX Cancelada.
UC Sin confirmar. Trate este estado al igual que DT. La API jamás asignará este estado a reservas activas.
PS Pendiente del proveedor. Consulte nuestra guía sobre procesamiento pendiente.
ER Error. Puede ocurrir cuando una reserva requiera la atención de los agentes o para una tarjeta de crédito rechazada. Si se devuelve un error de tarjeta de crédito, avise al cliente de manera apropiada. Si intentan hacer otra reserva, vuelva a enviarles el elemento itineraryId devuelto en la respuesta de reserva errónea.
DT Itinerario eliminado (normalmente, una prueba o una reserva fallida).
existingItinerary booleano Indicador para evitar reservas duplicadas; se utiliza junto con el parámetro de solicitud affiliateConfirmationId. Devuelve el valor como true junto con el itinerario correcto existente si se ha enviado el mismo valor de confirmación más de una vez.
numberOfRoomsBooked entero Confirma el número de habitaciones reservadas. Coincidirá con la cantidad de números de confirmación devueltos.
drivingDirections cadena Habitualmente este valor está vacío; no se recomienda mostrarlo.
checkInInstructions cadena Las instrucciones para realizar la entrada para el hotel.
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.
arrivalDate cadena Confirmación de la fecha de entrada.
departureDate cadena Confirmación de la fecha de salida.
hotelName cadena Nombre del hotel reservado.
hotelAddress cadena Dirección postal del hotel.
hotelCity cadena Localidad donde está el hotel.
hotelStateProvinceCode 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
hotelCountryCode cadena Código ISO-3166 de dos caracteres correspondiente al país donde esté situado el hotel.
hotelPostalCode cadena Código postal del hotel.
roomDescription cadena Breve descripción de la habitación reservada.
rateOccupancyPerRoom entero Confirma cuántos huéspedes están garantizados para la habitación reservada.
RoomGroup objeto Contenedor de las matrices de Room que definen el recuento de habitaciones y huéspedes. Confirma los detalles de huéspedes y camas para cada habitación reservada.
RoomGroup.Room matriz El número de nodos coincidirá con el valor de numberOfRoomsBooked.
Room.numberOfAdults entero Recuento de huéspedes adultos de la habitación.
Room.numberOfChildren entero Recuento de huéspedes infantiles de la habitación.
Room.childAges lista de enteros
separados por comas
Edades de los huéspedes infantiles, si hay alguno.
Room.firstName cadena Nombre de pila completo del huésped que realiza la entrada de registro para la reserva.
Room.lastName cadena Apellidos completos del huésped que realiza la entrada de registro para la reserva.
Room.bedTypeId cadena Código de la opción de cama elegida por el cliente (o un valor único si no se ofrecieron distintas opciones).
Room.bedTypeDescription cadena Descripción que confirma la elección del tipo de cama.
Room.numberOfBeds entero Valor de 1 de 2.
Room.smokingPreference cadena Confirma la preferencia para fumadores solicitada.
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.

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.
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.
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.cancellationPolicy cadena Política de cancelaciones del establecimiento. Se debe visualizar.
RateInfo.CancelPolicyInfoList matriz 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.
Revise los detalles de la matriz CancelPolicyInfo.
RateInfo.nonRefundable booleano Confirma el valor devuelto en la respuesta de habitación. Si se devuelve en una respuesta de reserva correcta como true, el importe que se cargue será definitivo. Solamente para Expedia Collect.
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 Detalla 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.

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.
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.depositRequired booleano Indica si se requiere realizar un depósito en el momento de efectuar la reserva para asegurarla.
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.
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 cadena 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. Muestre estos valores por separado en el desglose del precio final.
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.

Tenga en cuenta que cualquier tarifa que se devuelva es el valor total de la reserva al completo, incluidos los cargos por noche o por habitación. Ejemplo: Un cargo de 10 USD por noche por una estancia de 4 noches representaría un valor de 40.00
.
Contiene el atributo size para indicar el número cargos que incluye.

HotelFees.HotelFee ninguna

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

Detalla el total de 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 Tipo de cargo, como el IVA o la tasa de complejo turístico.
amount cadena Valor total del cargo.


ValueAdds Contenedor de ValueAdd. Contiene todos los valores añadidos incluidos con la reserva. Tiene un atributo size para indicar el número de valores añadidos individuales.

Disponible con un valor de minorRev=28 o superior.
ValueAdds.ValueAdd matriz

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

Disponible con un valor de minorRev=28 o superior.

ConvertedRateInfo objeto Información sobre la tarifa convertida a la divisa solicitada por el cliente. Se devuelve solamente si las divisas que se vayan a cobrar y las divisas convertidas son diferentes. Es decir, si el hotel no puede aceptar la divisa solicitada por el cliente. Contiene los mismos atributos que ChargeableRateInfo.
Los valores devueltos dentro de este objeto son no reservables. Intentar realizar una reserva con un valor convertido dará como resultado un error.
RoomGroup objeto Confirma el contenido del mismo objeto RoomGroup que se envió en la solicitud cuando se aplica a las tarifas proporcionadas.