Ir al contenido principal

TripWorks: backend de operador

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

TripWorks logo

 

TripWorks es una plataforma de reservas para operadores de tours, actividades y atracciones, utilizada sobre todo en Estados Unidos en tours aéreos y marítimos, visitas turísticas y tours urbanos, actividades de aventura y al aire libre, atracciones y locales de ocio. Abarca el descubrimiento, las reservas, los pagos, la programación, el check-in y la analítica, con agentes de chat y de llamadas con IA que aceptan reservas a todas horas y más de 50 integraciones de distribución.

 

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

 

Para obtener más información sobre TripWorks, visite tripworks.com.

 

📒 NOTA

Cada clave API le conecta con un único operador. Si revende más de un operador que utiliza TripWorks, cree un operador distinto en Ventrata para cada uno, con su propia clave API.

‼️ IMPORTANTE

El mapeo indica a Ventrata para qué producto, opción y unidades de TripWorks debe consultar la disponibilidad y realizar la reserva. Si los productos conectados al backend no están bien mapeados, las reservas fallarán. Un resaltado en rojo en toda la fila del producto indica que el producto está mal mapeado.

📗 CONSEJO

Haga una reserva de prueba después del mapeo y pida a su operador que confirme que aparece en TripWorks.

 

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

 

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

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

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

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

 

Crear la conexión con TripWorks

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

  • Cada clave API le conecta con un único operador.

  • 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

Su operador la solicita a TripWorks por usted. TripWorks emite una clave distinta para cada relación entre revendedor y operador. Pídales que pongan en copia a [email protected] para que Ventrata pueda ayudar si es necesario.

 

  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 TripWorks e introduzca la clave de API OCTO (OCTO API Key). Mantenga el endpoint predeterminado, salvo que TripWorks o su operador le indiquen lo contrario.

  3. Introduzca el nombre del operador (por ejemplo, HeliNY) al crear el operador.

  4. Haga clic en Actualizar Operador (Update Operator).

 

 

📒 NOTA – Cada OCTO API Key le conecta con un operador. Configure cada operador de TripWorks 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 TripWorks y Precios del backend (Backend Pricing) para usar los precios de TripWorks.

  3. Haga clic en Actualizar Producto (Update Product).

📒 NOTA

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

 

En la sección Operador y backend (Operator & Backend) del producto, asigne el operador TripWorks, marque Backend conectado (Backend Connected) y mantenga marcada Disponibilidad del backend (Backend Availability) para obtener la disponibilidad en tiempo real.

 

Si lo desea, marque Precios del backend (Backend Pricing) para obtener los precios de TripWorks. Si lo deja sin marcar, el producto usa los precios configurados en Ventrata, pero sigue enviando las reservas a TripWorks.

 

Repita el proceso para cada producto que revenda.

 

Mapear productos con TripWorks

‼️ IMPORTANTE

El mapeo indica a Ventrata para qué producto, opción y unidades de TripWorks 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 TripWorks en las listas desplegables, que Ventrata carga desde TripWorks. No deje ningún campo vacío.

  4. Haga clic en Save Changes.

📒 NOTA

Los productos aparecen con su nombre de experiencia de TripWorks. Mapee cada unidad de Ventrata (por ejemplo, Adult, Child) con la unidad correspondiente de TripWorks.

 

📗 CONSEJO

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

 

Gestionar la conexión con TripWorks

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

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

 

Funciones de la conexión en detalle

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

 

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

 

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

 

Product Mapping

✅

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

Funciona así:

  • Get Products (GET /products): Ventrata lee los productos, opciones y unidades de TripWorks 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 TripWorks. Pídale que lo haga.

Content Sync

❌

Ventrata no importa el contenido de los productos desde TripWorks.

Ventrata no importa el contenido de los productos desde TripWorks. 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 TripWorks.

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 TripWorks en tiempo real las fechas que aparecen en pantalla.

  • Con Disponibilidad del backend (Backend Availability), Ventrata solicita a TripWorks la disponibilidad en tiempo real cuando un usuario consulta fechas en el Dashboard, en el checkout o en otros canales de venta.

 

Qué significa esto para usted: los clientes reservan sobre la disponibilidad en tiempo real del operador en TripWorks, 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 TripWorks.

Funciona así:

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

  • Con Precios del backend (Backend Pricing), Ventrata obtiene los precios de TripWorks junto con la disponibilidad. Los precios incluyen los impuestos y tasas del operador, por lo que el precio mostrado al consultar la disponibilidad coincide con el precio en la confirmación. No se indica si son precios de venta al público o netos.

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

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

Las promociones no se envían a TripWorks. 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 TripWorks 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 TripWorks.

  2. Confirmación: Booking Confirmation (POST /bookings/{uuid}/confirm): tras el pago, Ventrata confirma la reserva en TripWorks con los datos de contacto del cliente, y la entrada o el voucher que devuelve TripWorks 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 TripWorks.

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

La disponibilidad se bloquea en TripWorks cuando se añade un producto al carrito y se confirma tras el pago, junto con los datos de contacto del cliente. Las modificaciones de reservas (fecha, hora, cantidades) y las cancelaciones realizadas en Ventrata se envían a TripWorks automáticamente.

 

‼️ IMPORTANTE – Las reservas se sincronizan en un solo sentido, de Ventrata a TripWorks. Si el operador modifica o cancela una reserva en TripWorks, 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 TripWorks.

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

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

Extras Sync

❌

Los extras y complementos no se reservan en TripWorks.

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

Redemption Sync

❌

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

Los canjes y otros cambios de estado en TripWorks 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 TripWorks.

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

Gift Card Sync

❌

Las tarjetas regalo de Ventrata no se transmiten a TripWorks.

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

✅ compatible · ❌ no compatible

 

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

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

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

  • Vouchers/entradas: TripWorks devuelve un código QR para la reserva y para cada entrada, y Ventrata los emite a su cliente. El código QR enlaza con el portal de clientes de TripWorks del operador y es lo que el operador escanea a la llegada.

 

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 TripWorks. 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 TripWorks. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

Error al guardar la configuración de backend del operador.

Probablemente la clave API de OCTO es incorrecta o todavía no está activa. Compruébela con su operador. Si el problema persiste, póngase en contacto con [email protected].

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

La lista desplegable solo muestra los productos, opciones y unidades que el operador ha puesto a su disposición en TripWorks. Pida a su operador que compruebe la asignación por su parte.

 

Recursos útiles

 

 

Información del partner

TripWorks, Inc.

1 High Street Ct.

Morristown, NJ 07960, United States

 

ID de partner de Ventrata: 01a159ec-f15a-73fd-96c5-917ef887269b

¿Ha quedado contestada tu pregunta?