Outbox es una plataforma de venta de entradas en la nube con sede en Montreal para eventos en directo y recintos, que se vende en marca blanca con entradas digitales y monedero, entrada general y localidades numeradas, mapas de asientos en 3D, control de inventario y distribución y una API completa, en varios idiomas y monedas. La empresa declara más de 500 millones de entradas vendidas para clientes como el Bell Centre, el Cirque du Soleil, Osheaga, The O2 y recintos de Canadá, Estados Unidos, el Reino Unido y México.
Conectar Outbox con Ventrata le permite revender productos de operadores que utilizan Outbox como sistema de reservas. Ventrata lee su disponibilidad y sus precios en tiempo real desde Outbox, y cada reserva que recibe se crea directamente en la cuenta de Outbox del operador.
Para obtener más información sobre Outbox, visite outbox.com.
‼️ IMPORTANTE
La API externa de Outbox utilizada para esta conexión es una API XML-RPC personalizada que no sigue el estándar de la API OCTO, lo que puede limitar ciertas funciones y capacidades.
‼️ IMPORTANTE
Como Outbox vende plazas con hora de entrada, utilice siempre Disponibilidad del backend (Backend Availability). Sin ella, pueden hacerse reservas para franjas horarias que no existen o que están agotadas en Outbox, y esas reservas fallarán.
📗 CONSEJO
Haga una reserva de prueba después del mapeo y pida al operador que confirme que ha llegado a Outbox con la franja horaria y los tipos de entrada correctos.
Sitio web principal | |
Etiquetas | Booking / Ticketing System |
Funciones de la conexión | Availability Sync · Pricing Sync · Bookings Sync |
Desarrollado por | Ventrata (mediante Outbox Partner Sell API) |
Esta conexión de operador (también llamada backend) le permite revender productos de operadores que utilizan Outbox como su sistema de reservas principal, y cada reserva se crea directamente en Outbox. Entre las funcionalidades de esta conexión se incluyen:
Availability Sync: la disponibilidad en tiempo real procede de la cuenta de Outbox del operador.
Pricing Sync: los precios proceden de Outbox, o usted establece los precios en Ventrata.
Bookings Sync: las reservas se envían de Ventrata a Outbox, y Outbox emite las entradas o los vouchers.
La API externa de Outbox 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 Outbox
🔐 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 clave API y la URL de la API del operador. Consulte los pasos que se indican a continuación.
Asegúrese de recibir las credenciales de producción: el entorno de pruebas (staging) y el de producción utilizan URL y claves distintas, y el inventario de producción se configura por separado del de pruebas.
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 solicita un nuevo canal de API para usted a su gestor de cuenta en Outbox, que también configura las ventas (onsales) y el inventario que puede vender. Outbox emite las credenciales.
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 Outbox e introduzca la clave API y la URL de la API.
Introduzca la clave API: le identifica como canal de venta (revendedor) en el sistema Outbox del operador y controla qué ventas (onsales, es decir, productos) y qué moneda tiene disponibles. Cada revendedor necesita su propia clave; las claves no se pueden compartir entre empresas.
Introduzca la URL de la API: la dirección de la API de Outbox del operador, normalmente en el dominio de venta de entradas del operador y terminada en /extapi/ (por ejemplo, https://tickets.onetimessquare.com/extapi/). Debe empezar por https://.
Haga clic en Actualizar Operador (Update Operator).
Paso 2: 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 Outbox y Precios del backend (Backend Pricing) para usar los precios de Outbox.
Haga clic en Actualizar Producto (Update Product).
📒 NOTA
Outbox 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) y, a continuación, Disponibilidad del backend (Backend Availability) para obtener las franjas horarias y la disponibilidad, y Precios del backend (Backend Pricing) para obtener los precios.
Mapear productos con Outbox
‼️ IMPORTANTE
El mapeo indica a Ventrata para qué producto, opción y unidades de Outbox 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 Outbox en las listas desplegables, que Ventrata carga desde Outbox. 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 Outbox.
Gestionar la conexión con Outbox
Actualice el mapeo cuando el operador cambie productos, opciones o unidades en Outbox.
Sustituya la clave en el operador si Outbox 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 Outbox.
Funciones de la conexión en detalle
Esta sección es para quien quiera saber exactamente cómo funciona la conexión con Outbox. Aquí el sentido es el contrario al de una conexión de revendedor: Ventrata llama a Outbox mediante la Partner Sell API de Outbox. Para cada funcionalidad, se explica qué llamadas realiza Ventrata, cuándo y qué significa para usted.
En resumen: Ventrata solicita a Outbox la disponibilidad y los precios cada vez que alguien consulta un producto conectado al backend, y crea cada reserva en la cuenta de Outbox del operador. Outbox no envía cambios de vuelta a Ventrata.
Los tiempos son los habituales en Outbox, están redondeados y pueden cambiar.
Product Mapping | ✅ |
Usted mapea cada producto, opción y unidad de Ventrata con el producto de Outbox 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 Outbox. Pídale que lo haga. |
Content Sync | ❌ |
Ventrata no importa el contenido de los productos desde Outbox. Ventrata no importa el contenido de los productos desde Outbox. 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 Outbox. Funciona así:
Qué significa esto para usted: los clientes reservan sobre la disponibilidad en tiempo real del operador en Outbox, 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 Outbox. Funciona así:
Outbox 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 Outbox. Las promociones no se envían a Outbox. 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 Outbox del operador. Funciona así:
Retención: las plazas se bloquean en Outbox durante el periodo de retención que devuelve Outbox cuando se añade un producto al carrito; cada pedido de Outbox abarca una sola franja horaria. Confirmación: tras el pago, con los datos de contacto del cliente; el nombre, los apellidos, el correo electrónico y el país son obligatorios, el teléfono y el código postal se envían cuando están disponibles, y el idioma del cliente se establece en francés o inglés según su configuración regional. El número de pedido de Outbox se registra como referencia del proveedor (Supplier Reference). Entradas: se emite un código de barras por plaza como código QR en cada entrada de Ventrata, además de un PDF con todas las entradas del pedido; los valores QR coinciden con el PDF de Outbox. Actualización: Outbox no puede modificar un pedido existente mediante la API, por lo que actualizar una reserva confirmada solo vuelve a emitir sus entradas; para cambiar la fecha, la franja horaria o el número de entradas, cancele y vuelva a reservar. Cancelación: cancelar una reserva confirmada cancela el pedido de Outbox; cancelar una reserva sin confirmar (en retención) libera las plazas bloqueadas.
‼️ IMPORTANTE – Las reservas se sincronizan en un solo sentido, de Ventrata a Outbox. Si el operador modifica o cancela una reserva en Outbox, 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 Outbox. Los datos de recogida y regreso no se transmiten a Outbox. 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 Outbox. Las respuestas a sus preguntas de reserva no se transmiten a Outbox. Compártalas con el operador por otra vía si las necesita. |
Extras Sync | ❌ |
Los extras y complementos no se reservan en Outbox. Los extras y complementos no se reservan en Outbox. Solo se reservan el producto principal, la opción y las unidades. |
Redemption Sync | ❌ |
Los canjes y otros cambios de estado en Outbox no se envían de vuelta a Ventrata una vez confirmada la reserva. Los canjes y otros cambios de estado en Outbox no se envían de vuelta a Ventrata una vez confirmada la reserva. No se admite. El estado de la reserva en Outbox (por ejemplo, una entrada escaneada) no se comunica a Ventrata. |
Pass Walkup Scanning Sync | ❌ |
El escaneo de pases sin reserva previa no está disponible con Outbox. El escaneo de pases sin reserva previa no está disponible con Outbox. |
Gift Card Sync | ❌ |
Las tarjetas regalo de Ventrata no se transmiten a Outbox. Las tarjetas regalo de Ventrata no se transmiten a Outbox. Los pagos con tarjeta regalo se quedan en Ventrata. |
✅ compatible · ❌ no compatible
Conviene saber: límites y detalles de la conexión con Outbox
Conviene saber: límites y detalles de la conexión con Outbox
Disponibilidad en tiempo real: la disponibilidad se obtiene de Outbox mientras los clientes navegan.
Reservas en un solo sentido: los cambios que el operador hace en Outbox no llegan a Ventrata.
API personalizada: la API de Outbox no es OCTO, por lo que algunas funcionalidades pueden estar limitadas en comparación con los backends OCTO.
Entradas: los códigos QR y las entradas en PDF de Outbox se emiten para sus clientes.
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 la clave API y la URL de la API 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 Outbox. 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 Outbox. 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.
Error al actualizar el operador para guardar la configuración del backend.
Es probable que la clave API o la URL de la API sean incorrectas, o que se hayan utilizado credenciales de prueba con una URL de producción (o al revés). Compruébelo con su operador. Si el problema persiste, póngase en contacto con el Soporte técnico.
El producto, la opción o la unidad que quiero mapear no aparece en la lista desplegable, o la lista está vacía.
El producto, la opción o la unidad que quiero mapear no aparece en la lista desplegable, o la lista está vacía.
La lista desplegable se obtiene de Outbox según las ventas (onsales) asignadas a su clave API. Pida a su operador que confirme con Outbox que el inventario está configurado para su canal de API en el entorno que está utilizando (pruebas y producción se configuran por separado). Si el problema persiste, póngase en contacto con el Soporte técnico.
Los productos, opciones o unidades aparecen como «Undefined» en las listas desplegables de mapeo.
Los productos, opciones o unidades aparecen como «Undefined» en las listas desplegables de mapeo.
Los nombres proceden de la configuración de ventas (onsales) del operador en Outbox. Pida a su operador que añada títulos y descripciones de los tipos de precio en Outbox.
La confirmación de la reserva falla con «Country code is required».
La confirmación de la reserva falla con «Country code is required».
Outbox exige un país en cada pedido. Asegúrese de que el checkout, el formulario de reserva o la conexión de revendedor que vende este producto recoja el país del cliente y, después, vuelva a intentarlo.
Los precios no coinciden con los que espera el operador.
Los precios no coinciden con los que espera el operador.
Outbox devuelve precios con impuestos incluidos que incluyen los cargos por servicio de su canal. Revise con su operador las tablas de precios y los cargos por servicio de su canal de API.
No se muestran franjas horarias para una fecha.
No se muestran franjas horarias para una fecha.
El operador no tiene ningún evento ni ha liberado plazas para esa fecha en Outbox. Consúltelo con su operador.
Recursos útiles
📚 Más sobre las conexiones de Ventrata
Información del partner
Outbox Technology Inc.
3575 Boulevard Saint-Laurent, Suite 705
Montreal, QC H2X 2T7, Canadá
ID de partner de Ventrata: 01a06240-f33b-7362-b04f-35ed782cee0e