Ir al contenido principal

Turbopass: conexión de revendedor

Conecte Turbopass con Ventrata para sincronizar la disponibilidad y recibir reservas al instante. Pases urbanos digitales para varias atracciones.

Turbopass logo con tecnología de Open Pass icon Open Pass

 

Turbopass es un city pass digital multiatracción que reúne en una sola entrada con código QR el acceso a museos y monumentos, experiencias locales y, en algunas ciudades, el transporte público, y se vende para 14 destinos: Roma, París, Londres, Barcelona, Madrid, Venecia, Florencia, Nápoles, Atenas, Múnich, Hamburgo, York, Stratford-upon-Avon y Dubái. Para los operadores, aporta viajeros de escapadas urbanas con prepago (más de 700.000 atendidos) que planifican itinerarios con varias atracciones antes de llegar, atraídos por un ahorro de hasta el 45 % frente a las entradas individuales. Turbopass utiliza Open Pass como su sistema de venta de entradas principal.

 

Al conectar Turbopass con Ventrata, se sincronizan su disponibilidad y sus precios, y recibe las reservas, los cambios y las cancelaciones con las entradas emitidas automáticamente. Turbopass funciona con Open Pass y recibe sus productos a través de su integración certificada con la API OCTO de Ventrata.

 

Para obtener más información sobre cómo asociarse con Turbopass, visite turbopass.com.

 

Sitio web principal

Etiquetas

OTA · Tours & Activities OTA · Multi-Attraction Pass

Mercados de destino

🌎 Global

Mercados emisores

🌎 Global

Especialidades

Pases urbanos digitales con varias atracciones

Funciones de la conexión

Availability Sync · Bookings Sync

GMV reservado a través de Ventrata (últimos 12 meses)

US$100k+

Proveedores con reservas a través de Ventrata (últimos 12 meses)

5+

Desarrollado por

Open Pass (mediante la API OCTO de Ventrata)

 

Esta conexión de revendedor le permite vender sus productos a través de Turbopass sin gestionar manualmente la disponibilidad ni las reservas. Las funciones de esta conexión incluyen:

  • Availability Sync: Turbopass consulta su disponibilidad en tiempo real en Ventrata.

  • Bookings Sync: las reservas, modificaciones y cancelaciones de Turbopass se crean al instante en Ventrata, y los clientes reciben entradas de Ventrata.

 

Crear la conexión con Turbopass

🔐 Permisos de rol necesarios: See Connections, Modify Connections, See Connection Key

Antes de empezar:

  • Debe tener un acuerdo comercial con Turbopass para que el partner pueda vender sus productos. Para informarse sobre cómo asociarse con ellos, póngase en contacto a través de turbopass.com.

  • Debe tener Turbopass creado como revendedor en Ventrata, con sus precios (de venta al público y mayoristas o de comisión) correctamente definidos. Tenga en cuenta que esta conexión API requiere que el revendedor tenga configurado el método de liquidación «Facturar a mi cuenta (Bill to my account)».

 

  1. En el Ventrata Dashboard, vaya a Conexiones → Conexiones (Connections → Connections), haga clic en + Nueva conexión (+ New Connection) y seleccione Turbopass (con tecnología de Open Pass) en la lista de partners.

  2. Seleccione el revendedor Turbopass en la lista de sus revendedores (debe crearse antes de crear la conexión). La conexión heredará la configuración del revendedor, como los precios, los destinos permitidos, los productos, etc.

  3. (Opcional) También puede asignar a la conexión el Nombre (Name) que prefiera, lo cual puede resultar útil si tiene previsto tener varias conexiones con Turbopass y desea distinguirlas más fácilmente en el futuro.

  4. Pulse el botón Crear Conexión Octo (Create Octo Connection).

 

📗 CONSEJO

Si lo necesita, también puede permitir o excluir productos o destinos a nivel de conexión, además de lo que haya configurado en el revendedor.

 

Mapear productos con Turbopass

Comparta de forma segura la clave API de OCTO que aparece en la conexión que ha creado con su contacto en Turbopass y pídale que mapee sus productos mediante la API OCTO de Ventrata, con los precios (octo/pricing) activados. Normalmente, el equipo de Turbopass tarda solo unos pocos días hábiles en completarlo.

 

Su configuración en Ventrata está completa. No necesita realizar ningún otro paso.

 

📗 CONSEJO

Turbopass puede acceder a todos los productos habilitados en la conexión, pero usted también puede facilitarle los ID de producto y de opción que aparecen en la página de la conexión cuando se ponga en contacto con su equipo, para indicar qué debe mapear.

 

 

Gestionar la conexión con Turbopass

  • Permitir o excluir productos: limite a qué destinos, productos y opciones puede acceder Turbopass. Consulte cómo permitir o excluir productos.

  • Cambie el nombre de la conexión para distinguir varias conexiones con Turbopass.

 

Funciones de la conexión en detalle

Esta sección es para quien quiera saber exactamente cómo funciona la conexión con Turbopass: qué llamadas a la API OCTO de Ventrata realiza Turbopass (a través de la integración certificada de Open Pass), cuándo las realiza y qué significa eso para usted. Cada llamada enlaza con la documentación de la API de Ventrata.

 

En resumen: Turbopass obtiene de Ventrata todo lo que necesita. Lee sus productos, consulta su disponibilidad (y sus precios, cuando los solicita) y envía reservas y cancelaciones. Ventrata no envía cambios a Turbopass, por lo que todo lo que cambie en Ventrata llega a Turbopass la próxima vez que realice una consulta.

 

Los tiempos son los habituales en Turbopass y están redondeados; pueden cambiar si Turbopass modifica su forma de sincronizar.

 

Product Mapping

❌

No puede mapear productos desde Ventrata. Turbopass los mapea por su parte, a través de su gestor de cuenta o del portal de Turbopass.

Funciona así:

  • Get Products (GET /products): cuando Turbopass configura su conexión, y cada vez que actualiza sus anuncios, lee todos los productos habilitados en la conexión, con sus opciones y unidades (tipos de entrada, como Adulto o Niño).

  • Get Product (GET /products/{productId}): Turbopass vuelve a leer un producto concreto para recoger los cambios en sus opciones, unidades, plazos límite de reserva y ajustes.

  • Mapeo por parte de Turbopass: Turbopass vincula cada opción y unidad de Ventrata con su propio anuncio y sus tipos de entrada. Su gestor de cuenta en Turbopass lo hace por usted, o lo hace usted mismo en el portal de Turbopass, si Turbopass ofrece uno. Usted solo comparte la clave API de la conexión.

 

Lo habitual con Turbopass:

  • Turbopass lee su lista completa de productos aproximadamente cada 5 horas.

  • Vuelve a leer cada producto aproximadamente cada 8 horas.

 

Qué significa esto para usted: Turbopass solo puede vender lo que ha mapeado. Cuando añade un producto, una opción o una unidad en Ventrata, es posible que Turbopass lo vea en su siguiente actualización, pero no lo venderá hasta que esté mapeado. Por eso, avise a su gestor de cuenta en Turbopass cada vez que añada uno.

Content Sync

❌

Turbopass no lee el contenido de sus productos desde Ventrata.

Turbopass utiliza las descripciones, imágenes y demás contenido configurados por su parte, así que actualice su contenido directamente con Turbopass.

Availability Sync

✅

Turbopass consulta su disponibilidad en tiempo real en Ventrata. Ventrata no envía los cambios de disponibilidad a Turbopass.

Funciona así:

  • Availability Check (POST /availability): Turbopass envía un producto, una opción y una fecha o un intervalo de fechas. Ventrata responde con cada día o franja horaria reservable, su estado (AVAILABLE, LIMITED, SOLD_OUT, CLOSED o FREESALE), las plazas restantes, el plazo límite de reserva y un availabilityId, que Turbopass necesita para reservar esa franja.

  • Availability Calendar (POST /availability/calendar): devuelve un resumen por día en lugar de cada franja horaria, normalmente para mostrar qué fechas están abiertas en un selector de fechas.

  • Comprobación al reservar: cuando un cliente reserva, Ventrata vuelve a comprobar el aforo antes de crear la reserva, de modo que Turbopass no puede sobrevender una franja que acaba de agotarse, aunque la disponibilidad que tiene almacenada esté ligeramente desactualizada.

 

Lo habitual con Turbopass:

  • Availability Check: Turbopass consulta sus productos a lo largo del día, normalmente a partir de 2 días vista y cubriendo un solo día por solicitud; consulta hasta unos 2 meses vista y vuelve a consultar el mismo producto y las mismas fechas aproximadamente cada 12 horas.

  • Availability Calendar: Turbopass consulta cada producto aproximadamente una vez al día.

  • Las consultas se concentran entre las 07:00 y las 13:00 UTC, lo que sugiere que la mayoría se hacen en tiempo real, mientras los clientes navegan por Turbopass.

 

Qué significa esto para usted: cuando cierra una fecha, cambia el aforo o agota plazas en Ventrata, Turbopass lo muestra después de su siguiente consulta. Para las fechas que consulta con regularidad, eso ocurre en unas 12 horas. Las fechas más lejanas suelen consultarse con menos frecuencia.

Pricing Sync

❌

Turbopass no obtiene sus precios de Ventrata.

Los precios en Turbopass se gestionan desde Turbopass, así que manténgalos actualizados directamente con Turbopass.

Promotions Sync

❌

Sus promociones de Ventrata no se aplican en Turbopass.

Los precios en Turbopass no incluyen las promociones que cree en Ventrata. Configure las promociones directamente con Turbopass.

Bookings Sync

✅

Las reservas y cancelaciones realizadas en Turbopass se crean al instante en Ventrata, y los clientes reciben entradas de Ventrata.

Funciona así:

  1. Retención: Booking Reservation (POST /bookings): cuando un cliente inicia el proceso de pago en Turbopass, Turbopass envía el producto, la opción, la franja elegida (availabilityId) y un elemento de unidad por persona. Ventrata vuelve a comprobar el aforo y crea una reserva ON_HOLD, que retiene las plazas mientras el cliente paga. Si ya no queda sitio, Ventrata rechaza la retención.

  2. Confirmación: Booking Confirmation (POST /bookings/{uuid}/confirm): una vez realizado el pago, Turbopass confirma la retención, con su propia referencia de reserva y los datos de contacto del cliente. La reserva pasa a CONFIRMED en Ventrata, y Ventrata devuelve su referencia de reserva y las entradas (una por persona) o un voucher (uno por reserva), según cómo esté configurado su producto, cada uno con un código QR y un enlace al PDF. Turbopass se los entrega al cliente, que los muestra en su entrada como cualquier entrada de Ventrata.

  3. Caducidad: si el cliente no termina de pagar, Turbopass nunca confirma, y la retención caduca por sí sola y libera las plazas.

  4. Cancelación: Booking Cancellation (POST /bookings/{uuid}/cancel): cuando un cliente cancela en Turbopass, Turbopass cancela la reserva en Ventrata. Ventrata solo lo acepta si la reserva todavía puede cancelarse y no ha pasado el plazo límite de cancelación de la opción. De lo contrario, rechaza la solicitud y Turbopass tiene que ponerse en contacto con usted.

  5. Modificación: Turbopass no utiliza Booking Update (PATCH /bookings/{uuid}), por lo que lo más probable es que un cambio llegue a Ventrata como una cancelación más una nueva reserva.

 

Lo habitual con Turbopass:

  • Turbopass retiene las plazas durante unos 20 minutos mientras el cliente paga (expirationMinutes).

  • Una reserva típica de Turbopass es para unas 3 personas.

  • Turbopass también comprueba las reservas que ha realizado, con Get Booking (GET /bookings/{uuid}) aproximadamente una vez al día, por ejemplo para conciliar sus registros.

 

‼️ IMPORTANTE – Las reservas se sincronizan en un solo sentido, de Turbopass a Ventrata. Si cancela, modifica o vuelve a reservar en Ventrata una reserva procedente de Turbopass, por ejemplo en el Dashboard, Turbopass no recibe ningún aviso. Póngase en contacto con Turbopass para que la reserva también se cancele o modifique por su parte, o pida al cliente que cancele a través de Turbopass.

Pickups/Dropoff Sync

❌

Turbopass no envía datos de recogida ni de regreso con sus reservas.

Si sus productos incluyen recogidas, consulte con Turbopass cómo recopila los datos de recogida, o acuérdelos con el cliente.

Custom Questions Sync

✅ / ❌

Turbopass envía con sus reservas las respuestas a sus preguntas de reserva.

Funciona así:

  • Capability octo/questions: Turbopass lee las preguntas configuradas en sus productos y envía las respuestas del cliente con la reserva, y usted las ve en Ventrata.

 

Lo habitual con Turbopass:

  • Turbopass envía las respuestas a sus preguntas de reserva.

Extras Sync

❌

Los extras y complementos no se pueden reservar a través de Turbopass.

En Turbopass, los clientes solo pueden reservar sus productos y opciones principales. Venda los extras por separado, por ejemplo a la llegada.

Redemption Sync

❌

Los canjes no se notifican a Turbopass.

Ventrata no avisa a Turbopass cuando se escanea o se canjea una entrada. Turbopass solo ve un canje si vuelve a leer la reserva desde Ventrata.

Pass Walkup Scanning Sync

❌

Los titulares de pases de Turbopass no pueden acceder escaneando su pase en su entrada sin una reserva.

Los clientes de Turbopass necesitan una reserva hecha a través de Turbopass antes de su visita.

Gift Card Sync

❌

Las tarjetas regalo de Ventrata no se pueden vender ni canjear a través de Turbopass.

Las tarjetas regalo compradas en Ventrata no se pueden usar en Turbopass, y Turbopass no puede vender tarjetas regalo de Ventrata.

✅ compatible · ✅ / ❌ limitado · ❌ no compatible

 

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

  • Retrasos: la disponibilidad y los precios llegan a Turbopass solo cuando realiza una consulta, por lo que siempre hay un breve retraso después de que cambie algo en Ventrata.

  • Plazo límite de cancelación: Turbopass solo puede cancelar mediante la API antes del plazo límite de cancelación de su opción. Las cancelaciones posteriores deben acordarse con usted.

  • Qué puede ver Turbopass: solo los destinos, productos y opciones permitidos en el revendedor y en la conexión, y habilitados para la venta en la fuente API directa (Direct API). Consulte cómo permitir o excluir productos.

  • Entradas: Turbopass emite las entradas o el voucher de Ventrata que recibe con la confirmación, por lo que el escaneo y el canje habituales funcionan con normalidad.

  • Reservas de prueba: Turbopass puede enviar reservas de prueba mientras configura la conexión. Las reservas de prueba no consumen su disponibilidad y no se facturan.

 

Preguntas frecuentes

No se muestra ningún producto en la página de la conexión.

Compruebe qué destinos, productos y opciones están permitidos en su revendedor y en su conexión. Después, confirme que sus productos y opciones están habilitados para la venta en la fuente API directa (Direct API). Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

Mis productos de Ventrata usan tarifas por tamaño de la reserva (Booking Size) y los precios no funcionan correctamente en Turbopass.

Después de cada cambio de tarifa, actualice el mapeo de productos para que los tramos del partner se sincronicen con Ventrata. Asegúrese de que la tarifa esté habilitada para la venta en la API directa (Direct API).

 

 

Información del partner

Turbopass GmbH

Niederwall 53, 33602 Bielefeld

Alemania

 

ID de partner de Ventrata: c78de6f3-0617-4245-842d-df7ba331727c

 

TWG Systems Limited

Avon View House, Station Road, Fladbury, Pershore, Inglaterra, WR10 2QW

United Kingdom

 

ID de partner de Ventrata: ad24532f-4770-428f-802c-9f7e6b17e038

¿Ha quedado contestada tu pregunta?