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

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

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

Xplorie solicita octo/content.

Availability Check (POST /availability): Xplorie 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 Xplorie necesita para reservar esa franja.

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

Availability Check: Xplorie consulta sus productos a lo largo del día, normalmente a partir de unos 3 meses vista y cubriendo 30 días por solicitud; consulta hasta aproximadamente un año vista y vuelve a consultar el mismo producto y las mismas fechas aproximadamente cada 19 horas.

Las consultas son más frecuentes entre las 16:00 y las 22:00 UTC, lo que sugiere que la mayoría se realizan en tiempo real, mientras los clientes navegan por Xplorie.

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

Xplorie 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.

Xplorie 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 Xplorie.

Capability octo/offers: con ella, Ventrata aplica a los precios de disponibilidad y a las reservas las promociones que correspondan, y Xplorie también puede enviar un código promocional (offerCode).

Las promociones funcionan junto con los precios, por lo que también necesitan octo/pricing.

Esto abarca las promociones que usted crea en Ventrata (promociones iniciadas por el proveedor).

Xplorie solicita octo/offers.

Xplorie retiene las plazas durante unos 60 minutos mientras el cliente paga (expirationMinutes).

Una reserva típica de Xplorie es de aproximadamente 4 personas.

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