Get Products (GET /products): cuando Civitatis 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}): Civitatis 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 Civitatis: Civitatis vincula cada opción y unidad de Ventrata con su propio anuncio y sus tipos de entrada. Su gestor de cuenta en Civitatis lo hace por usted, o lo hace usted mismo en el portal de Civitatis, si Civitatis ofrece uno. Usted solo comparte la clave API de la conexión.

Civitatis lee su lista completa de productos aproximadamente una vez al día.

Vuelve a leer cada producto aproximadamente cada 30 minutos.

Capability octo/content: cuando Civitatis 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 Civitatis en su siguiente actualización de productos.

Civitatis solicita octo/content.

Availability Check (POST /availability): Civitatis 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 Civitatis 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.

Availability Batch (POST /availability/batch): disponibilidad de muchos productos en una sola solicitud, pensada para sincronizaciones en segundo plano.

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

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

Availability Calendar: Civitatis consulta cada producto aproximadamente cada 12 horas.

Availability Batch: Civitatis consulta sus productos las 24 horas, 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 cada pocos minutos.

Las consultas se reparten a lo largo del día sin un pico marcado, lo que sugiere una combinación de sincronizaciones programadas y búsquedas de clientes en tiempo real.

Capability octo/pricing: Civitatis 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 Civitatis, 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 Civitatis 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ó.

Civitatis solicita octo/pricing solo en una parte de sus consultas de disponibilidad, por lo que es posible que no todos los anuncios usen sus precios de Ventrata.

Civitatis envía el número de personas por tipo de unidad, de modo que los precios de grupo se calculan según la reserva real.

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

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

Es normal ver más retenciones que reservas confirmadas: las retenciones de clientes que no terminan de pagar simplemente caducan.

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

Capability octo/pickups: Civitatis puede ver qué opciones ofrecen recogida y sus puntos de recogida, y enviar con la reserva el punto de recogida o el hotel del cliente.

Si un hotel no coincide con ninguno de sus puntos de recogida, Ventrata lo guarda con la reserva para que pueda organizar la recogida.

Civitatis envía los datos de recogida con sus reservas.

Capability octo/questions: Civitatis lee las preguntas configuradas en sus productos y envía las respuestas del cliente con la reserva, y usted las ve en Ventrata.

Civitatis no suele enviar las respuestas a las preguntas de reserva. Si depende de ellas, por ejemplo para nombres o necesidades alimentarias, consulte con Civitatis cómo las recopila.