Inventario global ampliado para la API de Alojamiento Rápido
Competir a escala global con inventarios ampliados en todo el mundo
El inventario global ampliado (EGI) de Expedia te ayuda a competir con más de 34.000 propiedades en todo el mundo, a las que se añade más inventario regularmente. Esto incluye las propiedades de nueva adquisición y el inventario adicional de los alojamientos actuales.
Detalles técnicos
La EGI no forma parte del inventario estándar en Rapid API,, pero puede activarse explícitamente si se solicita. Presenta comportamientos dinámicos y patrones de integración que difieren del inventario estándar, lo que requiere una atención especial en los flujos de trabajo de ingestión de contenidos, compras y reservas.
Archivos de contenido
Actualmente, las API de archivos de contenido rápido y archivos de catálogo para EGI sólo admiten contenidos de English-language. Si tu sistema requiere archivos de contenido localizados (non-English), puedes generarlos localmente utilizando las API Contenido de propiedades y Geografía. Estas API ofrecen real-time streaming y un manejo flexible de los datos para todos los lenguajes de contenido, lo que facilita la extracción de la información necesaria de las respuestas de la API JSON-formatted. Puedes almacenar la respuesta JSON sin procesar localmente para procesarla más tarde o transformarla para importarla a una base de datos u otros casos de uso.
Ejemplo de solicitud de una lista de propiedades de una región mediante la API de Geografía:
/regions?country_code=US&language= it-IT&include=property_ids_expanded&include=property_idsEjemplo de solicitud de contenido del catálogo utilizando la API de contenido del alojamiento:
/properties/content?language=it-IT&supply_source=expedia&property_id={property_id}&include=catalogPuedes optar por dar prioridad al lanzamiento de la integración de Contenidos para EGI y al mismo tiempo asignar tiempo adicional para revisar los flujos de trabajo de Compras y Reservas, o puedes lanzar los tres componentes juntos cuando te sientas preparado para EGI. Para más detalles sobre la configuración, ponte en contacto con tu asesor de integración.
Alineación de los datos de la sala
Pueden aparecer nuevas salas de propiedades en la API de compras antes de que tu sistema esté totalmente sincronizado con la API de contenido de propiedades. Para mantener una experiencia de usuario coherente, considera la posibilidad de excluir temporalmente estas salas de la visualización de los clientes, activando una llamada a la API de contenido real-time para la nueva sala, o aumentando la frecuencia de las actualizaciones de tu contenido local para minimizar el retraso de los datos.
Identificador de tasa
Las tasas EGI están estructuradas de forma diferente al inventario estándar y se adhieren a un modelo de datos más dinámico. Como no existe un valor estático para estas tarifas, la API de Compras las devuelve con un valor dinámico rate_idque no se corresponde con los valores de la API de Contenido del alojamiento. Este valor de cadena dinámica consta de dígitos, letras y otros símbolos, que pueden variar en cada respuesta de la API de Compras. Por ello, el valor rate_ides inestable y no debe utilizarse como identificador persistente o clave primaria. Si tu sistema necesita distinguir tarifas entre procesos, considera la posibilidad de emparejarlas con una combinación de atributos de política y características de oferta. Consulta este documento seguro para más detalles.
Ejemplo del valor rate_id en una respuesta de la API de Compras:
[
{
"property_id": "ABC152",
"status": "available",
"rooms": [
{
"id": "XYZ652",
"room_name": " Deluxe Double ",
"rates": [
{
"id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
… …Variabilidad de la configuración de la cama
En circunstancias excepcionales, algunas habitaciones pueden no tener designadas configuraciones de cama, lo que se indica tanto en la API de Contenido como en la de Compras mediante un ID bed_groupsde 0 y la descripción "Cama no especificada". Esto implica que la propiedad determinará la disposición de las camas al check-in. Aunque este caso es poco frecuente, tu sistema debe mantener informado al cliente y, si tiene preferencias muy marcadas, ayudarle a comunicar sus peticiones especiales a nuestro equipo de operaciones de atención al cliente.
Ejemplo de configuración de cama no especificada en una respuesta de la API de Compras:
{
"bed_groups": {
"0": {
"id": "0",
"description": "Bed Not Specified",
"links": {
"price_check": {
… …Retención y reanudación
Algunas tarifas EGI son incompatibles con el flujo de trabajo de la API de reservas Retener y reanudar y devolverán errores si se intenta retener. Para evitar malas experiencias a los clientes, puedes solicitar la bandera de tasa retenible en la respuesta de la API de Compras y seguirla para aplicar el flujo de trabajo correcto.
Ejemplo de solicitud de indicador de tasa retenible:
Request:
/properties/availability?... …&include=rooms.rates.holdable
Response:
… …
"rooms": [
{
"id": "XYZ652",
"room_name": "Deluxe Double Room",
"rates": [
{
"id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
“holdable”: true,
… …Post-booking características
Tras la confirmación de una reserva a través de la API de Reservas, la reserva se entregará en la página Gestionar API de Reservas. Los enlaces a los tokens para acceder a las funciones de post-booking, como Cambio suave, Cambio fuerte y Centro de mensajes del alojamiento, también estarán disponibles en las API de Gestión de reservas. Ocasionalmente, los enlaces simbólicos pueden tardar hasta cinco minutos en estar listos. Es importante tener en cuenta que estas funciones no están disponibles para todas las reservas y que deben gestionarse adecuadamente en tu sistema.
Diferencias clave en EGI
| Característica / comportamiento | Inventario estándar | Inventario global ampliado |
|---|---|---|
| Disponibilidad por defecto | Activado por defecto | Activación previa solicitud |
| Identificador de tasa | Estática, persistente | Dinámico, varía según la tienda |
| Soluciones de contenido | Compatible con API de archivos y API de contenidos en streaming | Compatible con las API de archivos para contenidos en inglés y las API de contenidos en streaming para todos los idiomas |
| Requisito de sincronización de contenidos | Sincronización diaria de propiedades populares | Sincronización diaria de propiedades populares |
| Configuración de camas | Especificado | Puede ser no especificado en casos raros |
| Retención y reanudación | Disponible para todas las reservas | Disponible para algunas reservas |
| Post-booking características | Disponible para todas las reservas | Disponible para algunas reservas |