Ir al contenido principal

Bókun: backend de operador

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

Bókun logo

 

Bókun es la plataforma de reservas y distribución de Tripadvisor para operadores de tours, atracciones, actividades, alquileres y transporte terrestre, utilizada por miles de empresas en todo el mundo. Su marketplace incluye más de 2.600 OTA y revendedores, y la propiedad común con Viator la convierte en un backend habitual para los operadores cuya demanda procede en gran parte de Tripadvisor.

 

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

 

Para obtener más información sobre Bókun, visite bokun.io.

 

📒 NOTA

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

 

📒 NOTA

Esta conexión estará disponible próximamente. Está en desarrollo, con un lanzamiento previsto entre noviembre y diciembre de 2026. Si desea utilizarla, póngase en contacto con nuestro Soporte técnico o con su Customer Success Manager de Ventrata.

 

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 Bókun)

 

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

  • Availability Sync: la disponibilidad en tiempo real procede de la cuenta de Bókun del operador.

  • Pricing Sync: los precios proceden de Bókun, o usted establece los precios en Ventrata.

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

 

Crear la conexión con Bókun

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

  • La empresa cuyos productos desea revender está creada como operador en Ventrata.

  • Los productos del operador están creados en Ventrata. La conexión sincroniza la disponibilidad, los precios y las reservas, pero no crea productos.

  • 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

Pídasela al operador que utiliza Bókun. La crea en Bókun: Settings → Connectivity → API keys → Create an API key → Save → activar OCTO en esta clave API.

 

  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 Bókun e introduzca la clave API de OCTO (OCTO API Key). Deje el endpoint con el valor predeterminado https://api.bokun.io/octo/v1, salvo que el operador o Bókun le indiquen otra cosa.

  3. Elija Bókun en la sección Socio de backend (Backend Partner) del operador.

  4. Introduzca la clave API de OCTO. Deje el Endpoint de OCTO (OCTO Endpoint) con su valor predeterminado ya rellenado, salvo que el operador le indique otra cosa.

  5. Click Update Operator.

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

 

 

En el campo Socio de backend (Backend Partner), seleccione Bókun en la lista de conexiones disponibles e introduzca la OCTO API Key que le ha proporcionado su operador.

 

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

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

📒 NOTA

Bókun 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.

 

Asigne como Operador del producto el operador con el backend de Bókun, marque Backend conectado (Backend Connected) y después Disponibilidad del backend o Precios del backend. Sin ellos, el producto usa la disponibilidad o los precios configurados en Ventrata, pero sigue enviando las reservas a Bókun.

 

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

 

Mapear productos con Bókun

‼️ IMPORTANTE

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

  4. Haga clic en 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 Bókun. 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 Bókun.

 

Gestionar la conexión con Bókun

  • Actualice el mapeo cuando el operador cambie productos, opciones o unidades en Bókun.

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

 

Funciones de la conexión en detalle

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

 

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

 

Los tiempos son los habituales en Bókun, están redondeados y pueden cambiar.

 

Product Mapping

✅

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

Funciona así:

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

Content Sync

❌

Ventrata no importa el contenido de los productos desde Bókun.

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

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

  • Con Disponibilidad del backend activada, Ventrata hace una solicitud de disponibilidad OCTO en tiempo real a Bókun cuando un usuario interactúa con el calendario (Dashboard, Web Checkout, terminal, etc.), normalmente por intervalos de 7 días o para un día concreto. Antes de que el usuario interactúe, el calendario puede mostrar datos en caché (no en tiempo real) de la solicitud anterior.

 

Lo habitual con Bókun:

  • 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 Bókun, 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 Bókun.

Funciona así:

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

  • Con Precios del backend activado, Ventrata obtiene de Bókun tanto los precios de venta al público como los precios netos (mayoristas) con la comprobación de disponibilidad. Los precios se muestran al usuario y se guardan en caché o se almacenan en Ventrata como tarifas generadas por la 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 Bókun.

Bókun 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.

Promotions Sync

❌

Las promociones no se envían a Bókun.

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

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

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

Las reservas, los cambios y las cancelaciones de los productos con Backend conectado se envían automáticamente a Bókun: la reserva provisional cuando el producto se añade al carrito, la confirmación tras el pago (con los datos de contacto del cliente), la actualización cuando cambia una reserva y la cancelación cuando se cancela. El voucher o la entrada de Bókun se incorpora en Ventrata, excepto PDF_FILE, que Ventrata no admite.

 

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

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

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

Extras Sync

❌

Los extras y complementos no se reservan en Bókun.

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

Redemption Sync

❌

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

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

No se admite. El estado de la reserva en Bókun (por ejemplo, Canjeada) no se comunica de vuelta a Ventrata tras la confirmación.

Pass Walkup Scanning Sync

❌

El escaneo de pases sin reserva previa no está disponible con Bókun.

El escaneo de pases sin reserva previa no está disponible con Bókun.

Gift Card Sync

❌

Las tarjetas regalo de Ventrata no se transmiten a Bókun.

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

✅ compatible · ❌ no compatible

 

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

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

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

  • Bókun, que forma parte de Tripadvisor, es un sistema de reservas, inventario y gestión de canales para tours, actividades y atracciones.

 

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

Error al actualizar el operador para guardar la configuración del backend.

Probablemente la clave API de OCTO o el endpoint de OCTO son incorrectos. Compruebe estos datos con su operador. Si el problema persiste, póngase en contacto con el soporte de Ventrata.

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

La lista desplegable se obtiene de Bókun según los productos, opciones y unidades que el operador le ha puesto a su disposición. Compruebe estos datos con su operador. Si el problema persiste, póngase en contacto con el soporte de Ventrata.

 

Recursos útiles

 

 

Información del partner

Tripadvisor LLC dba Bókun

400 1st Avenue

Needham, MA 02494, EE. UU.

 

ID de partner de Ventrata: 18d71b21-57e4-4811-8818-a7be06311725

¿Ha quedado contestada tu pregunta?