Ir al contenido principal

Zaui: backend de operador

Conecte Zaui con Ventrata para revender productos de operadores de Zaui con disponibilidad, precios y reservas en tiempo real.

Zaui logo

 

Zaui es una plataforma de reservas con sede en Vancouver para operadores de tours, actividades, transporte y alquileres, en funcionamiento desde 1999 y diseñada para inventario basado en plazas y horarios. Destaca especialmente en empresas centradas en el transporte, como lanzaderas, autocares interurbanos, traslados al aeropuerto y al puerto de cruceros y servicios de barco, además de excursiones y circuitos de varios días, con gestión de canales, precios dinámicos y check-in móvil desde un único panel.

 

Conectar Zaui con Ventrata le permite revender productos de operadores que utilizan Zaui como sistema de reservas. Ventrata lee su disponibilidad y sus precios en tiempo real desde Zaui, y cada reserva que recibe se crea directamente en la cuenta de Zaui del operador.

 

Para obtener más información sobre Zaui, visite zaui.com.

 

📒 NOTA

¿Prefiere que Zaui revenda sus productos? Consulte Zaui: conexión de revendedor.

 

Sitio web principal

Etiquetas

Booking / Ticketing System

Funciones de la conexión

Availability Sync · Pricing Sync · Bookings Sync

Desarrollado por

Ventrata (mediante la API OCTO de Zaui)

 

Esta conexión de operador (también llamada backend) le permite revender productos de operadores que utilizan Zaui como su sistema de reservas principal, y cada reserva se crea directamente en Zaui. Entre las funcionalidades de esta conexión se incluyen:

  • Availability Sync: la disponibilidad en tiempo real procede de la cuenta de Zaui del operador.

  • Pricing Sync: los precios proceden de Zaui, o usted establece los precios en Ventrata.

  • Bookings Sync: las reservas, modificaciones y cancelaciones se envían de Ventrata a Zaui, y Zaui emite las entradas o los vouchers.

 

Crear la conexión con Zaui

🔐 Permisos de rol necesarios: See Operators, Modify Operators, See Products, Modify Products

Antes de empezar:

  • Debe tener un acuerdo comercial con el operador sobre sus tarifas y condiciones.

  • Debe tener la OCTO API Key para el operador. Consulte los pasos que se indican a continuación.

  • Debe volver a crear los productos del operador en Ventrata. Consulte cómo crear productos. La conexión sincroniza la disponibilidad, los precios y las reservas, pero no crea productos en Ventrata.

 

Paso 1: Configurar el operador en Ventrata

Pida a su operador la clave API de OCTO. Los operadores pueden configurar la conexión (canal) y obtener la clave en Zaui, en Resellers > Channel Partners, y seleccionar después Ventrata.

 

  1. En el Ventrata Dashboard, vaya a Productos → Operadores (Products → Operators) y abra el operador. Si todavía no existe, primero créelo como operador.

  2. En la sección Socio de backend (Backend Partner), seleccione Zaui e introduzca la clave API de OCTO (OCTO API Key). Deje el endpoint con el valor predeterminado https://api.zaui.io/octo, salvo que el operador o Zaui le indiquen otra cosa.

  3. Deje en el campo Endpoint de OCTO (OCTO Endpoint) el valor ya rellenado para Zaui, salvo que el operador o Zaui le indiquen lo contrario.

  4. Press Update Operator.

 

 

En la sección Socio de backend (Backend Partner), elija Zaui en la lista de conexiones disponibles e introduzca la OCTO API Key que le ha proporcionado su operador. Salvo que el operador o Zaui le indiquen lo contrario, deje en el campo Endpoint de OCTO (OCTO Endpoint) el valor predeterminado ya rellenado para Zaui

 

📒 NOTA – Cada OCTO API Key le conecta con un operador. Configure cada operador de Zaui por separado.

 

Paso 2: conecte cada producto

  1. Abra el producto del operador en Productos → Productos (Products → Products) y edítelo. Compruebe que el Operador sea este operador.

  2. Marque Backend conectado (Backend Connected). Marque Disponibilidad del backend (Backend Availability) para usar la disponibilidad de Zaui y Precios del backend (Backend Pricing) para usar los precios de Zaui.

  3. Press Update Product.

📒 NOTA

Zaui envía tanto los precios de venta al público como los precios netos. Con Precios del backend (Backend Pricing) marcado, Ventrata registra el precio de venta al público como su precio de venta y el precio neto como su precio de coste, independientemente del porcentaje de coste configurado en el operador.

 

Marque Disponibilidad del backend (Backend Availability) para obtener la disponibilidad de Zaui y Precios del backend (Backend Pricing) para obtener los precios.

 

Sin ellos, el producto usa la disponibilidad y los precios configurados en Ventrata, pero sigue enviando las reservas a Zaui.

 

Marque Backend conectado (Backend Connected) en este producto para usar la conexión API (backend). Para obtener la disponibilidad de Zaui, asegúrese de que Disponibilidad del backend (Backend Availability) esté marcada; para obtener los precios, marque Precios del backend (Backend Pricing). Si no marca Disponibilidad del backend o Precios del backend, el producto usará la disponibilidad o los precios configurados en Ventrata, pero seguirá enviando las reservas a Zaui. Haga clic en Actualizar Producto (Update Product) para guardar.

 

Mapear productos con Zaui

‼️ IMPORTANTE

El mapeo indica a Ventrata para qué producto, opción y unidades de Zaui debe consultar la disponibilidad y realizar la reserva. Si un producto conectado al backend no está bien mapeado, sus reservas fallan. Un resaltado en rojo en toda la fila del producto indica que el producto está mal mapeado.

 

  1. En el Ventrata Dashboard, vaya a Productos → Productos (Products → Products) y abra el producto.

  2. Abra la pestaña Mapeos (Mappings). Aparece una vez que el producto tiene marcado Backend conectado (Backend Connected).

  3. Para cada opción y unidad de Ventrata, seleccione el producto, la opción y las unidades correspondientes de Zaui en las listas desplegables, que Ventrata carga desde Zaui. No deje ningún campo vacío.

  4. Press Save Changes.

 

La página del producto mostrará ahora una pestaña Mapeos (Mappings). Vaya a esta pestaña y mapee su producto, sus opciones y sus unidades de Ventrata seleccionando los productos, opciones y unidades correspondientes en las listas desplegables recibidas de Zaui. Asegúrese de que no quede ningún campo vacío (sin mapear) y haga clic en Guardar cambios (Save Changes).

 

📗 CONSEJO

Haga una reserva de prueba después del mapeo y pida al operador que confirme que ha llegado a su cuenta de Zaui.

 

Gestionar la conexión con Zaui

  • Actualice el mapeo cuando el operador cambie productos, opciones o unidades en Zaui.

  • Sustituya la clave en el operador si Zaui o el operador emiten una nueva.

  • Desactive Disponibilidad del backend o Precios del backend (Backend Availability / Backend Pricing) en un producto para usar la disponibilidad o los precios propios de Ventrata. Las reservas se siguen enviando a Zaui.

 

Funciones de la conexión en detalle

Esta sección es para quien quiera saber exactamente cómo funciona la conexión con Zaui. Aquí el sentido es el contrario al de una conexión de revendedor: Ventrata llama a Zaui mediante la API OCTO de Zaui. Para cada funcionalidad, se explica qué llamadas realiza Ventrata, cuándo y qué significa para usted.

 

En resumen: Ventrata solicita a Zaui la disponibilidad y los precios cada vez que alguien consulta un producto conectado al backend, y crea cada reserva en la cuenta de Zaui del operador. Zaui no envía cambios de vuelta a Ventrata.

 

Los tiempos son los habituales en Zaui, están redondeados y pueden cambiar.

 

Product Mapping

✅

Usted mapea cada producto, opción y unidad de Ventrata con el producto de Zaui del operador en el Ventrata Dashboard.

Funciona así:

  • Get Products (GET /products): Ventrata lee los productos, opciones y unidades de Zaui del operador para rellenar las listas desplegables de la pestaña Mapeos (Mappings).

 

Qué significa esto para usted: si falta algo en la lista desplegable, el operador no se lo ha puesto a su disposición en Zaui. Pídale que lo haga.

Content Sync

❌

Ventrata no importa el contenido de los productos desde Zaui.

Ventrata no importa el contenido de los productos desde Zaui. Usted mismo crea y describe los productos en Ventrata.

Availability Sync

✅

Con Disponibilidad del backend (Backend Availability) activada, Ventrata consulta la disponibilidad en tiempo real del operador en Zaui.

Funciona así:

  • Availability Check (POST /availability): cuando alguien usa el calendario de disponibilidad en Ventrata, por ejemplo en el Dashboard, en su Web Checkout o en un terminal, Ventrata consulta a Zaui en tiempo real las fechas que aparecen en pantalla.

  • Con Disponibilidad del backend activada, Ventrata hace una solicitud en tiempo real a Zaui cuando un usuario interactúa con el calendario de disponibilidad (Dashboard, Web Checkout, terminal, etc.). Las solicitudes suelen ser para un intervalo de 7 días o para un día concreto. Hasta que el usuario interactúe con él, el calendario puede mostrar datos en caché, no en tiempo real, de la solicitud anterior.

 

Lo habitual con Zaui:

  • Las solicitudes abarcan 7 días cada vez, desde hoy hasta aproximadamente un año vista, a medida que los usuarios navegan y Ventrata carga el calendario.

 

Qué significa esto para usted: los clientes reservan sobre la disponibilidad en tiempo real del operador en Zaui, por lo que no puede vender de más una franja que el operador ya ha vendido en otro canal.

Pricing Sync

✅

Con Precios del backend (Backend Pricing) activado, Ventrata toma los precios de Zaui.

Funciona así:

  • Availability Check con la capacidad octo/pricing: Ventrata solicita los precios a Zaui con cada consulta de disponibilidad.

  • Con Precios del backend activado, Ventrata obtiene de Zaui tanto los precios de venta al público como los precios netos (mayoristas) en la misma solicitud de disponibilidad en tiempo real. Los precios se muestran al usuario y se guardan en caché o se almacenan en Ventrata como tarifas generadas por API. Los precios netos se registran como precios de coste, independientemente del porcentaje de coste configurado en el operador.

  • Con Precios del backend (Backend Pricing) desactivado, el producto usa los precios que usted establece en Ventrata, y las reservas se siguen enviando a Zaui.

Zaui envía tanto los precios de venta al público como los precios netos. Con Precios del backend (Backend Pricing) marcado, Ventrata registra el precio de venta al público como su precio de venta y el precio neto como su precio de coste, independientemente del porcentaje de coste configurado en el operador.

Promotions Sync

❌

Las promociones no se envían a Zaui.

Las promociones no se envían a Zaui. Sus promociones de Ventrata siguen aplicándose al precio que paga su cliente en Ventrata.

Bookings Sync

✅

Las reservas realizadas en Ventrata para un producto conectado al backend se crean en la cuenta de Zaui del operador.

Funciona así:

  1. Bloqueo: Booking Reservation (POST /bookings): cuando el producto se añade al carrito en Ventrata, Ventrata reserva las plazas en Zaui.

  2. Confirmación: Booking Confirmation (POST /bookings/{uuid}/confirm): tras el pago, Ventrata confirma la reserva en Zaui con los datos de contacto del cliente, y la entrada o el voucher que devuelve Zaui se convierte en la entrada o el voucher de Ventrata.

  3. Modificación: Booking Update (PATCH /bookings/{uuid}): los cambios realizados en Ventrata se envían a Zaui.

  4. Cancelación: Booking Cancellation (POST /bookings/{uuid}/cancel): las cancelaciones realizadas en Ventrata se envían a Zaui.

Reserva provisional cuando se añade un producto al carrito. Confirmación tras el pago, con el envío de los datos de contacto del cliente; el voucher o la entrada de Zaui se incorpora en Ventrata (excepto PDF_FILE, que Ventrata no admite). Las modificaciones y cancelaciones realizadas en Ventrata se envían a Zaui.

 

‼️ IMPORTANTE – Las reservas se sincronizan en un solo sentido, de Ventrata a Zaui. Si el operador modifica o cancela una reserva en Zaui, Ventrata no recibe ningún aviso. Pida al operador que le informe de cualquier cambio que haga.

Pickups/Dropoff Sync

❌

Los datos de recogida y regreso no se transmiten a Zaui.

Los datos de recogida y regreso no se transmiten a Zaui. Compártalos con el operador por otra vía si un producto los necesita.

Custom Questions Sync

❌

Las respuestas a sus preguntas de reserva no se transmiten a Zaui.

Las respuestas a sus preguntas de reserva no se transmiten a Zaui. Compártalas con el operador por otra vía si las necesita.

Extras Sync

❌

Los extras y complementos no se reservan en Zaui.

Los extras y complementos no se reservan en Zaui. Solo se reservan el producto principal, la opción y las unidades.

Redemption Sync

❌

Los canjes y otros cambios de estado en Zaui no se envían de vuelta a Ventrata una vez confirmada la reserva.

Los canjes y otros cambios de estado en Zaui no se envían de vuelta a Ventrata una vez confirmada la reserva.

No se admite. El estado de la reserva en Zaui, como Canjeada, no se envía de vuelta a Ventrata tras la confirmación.

Pass Walkup Scanning Sync

❌

El escaneo de pases sin reserva previa no está disponible con Zaui.

El escaneo de pases sin reserva previa no está disponible con Zaui.

Gift Card Sync

❌

Las tarjetas regalo de Ventrata no se transmiten a Zaui.

Las tarjetas regalo de Ventrata no se transmiten a Zaui. Los pagos con tarjeta regalo se quedan en Ventrata.

✅ compatible · ❌ no compatible

 

Conviene saber: límites y detalles de la conexión con Zaui

  • Disponibilidad en tiempo real: la disponibilidad se obtiene de Zaui mientras los clientes navegan.

  • Reservas en un solo sentido: los cambios que el operador hace en Zaui no llegan a Ventrata.

 

Preguntas frecuentes

Recibo un error al guardar la configuración del backend del operador.

Lo más probable es que la OCTO API Key o el endpoint sean incorrectos. Compruébelos con su operador. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

No aparece la casilla Backend conectado (Backend Connected) en la configuración del producto.

Lo más probable es que el operador asignado al producto no tenga un backend configurado. Revise la configuración de Socio de backend (Backend Partner) del operador y vuelva a intentarlo. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

El producto, la opción o la unidad que quiero mapear no aparece en la lista desplegable.

Las listas desplegables muestran lo que el operador le ha puesto a su disposición en Zaui. Consulte al operador. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

Las reservas de un producto conectado al backend fallan.

Compruebe primero el mapeo del producto: todas las opciones y unidades deben estar mapeadas. Después, compruebe que la franja horaria sigue disponible en Zaui. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

Recibo un error al guardar la configuración del backend del operador.

Lo más probable es que la clave API de OCTO o el endpoint de OCTO sean incorrectos. Compruébelos con su operador. Si el problema persiste, póngase en contacto con el soporte.

No aparece la casilla Backend conectado (Backend Connected) en la configuración del producto.

Lo más probable es que el operador seleccionado en el producto no tenga ningún backend configurado. Compruebe la configuración del backend y vuelva a intentarlo. Si el problema persiste, póngase en contacto con el soporte.

 

Recursos útiles

 

 

Información del partner

Zaui Software Ltd.

Suite 423 - 119 Pender Street West

Vancouver, BC V6B 1S5, Canada

 

ID de partner de Ventrata: 09fc078e-fea1-4519-92d4-5eef643ca954

¿Ha quedado contestada tu pregunta?