Requisitos para el lanzamiento de la API de alojamiento
Empieza con buen pie con la API de Rapid Lodging
Los requisitos de puesta en marcha de la API de Rapid Lodging incluyen tanto los que se aplican a cualquier implementación, independientemente del público al que vaya dirigida, como los requisitos específicos para el uso en el ámbito « 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 que aparece a continuación incluye un código de referencia para que nuestro equipo de atención al cliente pueda ayudarte mejor.
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 solo está permitido en los sitios web traveler-facing o agent-facing; cualquier excepción a esta norma requiere nuestra autorización previa por escrito.
Ejemplo de interfaz de usuario
GR2: Enlaces a nuestros términos y condiciones. URL que se va a mostrar
Incluye un enlace a nuestros términos y condiciones dentro del texto de los términos y condiciones de tu propia web o añade un enlace directo a ellos desde tu página de reservas. En estos términos se detallan las políticas que rigen la reserva. Pon el siguiente enlace en una sección de easy-to-find, con el texto «Términos y condiciones del proveedor».
En nuestra página de asistencia puedes encontrar las versiones de los términos y condiciones en todos los idiomas que ofrecemos.
>> Consulta los términos y condiciones adaptados a tu país.
Ejemplo de interfaz de usuario - B2B
Ejemplo de interfaz de usuario - B2C
GR4: Uso y exposición adecuados de la normativa sobre tarjetas de crédito cuando Expedia Group es el « Merchant » (MOR)
Siempre que obtengas, utilices, transmitas, almacenes o proceses datos de los titulares de tarjetas de viaje, debes cumplir con la Norma de Seguridad de Datos de la Industria de Tarjetas de Pago (PCI), tal y como la ha publicado el Consejo de Normas de Seguridad de PCI.
>> Entra en la página web del Consejo de Normas de Seguridad PCI
GR5: Presenta pruebas del cumplimiento de la normativa PCI cuando utilices «Property Collect» o cuando « Expedia Group » sea el MOR (solo socios afectados)
Tanto si el « Expedia Group » es el MOR como si la propiedad es el MOR, hay que presentar una Declaración de Cumplimiento (AOC) como prueba de que se cumple con la normativa PCI, según lo establecido por el Consejo de Normas de Seguridad PCI.
>> Entra en la página web del Consejo de Normas de Seguridad PCI
SP1: Mensajes adecuados e introducción correcta de las edades de los niños cuando el afiliado permita incluir a los niños en las reservas
Si tu sistema permite viajar a menores, tienes que ofrecer la opción de indicar la edad de cada menor en el momento de hacer el check-in. Esta información se proporciona a través del objeto occupancy (mira el ejemplo de más abajo).
Cuando los viajeros indican que viajan con niños, la respuesta de la API puede incluir restricciones de edad y/o recargos por ocupación adicional o por cuna, lo que puede afectar al coste o a la validez 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 a la API
https://api.ean.com/v3/properties/availability?checkin=2027-09-11
&checkout=2027-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 de la API
"occupancies": {
"2-9,4" : {
"nightly": [
[Ejemplo de interfaz de usuario: 1 habitación con 2 adultos y 2 niños de 9 y 4 años.
AP1: Descripciones de los tipos de cama disponibles en cada habitación
Las respuestas de «Shopping» pueden devolver la matriz « bed_groups » con un solo valor o varias opciones. Muestra los valores que hay en la matriz de configuración para describir las opciones de cama de los viajeros.
Cuando el array « bed_groups » devuelva varias opciones, muestra los enlaces « price_check » que aparece en la respuesta de Shopping para cada tipo de cama, para que el viajero pueda elegir.
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 aparecen en la matriz «rooms» de la respuesta de «Shopping» como « room_name ».
Ejemplo de respuesta de la 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: La bandera de « Non-refundable » se ve claramente
Non-refundable Las disponibilidades se indican con « refundable=false » en la respuesta de disponibilidad de la API de compras. Te informo de que... Cuando aparezca « refundable=false » en una respuesta de disponibilidad, marca 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.
>> Más información sobre la API de Shopping
Ejemplo de respuesta de la 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 que aparecen en pantalla
El contenido de los objetos « checkin », « checkout », « fees » y « policies » debe mostrarse para cada habitación tal y como aparece en la definición del alojamiento de la API de contenido. Esta información debe aparecer en tu página de disponibilidad para que el viajero esté al tanto de cualquier posible cargo que pueda surgir al hacer el check-in o de las instrucciones especiales de acceso.
El campo especial « check-in » puede incluir información fundamental para « check-in » que no figure en el campo de instrucciones del objeto « checkin », como la necesidad de avisar al alojamiento de la hora prevista de llegada, « check-in » en un lugar distinto al del edificio de huéspedes, o un aviso de que se recibirán instrucciones especiales de « check-in » por parte del alojamiento por correo electrónico.
Asegúrate de mostrar tanto instructions como special_instructions al viajero en el mismo espacio.
>> Más información sobre la API de contenido
Ejemplo de respuesta de la 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: Se utiliza cifrado SSL para los 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 que aparecen en pantalla
El contenido de los objetos « checkin », « checkout », « fees » y « policies » debe mostrarse para cada habitación tal y como se indica en la definición del alojamiento de la API de contenido. Esta información debe aparecer en check-in para que el viajero esté al tanto de cualquier posible cargo o de las instrucciones especiales de acceso antes de confirmar su reserva.
El campo especial « check-in » puede incluir información fundamental para « check-in » que no figure en el campo de instrucciones del objeto « checkin », como la necesidad de avisar al alojamiento de la hora prevista de llegada, « check-in » en un lugar distinto al del edificio de huéspedes, o un aviso de que hay que esperar instrucciones especiales de « check-in » por parte del alojamiento por correo electrónico.
Asegúrate de mostrar tanto instructions como special_instructions al viajero en el mismo espacio.
>> Más información sobre la API de contenido
BP3: La política de cancelación y la etiqueta « non-refundable » aparecen claramente visibles
Antes de permitir que los viajeros confirmen su compra en tu página de reserva final, tienes que indicar 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 indica en el objeto « cancel_penalties » de 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 dentro del plazo de cancelación. • La primera fecha de « cancel_penalties.[].start » es la fecha límite para cancelar sin coste alguno, si se trata de una línea temporal futura.• La tasa es del 100 % non-refundable tras la última cancel_penalties.[].end |
refundable=false | • Esta tarifa es non-refundable. • No se devuelve ningún periodo de penalización por cancelación. |
refundable=false + cancel_penalties | • La tarifa puede ser parcialmente reembolsable. • cancel_penaltiesDebería mostrarse junto con nonrefundable_date_ranges, donde se verá que las fechas de la estancia de este periodo son non-refundable una vez creada la reserva. |
>> Más información sobre cómo elaborar 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 primera fecha de «
cancel_penalties.[].start» es la fecha límite para cancelar sin coste, si se trata de una línea temporal futura. - La tasa es del 100 % non-refundable según la última actualización de
cancel_penalties.[].end.
Ejemplo de respuesta de la API: Política de cancelación y el indicador « 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: Los gastos que hay que pagar por separado en el inmueble aparecen indicados 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). Entrega al viajero la moneda local y pídele la moneda que necesite. Estos cargos los cobra directamente el alojamiento (no nosotros ni el ayuntamiento) y no forman parte de los cargos habituales por recaudación de impuestos, ni de los impuestos ni tasas que aparecen en la partida de «impuestos y tasas».
Ejemplo de respuesta de la API: matriz de tarifas
"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 las 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 las tarifas de las habitaciones (totales o por noche), cualquier cargo adicional por noche (excepto los que figuren en el campo « property_fee », que se describe más abajo), todos los importes de la estancia y los impuestos, el total a pagar, y debe indicar qué se paga ahora y qué se pagará más tarde en el alojamiento.
Nota: Se aplican requisitos adicionales de visualización de precios tanto para las tarifas de paquetes B2B y B2C como para las implementaciones de tarifas de paquetes expuestas.
B) Desglose de impuestos
La indicación del precio debe incluir la suma de tax_and_service_fee y property_fee en una sola línea titulada «Impuestos y tasas». Por ley, es obligatorio mostrar el texto exacto que aparece a continuación cuando se haga referencia a los totales de impuestos y tasas en el desglose de precios. Esto se puede mostrar como un « pop-up, » de texto sin formato, una ventana modal u otra implementación. La tarifa del alojamiento no debería aparecer por separado en la página de pago.
_«Los impuestos son tasas de recuperación fiscal que se pagan a los proveedores (e.g. hotels); para más detalles, echa un vistazo a nuestras Condiciones de uso». Las comisiones por el servicio se retienen como compensación por gestionar tu reserva y pueden incluir las comisiones que cobren los proveedores." _
>> Para ver las traducciones, entra en Expedia Partner Solutions
El importe que te aparece en « tax_and_service_fee » solo incluye los impuestos y las tasas que exige la autoridad fiscal correspondiente.
C) Cargos de la reserva y del servicio del colaborador
En caso de que Expedia Group conceda una exención para permitir cargos adicionales por servicio o reserva, estos deben aparecer claramente separados. Si tu organización aplica un recargo por servicio que se añade a la reserva, debe quedar claro para el viajero que ese recargo lo cobras tú, y no Expedia Group por un servicio aparte (es decir, no es un recargo adicional por el alojamiento). Los cargos no pueden incluirse dentro de las partidas de impuestos y tasas ya existentes. No uses la palabra «cuota» para referirte a ningún cargo que te cobre tu comunidad de propietarios. En su lugar, puedes usar «comisión por reserva de afiliados» o «comisión por servicio de afiliados».
Nota: Se aplican requisitos adicionales tanto para la implementación de las tarifas de recogida de envíos inmobiliarios B2B como para las de paquetes expuestos B2C.
Ejemplo de interfaz de usuario
BP7: Se vuelven a indicar las edades de los niños (si procede)
Si tu sistema de integración permite incluir a niños en la reserva y el viajero ha especificado que quiere que haya niños en su habitación, tienes que confirmar claramente el número de niños y sus edades en tus páginas de reserva. Esta información se proporciona a través del objeto « child_ages ».
Ejemplo de interfaz de usuario
BP8: Indicación de cuándo se cobrará al viajero final (en caso de cobro en el alojamiento o cuando el « Expedia Group » sea el MOR)
Si Expeda Group 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 aplica una tarifa « non-refundable post-pay », indica que el alojamiento podría cobrarle al viajero poco después de completar la reserva.
BP9: Cumple con la normativa SCA
Las agencias reguladoras 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 la obligación de utilizar la autenticación reforzada de clientes (SCA) para los pagos en línea.
BP10: La ubicación de procesamiento de pagos aparece en las páginas de check-out cuando Expedia Group es MOR
Si Expedia Group es el MOR, el país en el que se procesará el pago debe aparecer en un lugar destacado de la p ágina check-out. Hay que poner la frase « _ » («Este pago se procesará en»)_ 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 a la API para ver las opciones de pago
https://api.ean.com/<payment-options link from previous availability request>
Ejemplo de respuesta de la API
"credit_card": {
"name": "Credit Card",
"card_options": [
"name": "MasterCard",
"processing_country": "US"
"name": "Visa",
"processing_country": "US"Ejemplo de interfaz de usuario
Aspectos específicos de la implementación B2B
Te hemos preparado una lista de comprobación para ayudarte en tu desarrollo o para que nos des tu opinión. Si nos envías capturas de pantalla para la revisión de tu sitio web, deberías añadirlas también, junto con los registros correspondientes, en la lista de comprobación para ayudarnos a completar la revisión.
>> Descarga la lista de comprobación
GR3: Los agentes de distribución deben aceptar nuestros Términos y condiciones para agentes para poder acceder a nuestro inventario
Los agentes que hagan una reserva en nombre de un viajero deben aceptar nuestro acuerdo para agentes subcontratados. Tiene que facilitarse un enlace al acuerdo del agente para que los agentes lo revisen y lo acepten antes de efectuar una reserva. Hay otras versiones disponibles en la página web de Soluciones para socios de Expedia.
Ejemplo de interfaz de usuario
Requisitos adicionales sobre las tarifas de los paquetes
Además de los requisitos generales que se han mencionado antes, si vas a incluir un elemento de tarifas de paquetes en tu implementación, también tienes que cumplir estos requisitos.
AP4: Mostrar las tarifas de los paquetes con una etiqueta o un identificador único
Tienes que indicar claramente que la tarifa del paquete « Expedia Group » es una tarifa de paquete (no artículos por separado) a nivel de habitación.
Ejemplo de interfaz de usuario
BP5: La indicación del precio debe incluir el precio total y un desglose de los impuestos y las tasas
Los requisitos sobre el precio total de las tarifas de paquete son distintos de los requisitos habituales que se han mencionado antes.
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 suele hacerse indicando el precio « per-person » del alojamiento más los gastos de 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 sobre tarifas de paquetería
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 para la recogida de bienes inmuebles
Además de los requisitos generales que se han mencionado antes, si vas a incluir la recopilación de datos de propiedad en tu implementación, también debes cumplir estos requisitos.
Aspectos específicos de la implementació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 nos envías capturas de pantalla para la revisión de tu sitio web, deberías añadirlas también, junto con los registros correspondientes, en la lista de comprobación para ayudarnos a completar la revisión.
>> Descarga la lista de comprobación
GR10: Ofrecer un acceso adecuado a las ofertas de « member-only »
Member-only Las ofertas se venderán exclusivamente en un entorno de closed-user (por ejemplo, iniciando sesión en una web, una app móvil o una herramienta para agentes).
Ejemplo de interfaz de usuario
Requisitos adicionales sobre las tarifas de los paquetes
Además de los requisitos generales que se han mencionado antes, si vas a incluir un elemento de tarifa de paquete en tu implementación, también tienes que cumplir estos requisitos.
BP5: La indicación del precio del paquete debe incluir el precio total y un desglose de los impuestos y tasas
Los requisitos sobre el precio total de las tarifas de paquete son distintos de los requisitos habituales que se han mencionado antes.
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 suele hacerse indicando el precio « per-person » del alojamiento más los gastos de 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 sobre las tarifas de los paquetes a la vista
Además de los requisitos generales que se han mencionado antes, si vas a incluir un elemento de tarifa de paquete expuesto en tu implementación, también tienes que cumplir estos requisitos.
Requisitos adicionales para la recogida de bienes inmuebles
Además de los requisitos generales que se han mencionado antes, si vas a incluir un elemento de tarifa de paquete expuesto en tu implementación, también tienes que cumplir estos requisitos.