Ir al contenido principal

TUI Musement: conexión de revendedor

Conecte TUI Musement con Ventrata para sincronizar la disponibilidad y los precios, y recibir reservas al instante. Vende excursiones y traslados a turistas con paquetes vacacionales.

TUI Musement logo

 

TUI Musement es el negocio de tours, actividades y traslados de TUI Group, y vende excursiones, entradas a atracciones y experiencias de varios días en más de 90 países a través de los canales propios de TUI, sus sitios web y una red de partners de distribución. Para los operadores, aporta viajeros de paquetes vacacionales de los principales mercados europeos de TUI, encabezados por Reino Unido e Irlanda, Alemania y los países nórdicos, que añaden excursiones, entradas y traslados a sus vacaciones de playa y de ciudad antes y durante su estancia.

 

Conectar TUI Musement con Ventrata sincroniza su disponibilidad y sus precios y le hace llegar reservas, modificaciones y cancelaciones con emisión automática de entradas.

 

Para obtener más información sobre cómo asociarse con TUI Musement, visite tuimusement.com.

 

Sitio web principal

Etiquetas

OTA · Tours & Activities OTA

Mercados de destino

🌎 Global

Mercados emisores

🌎 Global

Especialidades

Excursiones y traslados para turistas de paquetes vacacionales

Funciones de la conexión

Availability Sync · Pricing Sync · Bookings Sync · Pickups/Dropoff Sync

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

US$10M+

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

25+

Desarrollado por

TUI Musement (mediante la API OCTO de Ventrata)

 

Esta conexión de revendedor le permite vender sus productos a través de TUI Musement sin gestionar a mano la disponibilidad, los precios y las reservas. Las funciones de esta conexión incluyen:

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

  • Pricing Sync: TUI Musement obtiene sus precios a partir de los precios de su revendedor en Ventrata.

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

  • Pickups/Dropoff Sync: los datos de recogida y bajada se sincronizan entre TUI Musement y Ventrata.

 

Crear la conexión con TUI Musement

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

Antes de empezar:

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

  • Debe tener TUI Musement 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 TUI Musement en la lista de partners.

  2. Seleccione el revendedor TUI Musement 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 TUI Musement 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 TUI Musement

Comparta de forma segura la clave API de OCTO que aparece en la conexión que ha creado con su contacto en TUI Musement y pídale que mapee sus productos mediante la API OCTO de Ventrata, con los precios (octo/pricing) activados. Normalmente, el equipo de TUI Musement 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

TUI Musement 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 TUI Musement

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

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

 

Funciones de la conexión en detalle

Esta sección es para quien quiera saber exactamente cómo funciona la conexión con TUI Musement: qué llamadas a la API OCTO de Ventrata realiza TUI Musement, cuándo las realiza y qué significa eso para usted. Cada llamada enlaza con la documentación de la API de Ventrata.

 

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

 

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

 

Product Mapping

❌

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

Funciona así:

  • Get Products (GET /products): cuando TUI Musement 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}): TUI Musement 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 TUI Musement: TUI Musement vincula cada opción y unidad de Ventrata con su propio anuncio y sus tipos de entrada. Su gestor de cuenta en TUI Musement lo hace por usted, o lo hace usted mismo en el portal de TUI Musement, si TUI Musement ofrece uno. Usted solo comparte la clave API de la conexión.

 

Lo habitual con TUI Musement:

  • TUI Musement lee su lista completa de productos aproximadamente cada 9 horas.

  • Vuelve a leer cada producto aproximadamente una vez al día.

 

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

Content Sync

✅ / ❌

TUI Musement puede leer el contenido de sus productos, como descripciones e imágenes, desde Ventrata.

Funciona así:

  • Capability octo/content: cuando TUI Musement la añade a la cabecera Octo-Capabilities, Get Products (GET /products) y Get Product (GET /products/{productId}) también devuelven el contenido de sus productos, como descripciones, puntos destacados, servicios incluidos e imágenes.

  • Los cambios de contenido en Ventrata llegan a TUI Musement en su siguiente actualización de productos.

 

Lo habitual con TUI Musement:

  • TUI Musement solicita octo/content.

Availability Sync

✅

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

Funciona así:

  • Availability Check (POST /availability): TUI Musement 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 TUI Musement necesita para reservar esa franja.

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

 

Lo habitual con TUI Musement:

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

  • Las consultas se reparten a lo largo del día sin un pico marcado, lo que sugiere una combinación de sincronizaciones programadas y búsquedas de clientes en tiempo real.

 

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

Pricing Sync

✅

Sus precios se devuelven con cada consulta de disponibilidad, una vez que TUI Musement los solicita con la capability octo/pricing.

Funciona así:

  • Capability octo/pricing: TUI Musement solicita los precios añadiendo octo/pricing a la cabecera Octo-Capabilities de sus solicitudes. Sin ella, Ventrata envía la disponibilidad sin ningún precio.

  • Availability Check (POST /availability): con los precios activados, cada día o franja horaria se devuelve con su precio por unidad (tipo de entrada): el precio de venta al público que paga el cliente y el precio neto que usted factura a TUI Musement, ambos a partir de los precios del revendedor en Ventrata (de venta al público y mayoristas o de comisión).

  • Precios para grupos: cuando TUI Musement también envía cuántas personas de cada tipo de unidad reservan, Ventrata calcula el precio de ese grupo exacto. Esto es importante para las tarifas por tamaño de la reserva (Booking Size) y otros precios para grupos.

  • Booking Reservation (POST /bookings) y Booking Confirmation (POST /bookings/{uuid}/confirm): la reserva se devuelve con su precio final de venta al público y neto, de modo que la reserva en Ventrata siempre registra el precio al que se vendió.

 

Lo habitual con TUI Musement:

  • TUI Musement solicita octo/pricing en todas sus consultas de disponibilidad, por lo que vende con sus precios de Ventrata.

  • TUI Musement no envía el número de personas por tipo de unidad, por lo que los precios se devuelven por persona, y los precios para grupos, como las tarifas por tamaño de la reserva (Booking Size), podrían no mostrarse correctamente en TUI Musement.

 

‼️ IMPORTANTE – Pida que se activen los precios. Cuando pida a TUI Musement que mapee sus productos, pídale también que active los precios (octo/pricing), o actívelos usted mismo si mapea en el portal de TUI Musement. De lo contrario, podrían estar desactivados y TUI Musement no recibiría sus precios de Ventrata.

📗 CONSEJO – Si los precios en TUI Musement parecen incorrectos, revise primero los precios del revendedor TUI Musement en Ventrata: es lo que lee TUI Musement.

Promotions Sync

❌

Sus promociones de Ventrata no se aplican en TUI Musement.

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

Bookings Sync

✅

Las reservas y cancelaciones realizadas en TUI Musement 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 TUI Musement, TUI Musement 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, TUI Musement 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. TUI Musement 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, TUI Musement 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 TUI Musement, TUI Musement 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 TUI Musement tiene que ponerse en contacto con usted.

  5. Modificación: TUI Musement 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 TUI Musement:

  • TUI Musement no establece un tiempo de retención, por lo que se aplica el tiempo de retención predeterminado.

  • Una reserva típica de TUI Musement es para unas 2 personas.

  • Es normal ver más retenciones que reservas confirmadas: las retenciones de clientes que no terminan de pagar simplemente caducan.

 

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

Pickups/Dropoff Sync

✅

TUI Musement envía los datos de recogida con sus reservas.

Funciona así:

  • Capability octo/pickups: TUI Musement puede ver qué opciones ofrecen recogida y sus puntos de recogida, y enviar con la reserva el punto de recogida o el hotel del cliente.

  • Si un hotel no coincide con ninguno de sus puntos de recogida, Ventrata lo guarda con la reserva para que pueda organizar la recogida.

 

Lo habitual con TUI Musement:

  • TUI Musement envía los datos de recogida con sus reservas.

Custom Questions Sync

✅ / ❌

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

Funciona así:

  • Capability octo/questions: TUI Musement 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 TUI Musement:

  • TUI Musement envía las respuestas a sus preguntas de reserva.

Extras Sync

❌

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

En TUI Musement, 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 TUI Musement.

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

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

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

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

✅ compatible · ✅ / ❌ limitado · ❌ no compatible

 

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

  • Retrasos: la disponibilidad y los precios llegan a TUI Musement 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: TUI Musement 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 TUI Musement: 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: TUI Musement 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: TUI Musement 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 TUI Musement.

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

Musement S.p.A.

Via Polesine 13

20139 Milán, Italia

 

ID de partner de Ventrata: 8791dce6-29eb-43eb-8e8f-489eb918cf30

¿Ha quedado contestada tu pregunta?