Ir al contenido principal

Clorian: backend de operador

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

Clorian logo

 

Clorian es una plataforma de venta de entradas con sede en Barcelona para museos, monumentos y espacios culturales, que gestiona la venta online y presencial, el aforo con entrada por franja horaria y el control de acceso de lugares como la Sagrada Família, La Pedrera y la Mezquita-Catedral de Córdoba. Declara más de 28 millones de entradas vendidas al año a través de sus recintos y una red de más de 14.000 revendedores.

 

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

 

Para obtener más información sobre Clorian, visite clorian.com.

 

📒 NOTA

Si su inventario de productos necesita ambos métodos de pago (Deferred Payment y Pre-payment), cree dos operadores distintos en Ventrata para gestionar los pagos correctamente.

‼️ IMPORTANTE

El mapeo indica a Ventrata para qué producto de Clorian debe solicitar la disponibilidad. Si los productos con Backend conectado (Backend Connected) no están mapeados correctamente, las reservas del producto fallarán. Un resaltado en rojo en toda la fila del producto significa que el producto no está mapeado correctamente.

 

Sitio web principal

Etiquetas

Booking / Ticketing System

Funciones de la conexión

Availability Sync · Pricing Sync · Bookings Sync

Desarrollado por

Ventrata (mediante Clorian B2B API)

 

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

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

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

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

 

La API externa de Clorian 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 Clorian

🔐 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 de la API Key, el nombre de usuario y la contraseña del operador. Consulte los pasos siguientes.

  • Un acuerdo comercial con el operador cuyos productos desea revender a través de Clorian.

  • Los productos de Clorian recreados en Ventrata, de forma que coincidan exactamente con la configuración de Clorian.

  • 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: Obtener sus credenciales de Clorian

Póngase en contacto con Clorian y solicite su API Key y su nombre de usuario y contraseña de Clorian.

 

  • API Key

  • Username

  • Password

 

Paso 2: Configurar el operador en Ventrata

Póngase en contacto con Clorian y solicite su API Key, además de su nombre de usuario y contraseña de Clorian.

 

  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 Clorian e introduzca la API Key, el nombre de usuario y la contraseña.

  3. En el campo Socio de backend (Backend Partner), seleccione Clorian.

  4. Introduzca la API Key, el nombre de usuario y la contraseña que ha recibido de Clorian (obligatorio).

  5. Opcional: elija el método de pago de sus productos: Deferred Payment (predeterminado en Clorian, se factura más adelante) o Pre-payment (depósito).

  6. Haga clic en Create Operator.

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

 

 

 

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

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

📒 NOTA

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

 

En el producto, marque Backend conectado (Backend Connected) y mantenga marcada Disponibilidad del backend (Backend Availability).

 

Marque Precios del backend (Backend Pricing) si desea heredar los precios de Clorian.

 

Click Update Product.

 

 

Mapear productos con Clorian

‼️ IMPORTANTE

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

  4. 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 Clorian.

 

Gestionar la conexión con Clorian

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

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

 

Funciones de la conexión en detalle

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

 

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

 

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

 

Product Mapping

✅

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

Funciona así:

  • Productos: Ventrata lee los productos, opciones y unidades de Clorian del operador para rellenar las listas desplegables de la pestaña Mapeos (Mappings).

  • Rutas observadas: GET /v2/clients, GET /v2/products/{n}.

 

Qué significa esto para usted: si falta algo en la lista desplegable, el operador no se lo ha puesto a su disposición en Clorian. Pídale que lo haga.

Content Sync

❌

Ventrata no importa el contenido de los productos desde Clorian.

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

Funciona así:

  • Disponibilidad: 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 Clorian en tiempo real las fechas que aparecen en pantalla.

  • Disponibilidad en tiempo real sincronizada desde Clorian.

  • Rutas observadas: GET /v2/products/{n}, GET /v2/products/{n}/events.

 

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

Funciona así:

  • Precios estáticos sincronizados desde Clorian, sin incluir los precios promocionales. Se heredan cuando Precios del backend (Backend Pricing) está marcado en el producto.

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

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

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

No se admite: productos con promociones, incluidas las promociones vía API.

Bookings Sync

✅

Las reservas realizadas en Ventrata para un producto conectado al backend se crean en la cuenta de Clorian del operador.

Funciona así:

  1. Bloqueo y confirmación: cuando el producto se añade al carrito, Ventrata comprueba la reserva con Clorian y, tras el pago, crea la reserva en la cuenta de Clorian del operador con los datos del cliente.

  2. Entradas: la referencia o las entradas que devuelve Clorian se guardan en la reserva de Ventrata.

  3. Llamadas observadas: Confirm Booking, Create Booking.

Las reservas y cancelaciones se envían de Ventrata a Clorian. No se admiten modificaciones de reservas de Ventrata a Clorian.

 

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

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

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

Extras Sync

❌

Los extras y complementos no se reservan en Clorian.

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

Redemption Sync

❌

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

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

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

Gift Card Sync

❌

Las tarjetas regalo de Ventrata no se transmiten a Clorian.

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

✅ compatible · ❌ no compatible

 

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

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

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

  • API personalizada: la API de Clorian no es OCTO, por lo que algunas funcionalidades pueden estar limitadas en comparación con los backends OCTO.

  • Clorian es una plataforma de venta de entradas para grandes espacios y recintos culturales, que gestiona más de 32 millones de entradas al año con una red de más de 14.000 distribuidores.

  • Método de pago por operador: Deferred Payment (predeterminado en Clorian) o Pre-payment (depósito).

 

Preguntas frecuentes

Recibo un error al guardar la configuración del backend del operador.

Lo más probable es que la API Key, el nombre de usuario y la contraseña, 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 Clorian. 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 Clorian. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

 

Recursos útiles

 

 

Información del partner

Tiqueteo Spain, S.L.

Carrer de Veneçuela, 103, 1, Sant Martí

08019 Barcelona, España

 

ID de partner de Ventrata: b4dc43c9-5155-4d6c-8861-a73a83fce30d

¿Ha quedado contestada tu pregunta?