Get Mappings (Ventrata → Viator, cuando abre la conexión en el Dashboard): Ventrata accede automáticamente a su cuenta de Viator y obtiene la lista de todos los productos y opciones de la cuenta, incluidos su estado y su configuración de conectividad. Ventrata puede hacerlo porque usted lo invitó como su sistema de reservas en el paso 1.

Update Mappings (Ventrata → Viator, cuando pulsa Actualizar mapeo de conexión (Update Connection Mapping)): Ventrata accede al producto correspondiente de su cuenta de Viator, verifica configuraciones básicas como las categorías de entrada, elimina la disponibilidad, los precios y las promociones (ofertas especiales) configurados anteriormente y actualiza el mapeo en la configuración de conectividad según su selección. Conecta la opción de Viator elegida con su opción de Ventrata y aplica la configuración de sincronización de precios del producto.

Mapping catalog (POST /v2/mappings/catalog) y Mapping connect (POST /v2/mappings/connect) (Ventrata → Viator, aproximadamente cada hora): Ventrata lee sus productos y opciones de Viator con su estado de mapeo (Mapped, Unmapped o Paused) y envía sus mapeos a Viator. Son las API de mapeo de productos de Viator.

Tour List (POST /tourlist) (Viator → Ventrata): Viator obtiene la lista de productos y opciones disponibles en la conexión, con sus identificadores de Ventrata. Viator los muestra en la pestaña Product Connection de Viator Management Center, que es la lista entre la que elige cuando mapea en Viator (método 2). Ventrata responde con Get Products (GET /products) de OCTO.

Pricing Categories (mediante Calendar, Viator → Ventrata): además, Viator obtiene los datos de las unidades (tipos de entrada) de su producto y sus precios, y los actualiza en consecuencia.

Viator vuelve a leer su lista de productos con Tour List varias veces al día por conexión.

La comprobación de mapeo de Ventrata se ejecuta aproximadamente cada hora. Lee el catálogo de mapeo de Viator aproximadamente cada 30 minutos.

Ventrata lee y escribe sus productos de Viator desde el Dashboard solo cuando abre o actualiza la conexión.

Calendar (POST /v2/availability/calendar) (Viator → Ventrata): Viator solicita una o varias opciones de producto para un intervalo de fechas. Ventrata responde con cada fecha u hora de inicio reservable, su estado, el aforo restante por tipo de entrada, el límite de reserva y los precios. Viator lo utiliza para rellenar el calendario de la página de su producto. Ventrata responde con Availability Check (POST /availability) de OCTO.

Availability Check (POST /v2/availability/check) (Viator → Ventrata): cuando un cliente elige un producto, una fecha y una combinación de viajeros, Viator consulta el aforo y el precio en tiempo real para esa elección exacta, y de nuevo a medida que el cliente avanza en el proceso de pago. Ventrata responde con Availability Check de OCTO.

Event Notification (POST https://api.viator.com/v2/notification/events) (Ventrata → Viator, cada vez que cambia la disponibilidad en Ventrata, por ejemplo tras una reserva, una cancelación o un cambio de aforo o de tarifa): Ventrata comunica a Viator qué opciones de producto y fechas han cambiado, y cómo: una franja se ha agotado o se ha reabierto (AVAILABILITY), su aforo restante ha cambiado (CAPACITY) o su precio ha cambiado (PRICING). Después, Viator vuelve a leer esas fechas. Viator procesa primero las actualizaciones de AVAILABILITY y PRICING.

Comprobación al reservar: cuando un cliente empieza a pagar, la llamada Reserve de Viator hace que Ventrata vuelva a comprobar el aforo antes de bloquear las plazas. Así, Viator no puede sobrevender una franja que acaba de agotarse.

Calendar: constante las 24 horas del día, lo que apunta a una sincronización programada en segundo plano más que a búsquedas de clientes en tiempo real.

Availability Check: las 24 horas del día, con más actividad en las horas punta de compra, porque sigue la navegación de los clientes.

Event Notification: Ventrata las envía las 24 horas del día, a medida que se producen cambios en Ventrata.

Un pequeño número de productos más antiguos todavía usa la llamada heredada Real-time Availability de Viator (v1.0).

No hemos podido medir con cuánta antelación lee Viator con Calendar, porque las fechas viajan en el cuerpo de la solicitud.

Calendar y Availability Check (Viator → Ventrata): cada fecha u hora de inicio se devuelve con un precio por tipo de entrada (por ejemplo, Adulto o Niño) en su moneda. La API de Viator admite precios por persona, precios por persona escalonados y precios por unidad (por ejemplo, por coche, barco o grupo).

Precios de revendedor: los precios proceden de los precios del revendedor Viator en Ventrata (venta al público, mayorista/comisión), que la conexión hereda. La API de Viator también puede transmitir un precio neto por tipo de entrada. Viator lo utiliza con los operadores que tienen un acuerdo de precio neto.

Event Notification (PRICING, Ventrata → Viator): cuando cambia el precio de venta al público de un tipo de entrada, incluidas nuevas ofertas especiales o descuentos, Ventrata avisa a Viator, y Viator vuelve a leer el precio.

Reserve (Viator → Ventrata): el bloqueo conserva tanto el precio como las plazas, de modo que el cliente paga el precio que se le mostró.

Categorías de precios: Viator admite bebé, niño, joven, adulto y sénior. Utiliza Traveler cuando no hay restricción de edad. Las categorías deben cubrir las edades de 0 a 99 años sin huecos ni solapamientos.

Los precios se devuelven con cada Calendar y Availability Check, por lo que Viator los obtiene con la misma frecuencia con que lee la disponibilidad.

Calendar y Availability Check (Viator → Ventrata): cuando una promoción se aplica a una fecha, Ventrata devuelve el precio de venta al público con descuento junto con el precio de venta al público original y el ID de la oferta especial.

Special Offers (POST /v2/product/special-offers) (Viator → Ventrata): Viator solicita los detalles de esas ofertas, como el nombre de la oferta, su tipo y las fechas de validez. Ventrata responde a partir de sus promociones de Ventrata. Viator lo utiliza para mostrar una etiqueta de oferta especial en las fechas con descuento. La etiqueta no cambia el precio de venta recomendado.

Mapeo desde el Dashboard: cuando actualiza un mapeo, Ventrata elimina las ofertas especiales configuradas anteriormente en ese producto de Viator, para que sus ofertas procedan de Ventrata.

Viator llama a Special Offers las 24 horas del día, solo para los proveedores cuyos productos tienen promociones.

Ventrata no suele enviar llamadas Special Offers Notification. Viator recoge las ofertas mediante Calendar y Special Offers.

Cada reserva empieza con Reserve y sigue con Booking. Hay más bloqueos que reservas confirmadas. Es normal: los bloqueos de clientes que no terminan de pagar simplemente vencen.

Las modificaciones y cancelaciones llegan a lo largo del día.

Viator le envía un correo electrónico solo cuando falla una reserva, modificación o cancelación por API (el procedimiento alternativo de Viator). Las llamadas a la API que se completan correctamente no generan ningún correo.

Redemption (POST /redemption) (Viator → Ventrata): Viator solicita el estado de canje de una reserva confirmada y de cada viajero que incluye. Ventrata localiza la reserva por su referencia con List Bookings (GET /bookings) de OCTO y responde si las entradas se han canjeado. Viator utiliza la respuesta para decidir si se debe permitir una cancelación o un reembolso.

Viator consulta el estado de canje a lo largo del día, con mucha más frecuencia de la que envía cancelaciones.

Ventrata no envía actualizaciones de canje a Viator por iniciativa propia.

Booking (Viator → Ventrata): si la casilla de recogida en el hotel está activada para su producto de Viator, el cliente elige su hotel en el desplegable de Viator, y Viator lo envía en el campo de punto de recogida de la reserva. Si, en cambio, recoge los datos de recogida en el campo de requisitos especiales de Viator, llegan ahí.

Booking Amendment (Viator → Ventrata): los cambios en los datos del hotel llegan como una modificación.

Los datos de recogida solo llegan con las reservas y las modificaciones. La API de Viator no tiene ninguna llamada para leer sus puntos de recogida de Ventrata, ni un campo de bajada aparte.

Booking (Viator → Ventrata): la información que el cliente introduce durante el proceso de reserva de Viator, como los datos del vuelo y del crucero, se envía en los campos de preguntas y respuestas de la reserva.

Contacto del cliente: Viator nunca comparte la dirección de correo electrónico real del cliente. Envía el número de teléfono si el cliente lo facilita.

Las preguntas se configuran en Viator. La API de Viator no tiene ninguna llamada para leer sus preguntas de reserva de Ventrata.