Get Products (GET /products): cuando Destination Italia configura su conexión, y cada vez que actualiza sus anuncios, lee todos los productos habilitados en la conexión, con sus opciones y unidades (tipos de entrada, como Adulto o Niño).

Get Product (GET /products/{productId}): Destination Italia vuelve a leer un producto concreto para recoger los cambios en sus opciones, unidades, plazos límite de reserva y ajustes.

Mapeo por parte de Destination Italia: Destination Italia vincula cada opción y unidad de Ventrata con su propio anuncio y sus tipos de entrada. Su gestor de cuenta en Destination Italia lo hace por usted, o lo hace usted mismo en el portal de Destination Italia, si Destination Italia ofrece uno. Usted solo comparte la clave API de la conexión.

Destination Italia lee su lista completa de productos cada pocos días.

Vuelve a leer cada producto aproximadamente cada 2 horas.

Capability octo/content: cuando Destination Italia la añade a la cabecera Octo-Capabilities, Get Products (GET /products) y Get Product (GET /products/{productId}) también devuelven el contenido de sus productos, como descripciones, puntos destacados, servicios incluidos e imágenes.

Los cambios de contenido en Ventrata llegan a Destination Italia en su siguiente actualización de productos.

Destination Italia solicita octo/content.

Availability Check (POST /availability): Destination Italia envía un producto, una opción y una fecha o un intervalo de fechas. Ventrata responde con cada día o franja horaria reservable, su estado (AVAILABLE, LIMITED, SOLD_OUT, CLOSED o FREESALE), las plazas restantes, el plazo límite de reserva y un availabilityId, que Destination Italia necesita para reservar esa franja.

Availability Calendar (POST /availability/calendar): devuelve un resumen por día en lugar de cada franja horaria, normalmente para mostrar qué fechas están abiertas en un selector de fechas.

Comprobación al reservar: cuando un cliente reserva, Ventrata vuelve a comprobar el aforo antes de crear la reserva, de modo que Destination Italia no puede sobrevender una franja que acaba de agotarse, aunque la disponibilidad que tiene almacenada esté ligeramente desactualizada.

Availability Check: Destination Italia consulta sus productos a lo largo del día, normalmente a partir de hoy y cubriendo aproximadamente un año por solicitud; consulta hasta aproximadamente un año vista y vuelve a consultar el mismo producto y las mismas fechas aproximadamente cada 10 horas.

Availability Calendar: Destination Italia consulta sus productos a lo largo del día, normalmente a partir de 13 días vista y cubriendo unos 4 meses por solicitud; consulta hasta aproximadamente un año vista y vuelve a consultar el mismo producto y las mismas fechas aproximadamente cada 7 horas.

Las consultas se concentran entre las 11:00 y las 17:00 UTC, lo que sugiere que la mayoría se hacen en tiempo real, mientras los clientes navegan por Destination Italia.

Capability octo/pricing: Destination Italia solicita los precios añadiendo octo/pricing a la cabecera Octo-Capabilities de sus solicitudes. Sin ella, Ventrata envía la disponibilidad sin ningún precio.

Availability Check (POST /availability): con los precios activados, cada día o franja horaria se devuelve con su precio por unidad (tipo de entrada): el precio de venta al público que paga el cliente y el precio neto que usted factura a Destination Italia, ambos a partir de los precios del revendedor en Ventrata (de venta al público y mayoristas o de comisión).

Precios para grupos: cuando Destination Italia también envía cuántas personas de cada tipo de unidad reservan, Ventrata calcula el precio de ese grupo exacto. Esto es importante para las tarifas por tamaño de la reserva (Booking Size) y otros precios para grupos.

Booking Reservation (POST /bookings) y Booking Confirmation (POST /bookings/{uuid}/confirm): la reserva se devuelve con su precio final de venta al público y neto, de modo que la reserva en Ventrata siempre registra el precio al que se vendió.

Destination Italia solicita octo/pricing en todas sus consultas de disponibilidad, por lo que vende con sus precios de Ventrata.

Destination Italia no envía el número de personas por tipo de unidad, por lo que los precios se devuelven por persona, y los precios para grupos, como las tarifas por tamaño de la reserva (Booking Size), podrían no mostrarse correctamente en Destination Italia.

Destination Italia no establece un tiempo de retención, por lo que se aplica el tiempo de retención predeterminado.

Una reserva típica de Destination Italia es para unas 2 personas.

Destination Italia también comprueba las reservas que ha realizado, con Get Booking (GET /bookings/{uuid}) aproximadamente cada 8 horas, por ejemplo para conciliar sus registros.