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

City Sightseeing Worldwide lee su lista completa de productos aproximadamente cada 11 horas.

Vuelve a leer cada producto aproximadamente cada 9 horas.

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

City Sightseeing Worldwide solicita octo/content.

Availability Check (POST /availability): City Sightseeing Worldwide 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 City Sightseeing Worldwide 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 City Sightseeing Worldwide no puede sobrevender una franja que acaba de agotarse, aunque la disponibilidad que tiene almacenada esté ligeramente desactualizada.

Availability Check: City Sightseeing Worldwide consulta sus productos a lo largo del día, normalmente a partir de 10 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: City Sightseeing Worldwide consulta cada producto aproximadamente una vez al día.

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: City Sightseeing Worldwide 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 City Sightseeing Worldwide, 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 City Sightseeing Worldwide 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ó.

City Sightseeing Worldwide no suele solicitar octo/pricing, por lo que lo más probable es que utilice precios almacenados por su parte, que usted tendría que mantener actualizados con City Sightseeing Worldwide a mano.

City Sightseeing Worldwide retiene las plazas durante unos 60 minutos mientras el cliente paga (expirationMinutes).

Una reserva típica de City Sightseeing Worldwide 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.