Requisitos para el lanzamiento de la API de alojamiento
Empieza bien con la API de Alojamiento Rápido
Los requisitos de lanzamiento de la API Rapid Lodging incluyen los que se aplican a cualquier implementación, independientemente del público, y requisitos específicos para el uso de business-to-business (B2B) o business-to-consumer (B2C). Lee atentamente estos requisitos, ya que pueden ser diferentes de cualquier otro flujo de reserva o tipo de tarifa que hayas integrado anteriormente.
Nota: Cada requisito enumerado a continuación incluye un código de referencia para ayudar a nuestro equipo de atención al cliente a ayudarte.
Requisitos
Los siguientes requisitos se aplican a cualquier implementación de la API de alojamiento.
GR1: Uso de nuestros nombres y logotipos
El uso de nuestros nombres y logotipos sólo podrá realizarse en los sitios traveler-facing o agent-facing con nuestra aprobación explícita por escrito con carácter excepcional.
Ejemplo de interfaz de usuario
GR2: Enlaces a la URL de nuestros términos y condiciones que deben mostrarse
Proporciona un enlace a nuestros términos y condiciones dentro del propio texto de los términos y condiciones de tu sitio web o enlaza directamente a los términos desde tu página de reserva. En estos términos se detallan las políticas que rigen la reserva. Coloca el siguiente enlace en un lugar de easy-to-find, utilizando el texto del enlace "Condiciones del proveedor".
Las versiones de los términos y condiciones en todos los idiomas que admitimos están disponibles en esta página de términos y condiciones de Rapid API .
Ejemplo de interfaz de usuario - B2B
Ejemplo de interfaz de usuario - B2C
GR4: Uso y visualización adecuados de la normativa sobre tarjetas de crédito cuando Expedia Group es el Merchant of Record (MOR).
Cuando obtengas, utilices, transmitas, almacenes o proceses datos de titulares de tarjetas de viajero, deberás cumplir la Norma de Seguridad de Datos de la Industria de Tarjetas de Pago (PCI) emitida por el Consejo de Normas de Seguridad de la PCI. Puedes consultar una referencia completa de esta normativa en el sitio web oficial PCI Security Standards Council .
GR5: Aportar pruebas del cumplimiento de la PCI cuando se utilicen bienes recogidos o cuando Expedia Group sea el MOR (sólo para socios aplicables)
Tanto si Expedia Group es el MOR como si la propiedad es el MOR, debe presentarse un Certificado de Conformidad (AOC) como prueba de cumplimiento de la PCI.
Puedes encontrar consejos sobre el cumplimiento de la normativa PCI en el sitio web oficial PCI Security Standards Council .
SP1: Mensajería adecuada e introducción de las edades de los niños cuando el afiliado permita incluirlos en las reservas
Si tu integración permite niños viajeros, debes ofrecer la posibilidad de especificar la edad de cada niño viajero en el momento de la facturación. Esta información se facilita a través del objeto occupancy (ver ejemplo más abajo).
Cuando los viajeros especifican viajeros con niños, la respuesta de la API puede contener restricciones de edad y/o cargos por ocupación extra o cuna que pueden afectar al coste o a la elegibilidad de la reserva.
Cada hotel configurará qué intervalo de edades clasifica como infantil. Normalmente, se considera que son menores las personas que tienen 17 años o menos. Algunos alojamientos no admiten huéspedes menores de 18 años.
Ejemplo de solicitud API
https://api.ean.com/2.4/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US& occupancy=2-9,4 &property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXXEjemplo de respuesta API
"occupancies": {
"2-9,4" : {
"nightly": [
[Ejemplo de interfaz de usuario: 1 Habitación con 2 adultos y 3 niños de 17, 2 y menos de 1 año.
AP1: Descripciones de los tipos de cama presentes en cada habitación
Las respuestas de compra pueden devolver la matriz bed_groupscon un único valor o con varias opciones. Muestra los valores contenidos en la matriz de configuración para describir las opciones de cama de los viajeros.
Cuando la matriz bed_groupsdevuelve varias opciones, muestra los enlaces price_checkproporcionados por la respuesta de Compra para cada tipo de cama para permitir la selección por parte del viajero.
También debes mostrarle un mensaje al viajero que indique que la elección de diferentes tipos de camas para la misma habitación supone tan solo una solicitud y puede que el hotel no la atienda si no hay disponibilidad.
Los nombres de las habitaciones se devuelven dentro de la matriz de habitaciones de la respuesta de compra como room_name.
Ejemplo de respuesta API
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Superior double room" ,
"rates": [
{
...
"bed_groups": {
"133243": {
"id": "133243",
"description": "Double bed" ,
"links": {...},
"configuration": [...]
},
"133242": {
"id": "133242",
"description": "2 single beds" ,
"links": {...},
"configuration": [...]
}
},Ejemplo de interfaz de usuario - B2B
Ejemplo de interfaz de usuario - B2C
AP2: Non-refundable bandera claramente visible
Non-refundable Las disponibilidades se indican mediante refundable=falseen la respuesta de disponibilidad de la API de compras . Cuando se devuelva refundable=falseen una respuesta de disponibilidad, etiqueta claramente las habitaciones correspondientes. Este valor siempre tiene preferencia sobre otros datos diferentes de la política. El alojamiento no reembolsará el importe de estas reservas bajo ninguna circunstancia.
Ejemplo de respuesta API
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Fairmont King",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",Ejemplo de interfaz de usuario - B2B
Ejemplo de interfaz de usuario - B2C
AP3: Check-in e instrucciones especiales mostradas
El contenido de los objetos checkin, checkout, fees, y policiesdebe mostrarse para cada habitación tal y como se devuelve en la definición del alojamiento Content API . Esta información debe aparecer en tu página de disponibilidad para garantizar que el viajero conozca las posibles tasas al facturar o las instrucciones de acceso especiales.
El campo especial check-in puede incluir información crítica para check-in que no esté incluida en el campo de instrucciones del objeto checkin, como un requisito para notificar al alojamiento la hora de llegada prevista, check-in en un lugar distinto del edificio de invitados, o una alerta para esperar instrucciones especiales check-in del alojamiento por correo electrónico.
Asegúrate de mostrar tanto instructions como special_instructions al viajero en el mismo espacio.
Ejemplo de respuesta API
"11775754": {
"property_id": "11775754",
"checkin": {
"begin_time": "16:00 PM",
"end_time": "4:00 AM",
"instructions": "Minimum age to check in is 18 years old.
<br />Extra-person charges may apply and vary depending on property policy.
<br />Government-issued photo identification and a credit card may be required at
check- in for incidental charges.
<br />Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed. <ul>. ",
"special_instructions": "Front desk staff will greet guests on arrival. For more details,
please contact the property using the information on the booking confirmation.",
"min_age": 18
"checkout": {
"time": "11:00 AM"
"fees": {
"mandatory": "<p>You'll be asked to pay the following charges at the property:</p>
<ul><li>Deposit: USD 50 per day</li>
<li>Resort fee: USD 28.25 per accommodation,
per night</li></ul> The resort fee includes:<ul
><li>Pool access</li><li>Fitness center access</li><li>Fitness/yoga classes</li>
<li>Airport shuttle</li><li>Phone calls</li><li>In-room safe</li><li>Self parking</li>
<li>Valet parking</li><li>Parking</li></ul> <p>We have included all charges provided to us by the property.
However, charges can vary, for example, based on length of stay or the room you book. </p>",
"optional": "<p>The following fees and deposits are charged by the property at time of service,
check-in, or check-out. </p> <ul> <li>Breakfast fee: between USD 6 and USD 25 per person
(approximately)</li> <li>Late check-out is available for a fee (subject to availability)</li>
<li>Rollaway bed fee: USD 20.0 per night</li>
</ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax
and are subject to change. </p>"
"policies": {
"know_before_you_go": "<ul> <li>Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding. </li>
<li>The property has connecting/adjoining rooms, which are subject to availability
and can be requested by contacting the property using the number on the booking
confirmation. </li> </ul>"Ejemplo de interfaz de usuario
BP1: Presencia de encriptación SSL para datos personales
Al enviar o transmitir datos personales, debes utilizar el cifrado SSL para proteger las conexiones entre los navegadores o las aplicaciones del cliente y tu sitio web, así como las comunicaciones de red con sistemas dependientes. Son datos personales, entre otros, los nombres de los huéspedes, los números de teléfono, las direcciones de correo electrónico, los detalles de tarjetas de crédito y los comprobantes y las páginas de confirmación de reservas e itinerarios. Detén o redirige la conexión cuando no esté protegida.
BP2: Check-in e instrucciones especiales mostradas
El contenido de los objetos checkin, checkout, fees, y policiesdebe mostrarse para cada habitación tal y como se devuelve en la definición del alojamiento Contenido . Esta información debe mostrarse para garantizar que el viajero es consciente de las posibles tasas en check-in o de las instrucciones especiales de acceso antes de finalizar su reserva.
El campo especial check-in puede incluir información crítica para check-in que no esté incluida en el campo de instrucciones del objeto checkin, como un requisito para notificar al alojamiento la hora de llegada prevista, check-in en un lugar distinto del edificio de invitados, o una alerta para esperar instrucciones especiales check-in del alojamiento por correo electrónico.
Asegúrate de mostrar tanto instructions como special_instructions al viajero en el mismo espacio.
BP3: Política de cancelación y etiqueta non-refundable claramente expuestas
Antes de permitir que los viajeros confirmen su compra en tu página de reserva final, debes facilitar la política de cancelación o la etiqueta non-refundable de la habitación o habitaciones seleccionadas. La política de cancelación de cada tarifa se proporciona en el objeto cancel_penaltiesde la API de disponibilidad de Rapid Shopping.
En el caso de las tarifas reembolsables, la respuesta incluye distintos detalles de la política de cancelación. Estos detalles incluyen la fecha de inicio y fin de la penalización especificada, así como el tipo y el valor de esta, y todas las fechas de reserva con excepciones que se apliquen. Entre los tipos de penalización, se incluyen un importe fijo, un número de noches y un porcentaje del coste total.
| Respuesta | Significado |
|---|---|
refundable=true | Esta tarifa es totalmente reembolsable. |
refundable=true + cancel_penalties | • Esta tarifa es reembolsable durante el plazo de cancelación. • La fecha más temprana cancel_penalties.[].startes la fecha límite de cancelación gratuita, si se trata de un plazo futuro.• La tasa es del 100% non-refundable después de la última cancel_penalties.[].end |
refundable=false | • Esta tasa es non-refundable. • No se devuelve ningún periodo de penalización por cancelación. |
refundable=false + cancel_penalties | • La tasa puede ser parcialmente reembolsable. • cancel_penaltiesdebe mostrarse junto con nonrefundable_date_rangesque mostrará que las fechas de estancia de este rango son non-refundable una vez creada la reserva. |
Lee más sobre cómo construir políticas de cancelación .
Referencia:
refundable=false
- Se cobrará una cantidad no reembolsable inmediatamente después de crear la reserva.
cancel_penaltiesynonrefundable_date_rangesofrecerán más información.
nonrefundable_date_ranges
- Las fechas de estancia de este periodo no son reembolsables después de que se haya creado la reserva.
cancel_penalties
- Se aplica a las fechas de estancia que no se encuentren en
nonrefundable_date_ranges. - La tarifa es 100 % no reembolsable cuando
cancel_penaltiesestá vacío o no se devuelve. - Se cobrará una penalización cuando se realice una cancelación dentro del periodo de
cancel_penalties. - La fecha más temprana
cancel_penalties.[].startes la fecha límite de cancelación gratuita, si se trata de un plazo futuro. - La tasa es del 100% non-refundable tras la última
cancel_penalties.[].end.
_Ejemplo de respuesta de la API: Política de cancelación y bandera non-refundable _
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Traditional Room (Partner:Connect Test)",
"rates":
"id": "276321199",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2020-09-10T18:00:00.000-07:00",
"end": "2020-09-11T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"Ejemplo de interfaz de usuario
BP4: Gastos debidos por separado en la propiedad que aparecen en el desglose del precio
Cuando se devuelvan los cargos en la matriz de tasas, muestra cada valor por separado como un cargo que se tiene que pagar en el alojamiento (entrada o salida). Presenta al viajero la moneda local y solicita divisas. Estos cargos los cobra directamente la propiedad (no nosotros ni el gobierno local) y no forman parte de los cargos estándar de recuperación de impuestos, impuestos o tasas incluidos en la línea de impuestos y tasas.
Ejemplo de respuesta de la API: Matriz de tasas
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},Ejemplo de interfaz de usuario
BP5: La indicación del precio debe incluir el precio total y un desglose de los impuestos y tasas
A) Precio total
El precio total de la reserva se tiene que mostrar al viajero en la página de pago. El precio total debe coincidir con la respuesta de la API, sin permitir el redondeo ni la conversión de moneda. El desglose final debe incluir el precio de la habitación (total o por noche), cualquier tarifa nocturna adicional (excepto las del campo property_feeque se describe a continuación), todos los importes de la estancia y los impuestos, un total imputable, y establecer lo que se paga ahora y lo que se pagará después en el alojamiento.
Nota: Los requisitos de visualización de precios adicionales se aplican a las implementaciones de tarifas de paquetes B2B o B2C y tarifas de paquetes expuestas.
B) Desglose de impuestos
La visualización del precio debe incluir la suma de tax_and_service_feey property_feecomo una línea titulada "Impuestos y tasas". La ley exige que se muestre el texto exacto que figura a continuación cuando se hace referencia a cualquier total de impuestos y tasas dentro del desglose de precios. Puede mostrarse como texto plano en pop-up,, modal o de otra forma. La tasa de propiedad no debe mostrarse por separado en la página de pago.
"Los impuestos son tasas de recuperación de impuestos pagadas a los vendedores (e.g. hoteles); para más detalles, consulta nuestras Condiciones de uso. Las comisiones de servicio se retienen como compensación por atender tu reserva y pueden incluir comisiones cobradas por los proveedores." Las traducciones pueden encontrarse en en Expedia Soluciones para socios.
El valor devuelto por tax_and_service_feesólo incluye los impuestos y tasas exigidos por una jurisdicción fiscal.
C) Cargos de la reserva y del servicio del colaborador
En la medida en que Expedia Group conceda una exención para permitir cargos adicionales por servicio o reserva, deben estar claramente separados. Si tu organización impone un cargo por servicio que se añade a la reserva, debe quedar claro para el viajero que el cargo lo cobras tú, y no Expedia Group por un servicio separado (es decir, no es un cargo más por la provisión de alojamiento). Los cargos no pueden incluirse dentro de las partidas existentes de impuestos y tasas. No utilices la palabra "tasa" para describir ningún cargo impuesto por tu propiedad. En su lugar, puedes utilizar "cargo por reserva de afiliado" o "cargo por servicio de afiliado".
Nota: Se aplican requisitos adicionales para las implementaciones de B2B o B2C tarifas de recogida de propiedades y paquetes expuestos.
BP7: Se reiteran las edades de los niños (si procede)
Si tu integración permite niños viajeros y el viajero especificó niños viajeros para su selección de habitación, debes confirmar claramente el número de niños viajeros y sus edades en tus páginas de reserva. Esta información se proporciona a través del objetochild_ages.
Ejemplo de interfaz de usuario
BP8: Declaración de cuándo se cobrará el pago al viajero final (por propiedad a cobrar o cuando Expedia Group sea el MOR)
Si el Grupo Expeda es el MOR, indica que se cargará inmediatamente en la tarjeta de crédito facilitada el importe total de la reserva.
En el caso de Property Collect, tiene que especificarse que el alojamiento hará el cargo en la tarjeta de crédito indicada al realizar la entrada o la salida. Si el alojamiento ofrece una tarifa non-refundable post-pay, indica en su lugar que el alojamiento podría cobrar al viajero poco después de completar la reserva.
BP9: Conforme a la normativa SCA
Los organismos reguladores y las redes de tarjetas están introduciendo nuevos requisitos para reforzar la seguridad de los pagos en línea y proteger a los consumidores contra el fraude. Muchas de estas normativas han incluido el requisito de utilizar la autenticación fuerte del cliente (SCA) para los pagos en línea.
Más información sobre la autenticación fuerte de clientes (SCA)
BP10: Lugar de procesamiento del pago mostrado en las páginas check-out cuando Expedia Group es MOR
Cuando Expedia Group sea el MOR, el país en el que se procesará el pago debe aparecer en un lugar destacado de la página check-out. La frase "Este pago se procesará en" debe insertarse antes del nombre del país.
Utiliza la función Opciones de pago de la API de compras para recuperar esta información.
Ejemplo de solicitud API para opciones de pago
https://api.ean.com/<payment-options link from previous availability request>
Ejemplo de respuesta API
"credit_card": {
"name": "Credit Card",
"card_options": [
"name": "MasterCard",
"processing_country": "US"
"name": "Visa",
"processing_country": "US"Ejemplo de interfaz de usuario
Particularidades de la implantación B2B
Puedes encontrar una lista de comprobación que te ayude en tu desarrollo o que te proporcione información sobre los requisitos. Si proporcionas capturas de pantalla para la revisión de tu sitio, también debes añadirlas junto con los registros correspondientes en la lista de comprobación para ayudarnos a completar tu revisión.
GR3: Los agentes descendentes deben aceptar nuestros Términos y Condiciones para Agentes para acceder a nuestro inventario
Los agentes que realicen una reserva en nombre de un viajero deben aceptar nuestro acuerdo de agente descendente. Debe proporcionarse un enlace al acuerdo del agente descendente para que los agentes lo revisen y acepten antes de hacer una reserva. Hay otras versiones disponibles en Expedia Soluciones para socios.
Ejemplo de interfaz de usuario
Requisitos adicionales de las tarifas de los paquetes
Además de los requisitos comunes enumerados anteriormente, si incluyes un elemento de tarifas por paquete en tu implementación, también debes cumplir estos requisitos.
AP4: Mostrar las tarifas de los paquetes con una etiqueta o identificador único
Debes identificar claramente que la Tarifa del Paquete Expedia Group es una tarifa de paquete (no artículos separados) a nivel de habitación.
Ejemplo de interfaz de usuario
BP5: La visualización del precio debe incluir el precio total y un desglose de los impuestos y tasas
El requisito de precio total para las tarifas de paquete es diferente de los requisitos comunes indicados anteriormente.
A) Precio total
El precio del paquete debe combinarse con el precio del componente de transporte a fin de mostrar un único precio total del paquete. Esto se consigue normalmente indicando en per-person el coste de la vivienda más el transporte.
El precio total de la reserva se tiene que mostrar al viajero en la página de pago. El precio total debe coincidir con la respuesta de la API, sin permitir el redondeo ni la conversión de moneda.
Ejemplo de interfaz de usuario
BP11: Exigir a los agentes que acepten las normas de tarifas de los paquetes
Incluya una casilla de verificación en su página de pagos, donde el agente informe de que venden con esta tarifa junto con un componente de transporte aprobado.
Ejemplo de interfaz de usuario
Requisitos adicionales de recogida de bienes
Además de los requisitos comunes enumerados anteriormente, si incluyes en tu aplicación bienes inmuebles recogidos, también deberás cumplir estos requisitos.
Particularidades de la aplicación B2C
Hemos creado una lista de comprobación para ayudarte en tu desarrollo o para que nos des tu opinión sobre los requisitos. Si proporcionas capturas de pantalla para la revisión de tu sitio, también debes añadirlas junto con los registros correspondientes en la lista de comprobación para ayudarnos a completar tu revisión.
GR10: Proporcionar un acceso adecuado a las ofertas de member-only
Member-only Las ofertas deben venderse exclusivamente en un entorno closed-user (por ejemplo, a través del inicio de sesión en un sitio web, una aplicación móvil o una herramienta para agentes).
Ejemplo de interfaz de usuario
Requisitos adicionales de la tarifa de paquetes
Además de los requisitos comunes enumerados anteriormente, si incluyes un elemento de tarifa por paquete en tu aplicación, también debes cumplir estos requisitos.
BP5: La visualización del precio del paquete debe incluir el precio total y un desglose de los impuestos y tasas
El requisito de precio total para las tarifas de paquete es diferente de los requisitos comunes indicados anteriormente.
A) Precio total
El precio del paquete debe combinarse con el precio del componente de transporte a fin de mostrar un único precio total del paquete. Esto se consigue normalmente indicando en per-person el coste de la vivienda más el transporte.
El precio total de la reserva se tiene que mostrar al viajero en la página de pago. El precio total debe coincidir con la respuesta de la API, sin permitir el redondeo ni la conversión de moneda.
Ejemplo de interfaz de usuario
Requisitos adicionales de las tarifas de paquetes expuestos
Además de los requisitos comunes enumerados anteriormente, si incluyes un elemento de tarifa de paquete expuesto en tu implementación, también debes cumplir estos requisitos.
Requisitos adicionales de recogida de bienes
Además de los requisitos comunes enumerados anteriormente, si incluyes un elemento de tarifa de paquete expuesto en tu implementación, también debes cumplir estos requisitos.