Exchange Code For Tokens (POST /v2/oauth2/authorizations): Ventrata → Airbnb, una sola vez, cuando hace clic en Conéctate con Airbnb (Connect with Airbnb) y en Permitir (Allow). Airbnb da a Ventrata acceso para gestionar el calendario y las reservas de sus fichas de Airbnb. Los tokens de acceso de Airbnb tienen una duración corta, por lo que Ventrata renueva este acceso automáticamente en segundo plano (Refresh Access Token, misma ruta).

Get Activities (GET /v2/activities) y List all offerings (GET /v2/activities/{id}/offerings): Ventrata → Airbnb, cuando abre la página de la conexión. Ventrata lee sus fichas de Airbnb y las muestra a la izquierda de la tabla de mapeo.

Set Attributes (PUT /v2/activities/{id}/attributes): Ventrata → Airbnb, cuando hace clic en Actualizar mapeo (Update Mapping). Tras leer la ficha, Ventrata envía los tipos de huésped que vende su opción (Adulto, Niño, Bebé), sus límites de edad según sus unidades de Ventrata y la edad mínima.

Set Activity Availability (PUT /v2/activities/{id}/availability): Ventrata → Airbnb, al ejecutar Actualizar mapeo (Update Mapping). Ventrata activa la sincronización de disponibilidad, lo que convierte a Ventrata en la fuente de referencia de la ficha y activa las consultas en tiempo real de Airbnb antes de cada reserva.

Set Offering (PUT /v2/activities/{id}/offerings/{id}): Ventrata → Airbnb, al ejecutar Actualizar mapeo (Update Mapping). Ventrata guarda los ID de su conexión, producto y opción de Ventrata en la oferta de Airbnb. Airbnb devuelve estos ID con cada consulta y reserva, y así es como Ventrata sabe qué producto está reservando un huésped.

Set Offering Availability (PUT …/offerings/{id}/availability) y Set Offering Pricing (PUT …/offerings/{id}/pricing): Ventrata → Airbnb, al ejecutar Actualizar mapeo (Update Mapping). Ventrata establece los límites de grupo de toda la ficha, la antelación de reserva y el tipo de reserva (por ejemplo, una reserva pública compartida), de modo que el aforo que Ventrata envía por franja horaria y la consulta en tiempo real de Ventrata deciden qué se puede reservar.

Set Instances (POST /v2/activities/{id}/instances): Ventrata → Airbnb, al final de Actualizar mapeo (Update Mapping). Ventrata crea sus franjas horarias en el calendario de Airbnb (consulte Availability Sync).

Actualizaciones de mapeo en cola: algunas actualizaciones de mapeo se ejecutan como tarea en segundo plano con los mismos pasos. La tarea lee su producto a través de la API OCTO de Ventrata con Get Product (GET /products/{productId}).

Las llamadas de mapeo solo se producen cuando alguien se conecta, abre la página de una conexión o hace clic en Actualizar mapeo (Update Mapping).

Las renovaciones de acceso y las actualizaciones de mapeo en cola se ejecutan en segundo plano las 24 horas.

Get Instances (GET /v2/activities/{id}/instances) y Set Instances (POST /v2/activities/{id}/instances): Ventrata → Airbnb, en cuanto cambia la disponibilidad en Ventrata, por ejemplo tras una reserva en cualquier canal, una cancelación o un cambio de aforo o de horario. Ventrata lee las franjas horarias que Airbnb tiene para las fechas afectadas, las compara con Ventrata y envía solo las diferencias en un único lote: nuevas franjas que crear, franjas cuyo límite de huéspedes (plazas restantes) o precio ha cambiado, y franjas que eliminar porque ya no están disponibles.

API OCTO de Ventrata: para calcular cada actualización, el adaptador de Ventrata lee su producto y su disponibilidad en tiempo real a través de la propia API OCTO de Ventrata: Get Product (GET /products/{productId}) y Availability Check (POST /availability).

Resincronización en segundo plano: Ventrata → Airbnb, las 24 horas. Una tarea programada recorre las fichas mapeadas, vuelve a comparar las franjas horarias de Airbnb con Ventrata y corrige las que se hayan desviado, enviando de nuevo solo las diferencias. Algunas actualizaciones de disponibilidad también se ponen en cola y se envían como tarea en segundo plano.

Check Availability (GET /airbnb/endpoint/reservation): Airbnb → Ventrata, en tiempo real, antes de que un huésped pase al pago. Airbnb envía la ficha, los ID de producto y opción de Ventrata guardados en el mapeo, la hora de inicio y el número de adultos, niños y bebés. Ventrata busca el producto con Get Product (GET /products/{productId}), comprueba en tiempo real esa franja horaria y esos tipos de huésped, y responde sí o no. Airbnb espera una respuesta en 2 segundos. Si la respuesta es no, o la consulta falla o tarda demasiado, el huésped no puede reservar y Airbnb elimina esa franja horaria de su calendario.

Los envíos de disponibilidad se ejecutan las 24 horas, siguiendo las reservas y los cambios que se producen en Ventrata. Cubren fechas desde hoy hasta aproximadamente un año vista, la mayoría para las próximas semanas.

La resincronización en segundo plano se ejecuta las 24 horas.

Check Availability llega de forma uniforme a lo largo de las 24 horas, sobre todo para fechas de las próximas cuatro semanas. Airbnb consulta con mucha más frecuencia de la que reservan los huéspedes, por lo que la mayoría de las consultas no terminan en reserva.

Set Offering Pricing (PUT /v2/activities/{id}/offerings/{id}/pricing): Ventrata → Airbnb, al ejecutar Actualizar mapeo (Update Mapping). Ventrata establece la configuración de precios de la ficha, por ejemplo que se vende como reserva pública compartida.

Set Attributes (PUT /v2/activities/{id}/attributes): Ventrata → Airbnb, al ejecutar Actualizar mapeo (Update Mapping). Ventrata envía sus tipos de huésped y rangos de edad, para que los tipos Adulto, Niño y Bebé de Airbnb coincidan con sus unidades de Ventrata.

Set Instances (POST /v2/activities/{id}/instances): Ventrata → Airbnb, con las actualizaciones de disponibilidad. Cuando hay que actualizar el precio de una franja horaria, Ventrata envía el precio de adulto, niño y bebé de esa franja, de modo que los precios específicos por fecha y hora de Ventrata llegan a Airbnb. Los precios proceden de los precios del revendedor Airbnb en Ventrata.

Tarifas de tamaño de la reserva (Booking Size): los recuentos de niveles del partner se sincronizan cuando hace clic en Actualizar mapeo (Update Mapping). Después de cada cambio de tarifa, vuelva a actualizar el mapeo del producto y asegúrese de que la tarifa está habilitada para la venta a través de la API directa (Direct API).

Los precios viajan con los envíos de disponibilidad, las 24 horas. La mayoría de los envíos solo cambian las plazas restantes; los precios se incluyen cuando hay que actualizar el precio de una franja.

La configuración de precios de toda la ficha y los tipos de huésped solo se envían al ejecutar Actualizar mapeo (Update Mapping).

Las reservas, modificaciones y cancelaciones llegan las 24 horas, y cada una se gestiona en el momento en que se produce.

Cada nueva reserva llega a Ventrata como una llamada Make Reservation y como un webhook. Ventrata los relaciona mediante el código de confirmación de Airbnb.

Cada nueva reserva va seguida de un mensaje con las entradas.

Las comprobaciones de modificación (Update Reservation) son poco frecuentes.

Entradas: Ventrata → Airbnb, justo después de cada reserva: el enlace a la entrada en PDF, el enlace a la entrada para el monedero digital y, para algunos productos, imágenes de los códigos QR, todo en los mensajes de Airbnb del huésped (consulte Bookings Sync). Los huéspedes las muestran en su entrada, y usted las escanea y canjea en Ventrata como cualquier entrada de Ventrata.

Sin actualizaciones de canje: Ventrata no envía a Airbnb ninguna actualización cuando se escanea o canjea una entrada, ni cuando un huésped no se presenta.

No vemos ninguna llamada que comunique canjes o no presentaciones a Airbnb.