Solicita una reserva para 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 que se envía en esta solicitud está sujeta a los métodos de validación de seguridad y fraude de propiedad de EAN.

La información de la tarjeta de crédito proporcionada en la solicitud se usará para hacer un pago previo directo de la reserva. La reserva del cliente se paga íntegramente (salvo algunos extras como el servicio de habitaciones) en cuanto se reciba una respuesta correcta, aunque la reserva se efectúe varios meses por adelantado.

Asegúrese de utilizar el par cid/apiKey correcto en las reservas activas. Esto es importante para efectuar reservas correctas y garantizar que las compensaciones obtenidas se abonen 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 de application/x-www-form-urlencoded. No envíe ningún parámetro dentro de la propia cadena URL.
En las solicitudes XML, los elementos comunes se deben enviar en el mismo formato que el de las solicitudes GET: no intente formatear estos valores como elementos XML en el cuerpo POST.



Parámetros de solicitud

Parámetros de URL específicos
Nombre Valor Obligatorio 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.
El uso de otras fuentes para este valor puede provocar errores de discrepancia.
additionalData contenedor de MapEntry no

Utilice este parámetro de solo reserva para ayudar a realizar un seguimiento de las reservas en el Centro de afiliación de EAN. Consulte nuestra página de seguimiento de reservas para obtener todos los detalles.



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

hotelId largo ID de la propiedad de la reserva que se solicitará
arrivalDate cadena

Fecha de registro de entrada con el formato MM/DD/AAAA Transfiera el valor desde la respuesta de habitación.

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

Valores:
E: Expedia Collect
rateKey cadena Valida los parámetros que se indican en la solicitud de reserva. Transfiera el valor desde la respuesta de habitación. Utilice la rateKey devuelta en el primer objeto Room de la respuesta de habitación para lograr 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 decide dejar que los clientes modifiquen cualquier parámetro en la fase de reserva, vuelva a enviar dichos parámetros en una nueva solicitud de habitación con el fin de obtener un nuevo valor, válido para este parámetro.

Los errores "QueryId no válido" 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 se hayan cambiado parámetros.
roomTypeCode cadena Código que designa la habitación concreta que se ha solicitado. Obténgalo siempre de forma dinámica a partir de la respuesta de habitación anterior.

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

Envíelo junto a roomTypeCode
RoomGroup objeto Contenedor de las matrices de Room que definen el recuento de habitaciones y huéspedes. Utilice el mismo valor para las edades de adultos y niños que se definen en la solicitud de habitación anterior.

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. Se incluye el mismo número de nodos y los mismos parámetros de edad/recuento de huéspedes, tal y como se define en la solicitud de habitación anterior.
Room.numberOfAdults entero Recuento de huéspedes adultos de la habitación. Utilice el mismo valor que se define en la solicitud de habitación anterior.
Room.numberOfChildren entero en caso de que > 0 Recuento de huéspedes infantiles de la habitación. Utilice el mismo valor que se define en la solicitud de habitación anterior.
Room.childAges lista de enteros
separada por comas
en caso de que el recuento de niños sea > 0 Las edades de los huéspedes infantiles, si procede. Utilice el mismo valor que se define en la solicitud de habitación anterior. EAN considera niños a personas con edades comprendidas entre 0 y 17 años.
Room.firstName cadena Nombre de pila completo del huésped en la reserva al registrar la entrada. El nombre debe coincidir con el documento de identidad con fotografía del huésped al registrar la entrada en la propiedad.

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 del huésped en la reserva al registrar la entrada. El nombre debe coincidir con el documento de identidad con fotografía del huésped al registrar la entrada en la propiedad.

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 para el tipo de cama que seleccione el cliente (o un solo valor si no se ofrece ningún tipo).

Transfiera el valor que coincida desde el atributo BedType ID de la habitación que seleccione 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 o 2. Solicite u ofrezca solo este parámetro si se devuelven opciones adecuadas basadas en BedType en la respuesta de habitación.
Room.smokingPreference cadena si se utiliza Preferencia para fumadores solicitada. Omita por completo este elemento de su solicitud si no lo necesita para una reserva determinada.

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

Ofrezca solo los valores que se devuelvan en la respuesta de habitación. No utilice los valores anteriores como selecciones no modificables. Al incluir un valor que no se proporcione en la respuesta se producirá un error en la reserva. No envíe varios valores.
affiliateConfirmationId cadena Valor diseñado para realizar un seguimiento de las reservas y ayudar a evitar que se efectúen reservas duplicadas.

Genere un valor único como ID de GUID (máximo 36 caracteres) antes de enviar la reserva. Si la API detecta que este valor está emparejado con otra reserva existente, detendrá todas las reservas posteriores al considerarlas duplicadas.

Para evitar el rechazo de reintentos de reserva válidos, cree siempre un valor nuevo cuando 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 El ID de cliente opcional adicional para utilizarse en el seguimiento de socios. Utilice solamente este ID de forma interna; si se muestra accidentalmente, se puede producir la recuperación de itinerarios que no pertenecen al cliente.
itineraryId largo no

Si se devuelve una solicitud de reserva inicial con un error de tarjeta de crédito, extraiga este valor de la respuesta e inclúyalo en cualquier intento posterior 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 error o rechazo de tarjetas de crédito repetidos se confinará a un solo registro con el fin de evitar que se muestren varias cancelaciones en las estadísticas.

Exponga solo este valor a los clientes si utiliza la asistencia de EAN (no dispone de sus propios agentes de asistencia).

No vuelva a enviar este valor si se devuelve como -1. Esto indica que hay un itinerario que no se ha creado. Vuelva a empezar con una nueva solicitud tras enviar el mensaje de error y permitir que el cliente lo corrija, si fuera necesario.

chargeableRate cadena El importe total que se cobrará por la reserva.

Transfiera el valor de total desde el objeto ChargeableRateInfo (Información sobre el importe a cargar) que se ha devuelto 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 se transmitirá con la nueva tarifa inferior.
specialInformation cadena no

Permite que los clientes añadan información o solicitudes adicionales con el fin de transmitirlas a la propiedad.

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. Si queda algún salto de línea o retorno de carro en este parámetro, se producirá un error irrecuperable.

sendReservationEmail booleano no

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

Utilice solo este parámetro si ya se ha puesto en contacto con su administrador de cuentas o ha solicitado asistencia con respecto a su propio sistema de confirmación de mensajes de correo electrónicos.

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 de ambos objetos se validan con respecto a la información del propietario de la tarjeta del banco emisor.

Algunos de los sistemas que se utilizan para el procesamiento y la validación de pagos no analizan caracteres que no sean latinos. Asegúrese de utilizar solamente valores con caracteres latinos para todos los parámetros con el fin de evitar que se produzcan errores en la 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 sobre tipos de tarjetas de crédito.

Nombre Valor Obligatorio Descripción
ReservationInfo objeto Contiene la información de tarjeta de crédito y contacto del cliente.
ReservationInfo.email cadena La 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 válida, incluso si su integración trata este campo como un campo de uso únicamente interno.
Se permite un máximo de 50 caracteres para la dirección completa, incluidos @ y .
ReservationInfo.firstName cadena El 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 Los apellidos 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

El número de teléfono particular del cliente. Lo utilizan los agentes del servicio de Atención al cliente en caso de que tenga que ponerse en contacto con el cliente para solucionar un problema con la reserva.

Los números deberán tener una longitud mínima de 5 dígitos. Los caracteres permitidos son 0-9, +, - y ( ).

ReservationInfo.workPhone cadena no El número de teléfono del trabajo del cliente. Los números deberán tener una longitud mínima de 5 dígitos. Los caracteres permitidos son 0-9, +, - y ( ).
ReservationInfo.extension cadena no La extensión del número de teléfono del trabajo del cliente, si procede. Se permite un máximo de 5 caracteres.
ReservationInfo.faxPhone cadena no El número de fax del cliente. Los números deberán tener una longitud mínima de 5 dígitos. Los caracteres permitidos son 0-9, +, - y ( ).
ReservationInfo.companyName cadena no El nombre de la empresa si se necesita para los recibos de viaje del empleado o con fines fiscales.
ReservationInfo.creditCardType cadena El tipo de tarjeta de crédito que se utiliza. Consulte esta página para ver los valores específicos de detalles de validación y tipos de tarjeta de crédito.
ReservationInfo.creditCardNumber cadena Número de la tarjeta de crédito del cliente.
ReservationInfo.creditCardIdentifier cadena El número de identificación de la tarjeta de crédito o el valor de seguridad de la tarjeta (CSV o CVV) que se encuentra en el reverso. Nunca guarde este valor después del intento de reserva y la entrada inicial del cliente.
ReservationInfo.creditCardExpirationMonth cadena Mes de caducidad de la tarjeta de crédito con el formato MM.
ReservationInfo.creditCardExpirationYear cadena Año de caducidad de la tarjeta de crédito con el 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. Se pueden usar valores especiales en este objeto durante el desarrollo para llevar a cabo reservas de prueba estáticas.
Nombre Valor Obligatorio Descripción
AddressInfo objeto Contiene la información de la dirección de la tarjeta del propietario. Esta información debe coincidir con los registros del proveedor de la tarjeta de crédito con el fin de que los pagos se procesen correctamente.
AddressInfo.address1 cadena La dirección postal del cliente (máximo de 28 caracteres). Asegúrese de que los caracteres especiales se codifiquen correctamente.
AddressInfo.address2 cadena no La segunda línea opcional de la dirección postal (máximo de 28 caracteres).
AddressInfo.address3 cadena no La tercera línea opcional de la dirección postal (máximo de 28 caracteres).
city cadena Ciudad del cliente.
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.
postalCode cadena Código postal de 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 de facturación" para reducir el número de errores. Los caracteres alfanuméricos, espacios, subrayado ( _ ) y guiones ( - ) son válidos.


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 de clientes, devuelva los datos a los usuarios de forma segura mediante HTTPS.

Contenido de la respuesta
Elemento principal: HotelRoomReservationResponse


Nombre Valor Descripción
itineraryId largo

El 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 proporcionar con claridad ambos valores al cliente.

Nota: Para los hoteles que utilicen Expedia Partner Central, no se pueden localizar los itinerarios utilizando este valor. Utilice el EXPEDIA_BOOKING_ITEM_ID valor de confirmationExtras en las solicitudes de itinerario consiguientes para obtener un valor compatible con EPC.

confirmationNumbers matriz

Números de confirmación de la reserva (uno por 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 depende del servicio de asistencia de EAN (no dispone de sus propios agentes), asegúrese de que ambos valores se proporcionan de forma clara al cliente. Si utiliza un 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 hotel ha confirmado el procesamiento de la reserva.

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

En estos casos, un agente de EAN supervisará la reserva hasta que esté complemente confirmada. En el mensaje de correo electrónico de confirmación se advertirá al cliente de que un agente enviará un número de confirmación en cuanto se le proporcione.
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 adicional recibida por parte del hotel durante la reserva.
supplierType cadena Confirma el sistema del proveedor que se utilizó para procesar la reserva.
reservationStatusCode cadena Indica el estado de la reserva en el sistema del proveedor durante la reserva. Tenga previsto enviar mensajes pertinentes a los clientes para todos los valores sin confirmar.

Valores:
CF Confirmado
CX Cancelado
UC Sin confirmar. Trate este estado al igual que DT. La API nunca asignará este estado a reservas activas.
PS Pendiente del proveedor. Consulte nuestra guía sobre procesos pendientes.
ER Error. Se puede producir cuando una reserva requiere la atención de un agente, o bien en el caso de una tarjeta de crédito rechazada. Si se devuelve un error en la tarjeta de crédito, advierta al cliente para que esté al tanto. Si intentan hacer otra reserva, vuelva a enviarles el elemento itineraryId devuelto en la respuesta de reserva errónea.
DT Itinerario borrado (normalmente se trata de una reserva errónea o de prueba).
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 que se han devuelto.
drivingDirections cadena Normalmente 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 La confirmación de la fecha de registro de entrada.
departureDate cadena La confirmación de la fecha de registro de salida.
hotelName cadena El nombre del hotel reservado.
hotelAddress cadena Dirección postal del hotel
hotelCity cadena Ciudad del hotel
hotelStateProvinceCode 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
hotelCountryCode cadena El código ISO-3166 de dos caracteres correspondiente al país donde se ubica el hotel.
hotelPostalCode cadena Código postal del hotel
roomDescription cadena Breve descripción de la habitación reservada.
rateOccupancyPerRoom entero Confirma el número de huéspedes garantizados para la habitación reservada.
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:
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.cancellationPolicy cadena La política de cancelación de la propiedad. Es obligatorio que se muestre.
RateInfo.CancelPolicyInfoList matriz 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.nonRefundable booleano Confirma el valor que se devuelve en la respuesta de habitación. Si se devuelve en una respuesta de reserva correcta como true, el importe se cobrará al final. Solo para Expedia Collect.
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. Expedia cobra estas tarifas al efectuar la reserva.
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 Detalla 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.

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.
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.depositRequired booleano Indica si se requiere un depósito al hacer la reserva para asegurarla.
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.
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. Solo 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

Nombre del cargo adicional.
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 tipo de recargo PropertyFee debe mostrarse como "Tarifa del establecimiento" en el desglose del precio final 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 para la descripción, el importe y la moneda de una sola 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, por ejemplo, IVA o tasa del complejo turístico.
amount cadena El valor total del cargo


RateInfo.RoomGroup objeto Contenedor de las matrices de Room que definen el recuento de habitaciones y huéspedes. Confirma los detalles de las camas y los huéspedes de 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
separada por comas
Las edades de los huéspedes infantiles, si procede.
Room.firstName cadena Nombre de pila completo del huésped en la reserva al registrar la entrada.
Room.lastName cadena Apellidos del huésped en la reserva al registrar la entrada.
Room.bedTypeId cadena Código para el tipo de cama que seleccione el cliente (o un solo valor si no se ofrece ningún tipo).
Room.bedTypeDescription cadena Descripción que confirma la opción del tipo de cama.
Room.numberOfBeds entero Valor de 1 o 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 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 minorRev=29 y superior.
ChargeableNightlyRates.NightlyRate objeto

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.
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.
ValueAdds contenedor de ValueAdd Contiene todos los valores añadidos que contiene la reserva. Tiene un atributo size para indicar el número de valores añadidos individuales.

Está 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.

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

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 (Información sobre el importe a cargar).
Los valores que se devuelven con este objeto son no aptos para reserva. Cualquier intento de reservar con un valor convertido dará como resultado un error.