Compras

La API de compras proporciona acceso a las tarifas y a la disponibilidad en tiempo real de 700 000 alojamientos en todo el mundo.

Información general

La API de compras devuelve las tarifas y la disponibilidad de todos los tipos de habitaciones de los alojamientos especificados (hasta 250 alojamientos como máximo por solicitud). La respuesta incluye los detalles sobre la tarifa, como las promociones, si la tarifa es reembolsable, las penalizaciones por cancelación y un desglose completo de los precios para cumplir los requisitos sobre indicación de tarifas de tu mercado.

Se pueden solicitar varias habitaciones del mismo tipo con varias instancias del parámetro occupancy. Si se solicita la misma ocupación varias veces en la misma solicitud, la respuesta solo contendrá un único conjunto de tarifas para esa ocupación. No se pueden solicitar más de ocho habitaciones a la vez. Si necesitas reservar más de ocho habitaciones a la vez, haz una consulta a tu gestor de cuentas sobre nuestra colaboración para realizar reservas de grupos.

Cambios en la indicación de precios

Te informamos de los próximos cambios que se realizarán de conformidad con la normativa sobre la indicación de precios del estado de California (ley Berman), que entrará en vigor a partir del 1 de julio de 2024.

¿De qué trata la ley?

Este instrumento legislativo prohíbe anunciar, mostrar u ofrecer una tarifa de habitación en la que no se incluyan todas las tasas o cargos exigidos para alojarse en un alojamiento de corta duración, excepto los impuestos y tasas que un gobierno requiera imponer sobre la estancia. El proyecto de ley también exige que, antes de que el consumidor reserve una estancia, el anuncio de un alojamiento de corta duración incluya, en el precio total que se pagará, todos los impuestos y tasas que un gobierno imponga sobre la estancia. Por "alojamiento de corta estancia" se entiende cualquier hotel, motel, bed and breakfast u otro tipo de alojamiento transitorio, e incluye los alquileres a corto plazo o los alojamientos residenciales que se alquilen a un visitante durante menos de 31 días consecutivos. Consulta más información en el Proyecto de Ley 537 de la Asamblea de California.

Expedia Group está realizando cambios en su API para que sus colaboradores puedan indicar los precios de diversas formas. En última instancia, no obstante, todo colaborador que utilice la API de Expedia Group es responsable de garantizar que la forma en que muestra los precios y la información del viaje de Expedia sea conforme a derecho.

¿Cuáles son los próximos cambios?

Expedia está mejorando Rapid API para añadir un nuevo campo property_inclusive con el precio total que incluya la tarifa base y todas las tasas e impuestos cobrados por Expedia y el alojamiento para toda la estancia. Una versión tachada de este precio total también estará disponible en un nuevo campo (property_inclusive_strikethrough). Además de los nuevos campos de indicación de los precios del alojamiento, estamos reajustando la forma en la que se desglosan los impuestos y las tasas en la respuesta de la API. Todas las tasas cobradas por Expedia formarán parte del tipo de desglose de precio de la property_fee por nightly y stay, y todos los impuestos cobrados por Expedia formarán parte del tipo de desglose de precio tax_and_service_fee por nightly y stay.

Como será un cambio global que se aplicará a todos los alojamientos, la fecha de publicación se ha aplazado al 29/05/2024 para garantizar una adopción y comprensión fluidas de los cambios. Contacta con tu gestor de cuentas en caso de tener más preguntas sobre los cambios.

Puntos de fidelidad

Los alojamientos con programas de fidelidad que participan en el programa de tarifas corporativas de Expedia ofrecen a los viajeros de negocios la oportunidad de ganar puntos de fidelidad del hotel por sus estancias. Los colaboradores pueden utilizar el nodo de servicios de la respuesta de la API de compras para identificar y mostrar los requisitos del programa de fidelidad antes de solicitar los detalles de la suscripción del viajero.

También pueden buscar específicamente tarifas corporativas que cumplan los requisitos del programa de fidelidad con el filtro de valor loyalty en sus solicitudes a la API de compras.

Nota: Solo se pueden ganar puntos de fidelidad por las tarifas corporativas de hoteles que tengan un programa de fidelidad.

Ejemplo:

Las tarifas corporativas de hotel válidas para obtener puntos de fidelidad tendrán el parámetro que se indica a continuación en la respuesta de búsqueda con el nodo amenities

{
  "id": "2096",
  "name": "Eligible for hotel loyalty points"
}

Incentivos de comisiones

Como colaborador de Rapid API, tienes acceso a incentivos de comisiones adicionales que ofrecen márgenes más altos en los alojamientos durante un periodo determinado de reserva y estancia. Para identificar los alojamientos con un incentivo de comisión activo, solo tienes que utilizar el valor rooms.rates.marketing_fee_incentives para el parámetro include en tu solicitud a la API de compras de Rapid. Las tarifas con incentivos de comisiones para todo o para parte del periodo de estancia solicitado incluirán detalles adicionales, como el origen del incentivo y la parte de la estancia afectada, en el objeto marketing_fee_incentives de la respuesta de la API de compras. A continuación, puedes tener en cuenta esta información y el campo marketing_fee existente, que es una estimación de la tarifa de marketing que incluye todos los incentivos disponibles, en tu proceso de clasificación y selección de inventario.

Ejemplo

El alojamiento 19248 ofrece márgenes más elevados para las estancias en diciembre. Realizas una solicitud de la API de compras para el alojamiento 19248 en relación con una estancia del 22 de diciembre al 5 de enero. En el objeto marketing_fee_incentives de la respuesta de la API de compras verás que hay un incentivo disponible para una parte de la estancia solicitada (del 22 al 31 de diciembre), lo que representa 10 de las 14 noches de estancia.

Ejemplo de solicitud

curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2023-12-22\
&checkout=2024-01-05\
&currency=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=website\
&sales_environment=hotel_only\
&include=rooms.rates.marketing_fee_incentives\
&travel_purpose=leisure" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Ejemplo de respuesta

[
  {
    "property_id": "19248",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            ...
            "marketing_fee_incentives": [
              {
                "source": "property",
                "start": "2023-12-22",
                "end": "2023-12-31"
              }
            ],
            "occupancy_pricing": {
              "2": {
                "nightly": [ ... ],
                "stay": [ ... ],
                "totals": {
                  "inclusive": { ... },
                  "exclusive": { ... },
                  "inclusive_strikethrough": { ... },
                  "strikethrough": { ... },
                  "marketing_fee": {
                    "billable_currency": {
                      "value": "276.36",
                      "currency": "USD"
                    },
                    "request_currency": {
                      "value": "276.36",
                      "currency": "USD"
                    }
                  },
                  "gross_profit": { ... },
                  "minimum_selling_price": { ... },
                  "property_fees": { ... }
                },
                "fees": { ... }
              }
            }
          }
        ]
      }
    ]
  }
]

Propósito del viaje

El parámetro travel_purpose te permite identificar si el viaje es de negocios o de ocio. A partir del 1 de abril de 2024, los colaboradores que reúnan los requisitos para comprar tarifas corporativas deberán usar travel_purpose=business en la solicitud de compra para recibir este tipo de tarifas en la respuesta de compra. Si no se incluye el parámetro travel_purpose en la solicitud, se asumirá que es un viaje de ocio y no se devolverán las tarifas corporativas.

Ejemplo

Especificar que un viajero va a viajar por motivos de negocios es tan fácil como añadir 24 caracteres a la solicitud de la API de disponibilidad.

&travel_purpose=business

Precios tachados

• El campo strikethrough indica el precio total sin impuestos antes de aplicar los descuentos financiados por el hotel. Este campo debe usarse en plataformas que suelen mostrar el precio base sin impuestos ni tarifas en los resultados de búsqueda, como en Estados Unidos.
• El campo inclusive_strikethrough muestra el precio total, sin los descuentos, y con los impuestos y tasas incluidos. El propósito de este campo es permitirte mostrar con mayor claridad el descuento que se aplica en las plataformas que muestran precios con todo incluido, es decir, base más impuestos y cargos. El campo devuelve el valor tanto en la moneda facturable como en la solicitada.

Ejemplo

[
  {
    "property_id": "19248",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            ...
            "occupancy_pricing": {
              "2": {
                "nightly": [ ... ],
                "stay": [ ... ],
                "totals": {
                  "inclusive": { ... },
                  "exclusive": { ... },
                  "inclusive_strikethrough": {
                    "billable_currency": {
                      "value": "726.63",
                      "currency": "CAD"
                    },
                    "request_currency": {
                      "value": "549.60",
                      "currency": "USD"
                    }
                  },
                  "strikethrough": {
                    "billable_currency": {
                      "value": "650.00",
                      "currency": "CAD"
                    },
                    "request_currency": {
                      "value": "491.64",
                      "currency": "USD"
                    }
                  },
                  "marketing_fee": { ... },
                  "gross_profit": { ... },
                  "minimum_selling_price": { ... },
                  "property_fees": { ... }
                },
                "fees": { ... }
              }
            }
          }
        ]
      }
    ]
  }
]

Detalles de precios de promociones y descuentos

Al mostrar un importe de ahorro con descuento basado en una promoción o con precios tachados proporcionados en las API de disponibilidad y comprobación de precios, determinados puntos de venta necesitan que se proporcionen los detalles sobre el precio de la tarifa estándar (es decir, el precio sobre el que se calcula el descuento). Consulta en los siguientes enunciados qué terminología hay que utilizar.

UE: proporciona datos claros sobre el precio de la tarifa estándar (p. ej., "Este precio es la tarifa estándar proporcionada por el alojamiento en función de la búsqueda").

Italia: utiliza la siguiente frase: *"Questo prezzo è basato sulla tariffa generalmente applicabile fornita dalla struttura per questa camera e per queste date".

Motivo de falta de disponibilidad

La función unavailable_reason te permite solicitar información procesable sobre por qué una propiedad no está disponible para una estancia determinada (fechas de estancia y ocupación). El parámetro de solicitud opcional include=unavailable_reason debe incluirse en la compra para recibir esta información en la respuesta. Sin embargo, no todos los alojamientos no disponibles tendrán un motivo procesable por el que no se puedan reservar. Estos alojamientos no se devolverán en la respuesta.

La respuesta de compra puede incluir una combinación de alojamientos disponibles y no disponibles. Los alojamientos no disponibles incluirán un property_id, score y una sección unavailable_reason que incluye un code con una breve explicación de por qué el alojamiento no está disponible (en inglés) y data para obtener información adicional que podría adaptarse en la solicitud para hacer que el alojamiento, las habitaciones o los planes de tarifas estén disponibles. Por ejemplo, si un code unavailable_reason fuera adults_exceed_threshold, el 2 en data significaría que 2 adultos es el número máximo permitido para esa habitación o tarifa y se produciría un error con cualquier ocupación superior a 2.

Nota: Se pueden aplicar varias restricciones a un alojamiento, pero solo se devolverá un unavailable_reason.

Ejemplo

[
  {
    "property_id": "824739",
    "score": 12345,
    "unavailable_reason": {
      "code": "adults_exceed_threshold",
      "data": "2"
    }
  }
]

Consulta aquí la lista completa de códigos devueltos.

Filtros de servicios

Tienes la opción de filtrar los alojamientos devueltos en la respuesta de compra de Rapid con el parámetro de solicitud amenity_category junto con uno o más servicios específicos.

Consulta la sección Categorías de servicios de las Listas de referencia de contenido aquí para obtener una lista de servicios que se pueden usar para filtrar la respuesta.

Ejemplos

Filtro de servicio único:

&amenity_category=free_breakfast

Filtro de varios servicios:

&amenity_category=free_breakfast&amenity_category=free_airport_transfer&amenity_category=casino

Límites de cuota

Conseguimos optimizar el tráfico aplicando límites de cuota a los colaboradores. Estos límites de cuota aseguran que podemos ofrecer un servicio estable y sostenible a los colaboradores, al mismo tiempo que garantizan un uso eficiente de los sistemas de Expedia Group. Para el tráfico de compras, los factores más importantes para determinar la carga son la cantidad de alojamientos y habitaciones, y la duración de las estancias que se buscan en cada solicitud.

Obtén más información sobre los límites de cuota aquí.

Comprobación de los precios

Confirma el precio que ha devuelto la respuesta de compra. Utiliza esta API para verificar si una tarifa seleccionada previamente sigue siendo válida antes de realizar la reserva. Si el precio coincide, la respuesta devuelve un enlace para solicitar una reserva. Si el precio ha cambiado, la respuesta devuelve nuevos detalles sobre el precio y un enlace para reservar el nuevo precio. Si ya no está disponible el precio, la respuesta devuelve un enlace a una nueva solicitud de compra para buscar otras tarifas.

Puede haber una ligera variación de aproximadamente el 0,1 % (por habitación, persona y noche) en el importe facturable que aparece en PriceCheck para totals.property_fees y fees en comparación con la respuesta de Compra anterior. Esta posible discrepancia en las tarifas debidas en el alojamiento puede surgir solo cuando request_currency y billable_currency difieren para las tarifas de Expedia Collect. La API funcionará sin errores en esta circunstancia.

Opciones de pago

Devuelve las opciones de pago aceptadas. Utiliza esta API para activar la página de pagos y mostrar las formas de pago válidas, de modo que la reserva se realice sin complicaciones. Las tarifas ofrecidas como Property Collect devolverán los tipos de tarjeta que acepta el alojamiento. El resto de los tipos de tarifa devolverán las opciones de pago que acepta Expedia.

Notas importantes

• language solo utiliza pares de códigos de dos dígitos del idioma y del país unidos por un guion. Antes de integrar los códigos, repasa nuestra sección idiomas admitidos.
• Los códigos de country de dos dígitos establecen el punto de venta del huésped (no afectan al contenido traducido).
• No se devuelven datos estáticos (nombres, clasificación por estrellas, información geográfica, etc.). Solo se ofrecen datos relacionados con la disponibilidad y las tarifas.
• Los enlaces tokenizados en las respuestas caducarán tras un breve periodo de tiempo. Si un enlace token devuelve un error HTTP 503, es probable que el enlace haya caducado. Deberás obtener una nueva comprobación de precios o un enlace a los depósitos generados en una respuesta de compras reciente, y volver a intentarlo. No guardes los valores de los enlaces para reutilizarlos a largo plazo.
• Rapid API permite que los alojamientos actualicen su contenido en cualquier momento. Necesitamos que hagas todo lo posible por proporcionar a los clientes la información más actualizada. La API de compra proporciona la información más actual sobre las habitaciones y las tarifas que estén vacantes. Para obtener información adicional a nivel de alojamiento, habitación o plan de tarifas que no se haya incluido en esta respuesta, utiliza nuestra API de contenido del alojamiento.
• Las API proporcionan precios basados solamente en una habitación. Para reservar varias habitaciones, deberás realizar tú mismo cualquier cálculo adicional. Como parte de los requisitos de lanzamiento, tu integración deberá mostrar el desglose de precios detallado a los usuarios finales en determinados pasos del proceso de reserva. Se puede encontrar el desglose en este enlace a la documentación protegida.

Para realizar solicitudes de prueba en este servicio, consulta nuestra documentación sobre solicitud de prueba.

Detalles de la API

Explora las definiciones de los puntos de conexión relacionados con las compras en esta página y usa API Explorer u otro software de pruebas para ver la diferencia entre los ejemplos y las definiciones de esquemas, y el resultado real.

Recursos adicionales

Tanto si lo que quieres es probar todos los puntos de conexión de Rapid API como si quieres descargar las especificaciones de OpenAPI o nuestra colección de Postman, tenemos lo que necesitas.

Ir a API Explorer