Onebox es un sistema de distribución de entradas para eventos en directo y ocio con sede en Barcelona, utilizado por promotores, recintos, festivales, teatros, museos, estadios y parques temáticos para gestionar ventas, precios dinámicos, mapas de asientos, aforo y control de acceso. Entre sus clientes figuran el Atlético de Madrid y el Teatro Apolo; la empresa declara más de 65 millones de entradas vendidas, y su red de distribución llega a operadores de venta de entradas, agencias de viajes, hoteles y centros comerciales de toda España.
Conectar Onebox con Ventrata le permite revender productos de operadores que utilizan Onebox como sistema de reservas. Ventrata lee su disponibilidad y sus precios en tiempo real desde Onebox, y cada reserva que recibe se crea directamente en la cuenta de Onebox del operador.
Para obtener más información sobre Onebox, visite oneboxtds.com.
📒 NOTA
Esta conexión estará disponible próximamente. Está en desarrollo. Si desea utilizarla, póngase en contacto con nuestro Soporte técnico o con su Customer Success Manager de Ventrata.
‼️ IMPORTANTE
El mapeo indica a Ventrata a qué producto de Onebox debe solicitar la disponibilidad. Si un producto conectado al backend no está mapeado correctamente, sus reservas fallarán. Un resaltado en rojo en toda la fila del producto significa que el producto no está mapeado correctamente.
📒 NOTA
Vuelva a crear en Ventrata los productos de Onebox, de forma que coincidan exactamente con la configuración de Onebox.
📗 CONSEJO
Al crear el operador, solo son obligatorios los campos marcados con un asterisco (*).
Sitio web principal | |
Etiquetas | Booking / Ticketing System |
Funciones de la conexión | Availability Sync · Pricing Sync · Bookings Sync |
Desarrollado por | Ventrata (mediante la Distribution API de Onebox) |
Esta conexión de operador (también llamada backend) le permite revender productos de operadores que utilizan Onebox como su sistema de reservas principal, y cada reserva se crea directamente en Onebox. Entre las funcionalidades de esta conexión se incluyen:
Availability Sync: la disponibilidad en tiempo real procede de la cuenta de Onebox del operador.
Pricing Sync: los precios proceden de Onebox, o usted establece los precios en Ventrata.
Bookings Sync: las reservas se envían de Ventrata a Onebox, y Onebox emite las entradas o los vouchers.
La API externa de Onebox que se utiliza para esta conexión es una API personalizada que no sigue el estándar de la API OCTO, lo que puede limitar determinadas funcionalidades y capacidades.
Crear la conexión con Onebox
🔐 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 disponer del Channel ID y el Client Secret del operador. Consulte los pasos siguientes.
Vuelva a crear en Ventrata los productos de Onebox, de forma que coincidan exactamente con la configuración de Onebox.
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: Firmar un acuerdo comercial y solicitar las credenciales
Firme un acuerdo comercial con el operador cuyos productos quiere revender a través de Onebox.
Póngase en contacto con Onebox y solicite las credenciales que se indican a continuación.
Channel ID
Client Secret
Paso 2: Configurar el operador en Ventrata
Póngase en contacto con Onebox y solicite el Channel ID y el Client Secret.
En el Ventrata Dashboard, vaya a Productos → Operadores (Products → Operators) y abra el operador. Si todavía no existe, primero créelo como operador.
En la sección Socio de backend (Backend Partner), seleccione Onebox e introduzca el Channel ID y el Client Secret.
Haga clic en Actualizar Operador (Update Operator).
Paso 3: conecte cada producto
Abra el producto del operador en Productos → Productos (Products → Products) y edítelo. Compruebe que el Operador sea este operador.
Marque Backend conectado (Backend Connected). Marque Disponibilidad del backend (Backend Availability) para usar la disponibilidad de Onebox y Precios del backend (Backend Pricing) para usar los precios de Onebox.
Haga clic en Actualizar Producto (Update Product).
📒 NOTA
Onebox solo envía precios netos. Con Precios del backend (Backend Pricing) marcado, Ventrata registra el precio neto como su precio de coste y calcula el precio de venta al público con el porcentaje de coste configurado en el operador en el Ventrata Dashboard.
Marque Backend conectado (Backend Connected) y mantenga marcada Disponibilidad del backend (Backend Availability).
Marque Precios del backend (Backend Pricing) si desea heredar los precios del partner de backend.
Mapear productos con Onebox
‼️ IMPORTANTE
El mapeo indica a Ventrata para qué producto, opción y unidades de Onebox 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.
En el Ventrata Dashboard, vaya a Productos → Productos (Products → Products) y abra el producto.
Abra la pestaña Mapeos (Mappings). Aparece una vez que el producto tiene marcado Backend conectado (Backend Connected).
Para cada opción y unidad de Ventrata, seleccione el producto, la opción y las unidades correspondientes de Onebox en las listas desplegables, que Ventrata carga desde Onebox. No deje ningún campo vacío.
Haga clic en 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 Onebox.
Gestionar la conexión con Onebox
Actualice el mapeo cuando el operador cambie productos, opciones o unidades en Onebox.
Sustituya la clave en el operador si Onebox 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 Onebox.
Funciones de la conexión en detalle
Esta sección es para quien quiera saber exactamente cómo funciona la conexión con Onebox. Aquí el sentido es el contrario al de una conexión de revendedor: Ventrata llama a Onebox mediante la Distribution API de Onebox. Para cada funcionalidad, se explica qué llamadas realiza Ventrata, cuándo las realiza y qué significa eso para usted.
En resumen: Ventrata solicita a Onebox la disponibilidad y los precios cada vez que alguien consulta un producto conectado al backend, y crea cada reserva en la cuenta de Onebox del operador. Onebox no envía cambios de vuelta a Ventrata.
Los tiempos son los habituales en Onebox, están redondeados y pueden cambiar.
Product Mapping | ✅ |
Usted mapea cada producto, opción y unidad de Ventrata con el producto de Onebox del operador en el Ventrata Dashboard. Funciona así:
Qué significa esto para usted: si falta algo en la lista desplegable, el operador no se lo ha puesto a su disposición en Onebox. Pídale que lo haga. |
Content Sync | ❌ |
Ventrata no importa el contenido de los productos desde Onebox. Ventrata no importa el contenido de los productos desde Onebox. 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 Onebox. Funciona así:
Lo habitual con Onebox:
Qué significa esto para usted: los clientes reservan sobre la disponibilidad en tiempo real del operador en Onebox, 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 Onebox. Funciona así:
Onebox solo envía precios netos. Con Precios del backend (Backend Pricing) marcado, Ventrata registra el precio neto como su precio de coste y calcula el precio de venta al público con el porcentaje de coste configurado en el operador en el Ventrata Dashboard. |
Promotions Sync | ❌ |
Las promociones no se envían a Onebox. Las promociones no se envían a Onebox. 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 Onebox del operador. Funciona así:
Envía reservas de Ventrata a Onebox. No se admiten modificaciones ni cancelaciones de reservas de Ventrata a Onebox.
‼️ IMPORTANTE – Las reservas se sincronizan en un solo sentido, de Ventrata a Onebox. Si el operador modifica o cancela una reserva en Onebox, 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 Onebox. Los datos de recogida y regreso no se transmiten a Onebox. 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 Onebox. Las respuestas a sus preguntas de reserva no se transmiten a Onebox. Compártalas con el operador por otra vía si las necesita. |
Extras Sync | ❌ |
Los extras y complementos no se reservan en Onebox. Los extras y complementos no se reservan en Onebox. Solo se reservan el producto principal, la opción y las unidades. |
Redemption Sync | ❌ |
Los canjes y otros cambios de estado en Onebox no se envían de vuelta a Ventrata una vez confirmada la reserva. Los canjes y otros cambios de estado en Onebox 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 Onebox. El escaneo de pases sin reserva previa no está disponible con Onebox. |
Gift Card Sync | ❌ |
Las tarjetas regalo de Ventrata no se transmiten a Onebox. Las tarjetas regalo de Ventrata no se transmiten a Onebox. Los pagos con tarjeta regalo se quedan en Ventrata. |
✅ compatible · ❌ no compatible
Conviene saber: límites y detalles de la conexión con Onebox
Conviene saber: límites y detalles de la conexión con Onebox
Disponibilidad en tiempo real: la disponibilidad se obtiene de Onebox mientras los clientes navegan.
Reservas en un solo sentido: los cambios que el operador hace en Onebox no llegan a Ventrata.
API personalizada: la API de Onebox no es OCTO, por lo que algunas funcionalidades pueden estar limitadas en comparación con los backends OCTO.
Onebox es un sistema centralizado de distribución de entradas (TDS) que da acceso al inventario, los precios y los mapas de asientos numerados de eventos en directo de varios recintos a través de una única pasarela API.
Preguntas frecuentes
Recibo un error al guardar la configuración del backend del operador.
Recibo un error al guardar la configuración del backend del operador.
Lo más probable es que el Channel ID y el Client Secret, 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.
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.
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 Onebox. 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.
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 Onebox. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.
Recursos útiles
📚 Más sobre las conexiones de Ventrata
Información del partner
ONEBOX IBERICA, S.L.
Via Augusta 21 - 23
08006 Barcelona, España
ID de partner de Ventrata: 4b72f238-0436-4b6a-ae39-5849d1f7740c