Ir al contenido principal

Xola: backend de operador

Conecte Xola con Ventrata para revender productos de operadores de Xola con disponibilidad y precios en tiempo real y reservas al instante. Destaca en experiencias de aventura.

Xola logo

 

Xola es una plataforma de reservas y comercio electrónico para operadores de tours, actividades y atracciones, que abarca checkout online, punto de venta, quioscos, exenciones de responsabilidad digitales, planificación de personal y equipos, listas de espera y reseñas, con Xolabot encargándose de la recuperación de carritos y el seguimiento de marketing. Su base de operadores se concentra en categorías de aventura y experiencias, como tours en helicóptero, tirolinas, escape rooms, deportes acuáticos, excursiones en barco y salidas de pesca.

 

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

 

Para obtener más información sobre Xola, visite xola.com.

 

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 Xola)

 

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

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

  • Pricing Sync: los precios de venta al público y netos proceden de Xola, o usted establece los precios en Ventrata.

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

 

Crear la conexión con Xola

🔐 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 figurar como canal de distribución (Distribution Channel) en la App Store de Xola. Consulte el paso 1.

  • 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: Figurar en la App Store de Xola

Envíe un correo electrónico a [email protected] y [email protected] con los nombres de los operadores de Xola con los que desea conectarse, además de su logotipo, su nombre comercial y una persona de contacto para la ficha de su app. Cuente con varios días para que Xola revise y apruebe su solicitud.

 

Paso 2: Obtener la clave API de OCTO del operador

Una vez que figure en la App Store, pida al operador que instale su app en Xola, seleccione las experiencias que desea compartir con usted y le comparta de forma segura la clave API de OCTO (OCTO API Key).

 

Paso 3: Configurar el operador en 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 Xola e introduzca la clave API de OCTO (OCTO API Key). Deje el Endpoint de OCTO (OCTO Endpoint) con el valor predeterminado https://octo.xola.com/latest, salvo que el operador o Xola le indiquen otra cosa.

  3. Press Update Operator.

 

 

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

 

📒 NOTA – Cada clave API le conecta con un único operador. Configure cada operador de Xola por separado.

 

Paso 4: 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 Xola y Precios del backend (Backend Pricing) para usar los precios de Xola.

  3. Press Update Product.

📒 NOTA

Xola solo envía precios de venta al público. Con Precios del backend (Backend Pricing) marcado, Ventrata registra el precio de venta al público y calcula su precio neto (de coste) con el porcentaje de coste configurado en el operador en el Ventrata Dashboard.

 

Marque Backend conectado (Backend Connected) en este producto para usar la conexión API (backend). Para obtener la disponibilidad de Xola, 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 Xola. Haga clic en Actualizar Producto (Update Product) para guardar.

 

Mapear productos con Xola

‼️ IMPORTANTE

El mapeo indica a Ventrata para qué producto, opción y unidades de Xola 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 en las listas desplegables la experiencia, la opción y las unidades correspondientes de Xola, que Ventrata carga desde Xola. 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 Xola. 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 Xola.

 

Gestionar la conexión con Xola

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

  • Sustituya la clave en el operador si Xola 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 Xola.

 

Funciones de la conexión en detalle

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

 

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

 

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

 

Product Mapping

✅

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

Funciona así:

  • Get Products (GET /products): Ventrata lee las experiencias que el operador ha compartido con usted en Xola, con sus opciones y unidades, para rellenar las listas desplegables de la pestaña Mapeos (Mappings).

  • Capabilities (GET /capabilities): Ventrata comprueba qué capabilities (funcionalidades) de OCTO admite la cuenta de Xola del operador.

 

Lo habitual con Xola:

  • Ventrata vuelve a leer los productos y las capabilities del operador en Xola cada pocas horas, por lo que las nuevas experiencias que el operador comparte con usted aparecen en las listas desplegables sin que tenga que hacer nada.

 

Qué significa esto para usted: si falta una experiencia, una opción o una unidad en la lista desplegable, el operador todavía no la ha compartido con usted en Xola. Pídale que la añada a su app.

Availability Sync

✅

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

Funciona así:

  • Availability Check (POST /availability): cuando alguien utiliza el calendario de disponibilidad en Ventrata, por ejemplo en el Dashboard, en su Web Checkout o en un terminal, Ventrata consulta en tiempo real a Xola las fechas que aparecen en pantalla. Xola responde con cada franja horaria, su estado y la capacidad restante.

  • Antes de que alguien interactúe con el calendario, este puede mostrar el resultado de la última vez que se consultaron esas fechas (en caché).

 

Lo habitual con Xola:

  • Las solicitudes suelen abarcar un solo día o unos pocos días cada vez, empezando hoy y llegando hasta unos 6 meses vista, a medida que los usuarios navegan.

 

Qué significa esto para usted: los clientes siempre reservan sobre la disponibilidad en tiempo real del operador en Xola, por lo que no puede sobrevender una franja que el operador ya ha vendido por otro canal.

Ventrata consulta a Xola la disponibilidad en intervalos de 7 días o para un solo día.

Pricing Sync

✅

Con Precios del backend activado, Ventrata toma de Xola tanto los precios de venta al público como los precios netos.

Funciona así:

  • Availability Check con la capability octo/pricing: Ventrata consulta a Xola los precios con cada solicitud de disponibilidad. Los precios se muestran al usuario y se guardan en Ventrata como tarifas generadas por la API.

  • Los precios netos (mayoristas) de Xola se registran como precio de coste, independientemente del porcentaje de coste que haya 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 Xola.

Xola solo envía precios de venta al público. Con Precios del backend (Backend Pricing) marcado, Ventrata registra el precio de venta al público y calcula su precio neto (de coste) con el porcentaje de coste configurado en el operador en el Ventrata Dashboard.

Bookings Sync

✅

Las reservas, modificaciones y cancelaciones realizadas en Ventrata para un producto conectado al backend se envían a Xola automáticamente.

Funciona así:

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

  2. Confirmar: Booking Confirmation (POST /bookings/{uuid}/confirm): tras el pago, Ventrata confirma la reserva en Xola con los datos de contacto del cliente. La entrada o el voucher que devuelve Xola se convierte en la entrada o el voucher de Ventrata, excepto PDF_FILE, que Ventrata no admite.

  3. Modificar: Booking Update (PATCH /bookings/{uuid}): cuando se modifica una reserva en Ventrata, el cambio se envía a Xola.

  4. Cancelar: Booking Cancellation (POST /bookings/{uuid}/cancel): cuando se cancela una reserva en Ventrata, también se cancela en Xola.

 

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

Content Sync

❌

Ventrata no importa el contenido de los productos desde Xola.

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

Promotions Sync

❌

Las promociones no se envían a Xola.

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

Pickups/Dropoff Sync

❌

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

Los datos de recogida y regreso no se transmiten a Xola. 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 Xola.

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

Extras Sync

❌

Los extras y complementos no se reservan en Xola.

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

Redemption Sync

❌

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

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

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

Las tarjetas regalo de Ventrata no se transmiten a Xola.

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

✅ compatible · ❌ no compatible

 

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

  • Un operador por clave: cada operador de Xola le facilita su propia clave API de OCTO.

  • Solo experiencias compartidas: solo puede mapear y vender las experiencias que el operador ha compartido con su app en Xola.

  • Disponibilidad en tiempo real: la disponibilidad procede de Xola a medida que los usuarios navegan, por lo que no hay que mantener ninguna disponibilidad sincronizada a mano.

  • Reservas en un solo sentido: los cambios que el operador hace en Xola 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 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 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 ha compartido con usted en Xola. Pida al operador que lo comparta. 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 Xola. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

 

Recursos útiles

 

 

Información del partner

Xola, Inc.

Hewes Building, 995 Market St

San Francisco, CA 94103, EE. UU.

 

ID de partner de Ventrata: 360a0ae4-5437-4c21-9dfa-68c0e8e22c8a

¿Ha quedado contestada tu pregunta?