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

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

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

Capability octo/pickups: Giftory 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.