Ir al contenido principal

City Tour Worldwide: conexión de revendedor

Conecte City Tour Worldwide con Ventrata para sincronizar la disponibilidad y los precios, y recibir reservas al instante. Visitas turísticas en autobús hop-on hop-off y tren turístico.

City Tour Worldwide logo con tecnología de Palisis TourCMS icon Palisis TourCMS

 

City Tour Worldwide es la marca de turismo urbano del Grupo Julià, que opera autobuses y trenes turísticos hop-on hop-off con más de 250 vehículos en tres continentes. Sus autobuses circulan en Madrid, Barcelona, Roma, Londres, Ciudad de México y Marrakech, con trenes turísticos en Granada y San Sebastián, y su propia agencia de viajes online vende además tours temáticos gastronómicos, culturales y al aire libre. Para los operadores, aporta pasajeros de autobús y clientes online en esas ciudades que añaden tours y atracciones a su día de turismo, con más de 40 descuentos de partners a bordo que dirigen a los viajeros hacia productos locales. City Tour Worldwide utiliza Palisis TourCMS como proveedor de conectividad.

 

Al conectar City Tour Worldwide con Ventrata, se sincronizan su disponibilidad y sus precios, y recibe las reservas, los cambios y las cancelaciones con las entradas emitidas automáticamente. City Tour Worldwide funciona con Palisis TourCMS 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 City Tour Worldwide, visite city-tour.com.

 

📒 NOTA

Esta conexión solo está disponible para determinadas cuentas de cliente. Si le interesa utilizarla, póngase en contacto con nuestro Soporte técnico o con su Customer Success Manager de Ventrata.

 

Sitio web principal

Etiquetas

Operator Reselling Others · Sightseeing & Hop-On Hop-Off

Mercados de destino

🌎 Global

Mercados emisores

🌎 Global

Especialidades

Visitas turísticas hop-on hop-off en autobús y tren turístico

Funciones de la conexión

Availability Sync · Pricing Sync · Bookings Sync

Desarrollado por

Palisis TourCMS (mediante la API OCTO de Ventrata)

 

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

  • Availability Sync: City Tour Worldwide consulta su disponibilidad en tiempo real en Ventrata.

  • Pricing Sync: City Tour Worldwide obtiene sus precios a partir de los precios de su revendedor en Ventrata.

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

 

Crear la conexión con City Tour Worldwide

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

Antes de empezar:

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

  • Debe tener City Tour Worldwide 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 City Tour Worldwide (con tecnología de Palisis TourCMS) en la lista de partners.

  2. Seleccione el revendedor City Tour Worldwide 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 City Tour Worldwide 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 City Tour Worldwide

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

City Tour Worldwide 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 City Tour Worldwide

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

  • Cambie el nombre de la conexión para distinguir varias conexiones con City Tour Worldwide.

 

Funciones de la conexión en detalle

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

 

En resumen: City Tour Worldwide 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 City Tour Worldwide, por lo que todo lo que cambie en Ventrata llega a City Tour Worldwide la próxima vez que realice una consulta.

 

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

 

Product Mapping

❌

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

Funciona así:

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

 

Lo habitual con City Tour Worldwide:

  • Vuelve a leer cada producto aproximadamente cada 8 horas.

 

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

Content Sync

❌

City Tour Worldwide no lee el contenido de sus productos desde Ventrata.

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

Availability Sync

✅

City Tour Worldwide consulta su disponibilidad en tiempo real en Ventrata. Ventrata no envía los cambios de disponibilidad a City Tour Worldwide.

Funciona así:

  • Availability Check (POST /availability): City Tour Worldwide 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 City Tour Worldwide 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 City Tour Worldwide no puede sobrevender una franja que acaba de agotarse, aunque la disponibilidad que tiene almacenada esté ligeramente desactualizada.

 

Lo habitual con City Tour Worldwide:

  • Availability Check: City Tour Worldwide consulta cada producto aproximadamente cada 3 horas, normalmente a partir de 45 días vista y cubriendo 30 días por solicitud, y consulta hasta unos 10 meses vista.

 

Qué significa esto para usted: cuando cierra una fecha, cambia el aforo o agota plazas en Ventrata, City Tour Worldwide 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 City Tour Worldwide los solicita con la capability octo/pricing.

Funciona así:

  • Capability octo/pricing: City Tour Worldwide 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 City Tour Worldwide, 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 City Tour Worldwide 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 City Tour Worldwide:

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

  • City Tour Worldwide 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 City Tour Worldwide.

 

‼️ IMPORTANTE – Pida que se activen los precios. Cuando pida a City Tour Worldwide 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 City Tour Worldwide. De lo contrario, podrían estar desactivados y City Tour Worldwide no recibiría sus precios de Ventrata.

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

Promotions Sync

❌

Sus promociones de Ventrata no se aplican en City Tour Worldwide.

Los precios en City Tour Worldwide no incluyen las promociones que cree en Ventrata. Configure las promociones directamente con City Tour Worldwide.

Bookings Sync

✅

Las reservas y cancelaciones realizadas en City Tour Worldwide 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 City Tour Worldwide, City Tour Worldwide 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, City Tour Worldwide confirma la retención. 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. City Tour Worldwide 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, City Tour Worldwide 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 City Tour Worldwide, City Tour Worldwide 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 City Tour Worldwide tiene que ponerse en contacto con usted.

  5. Modificación: Booking Update (PATCH /bookings/{uuid}): permite a City Tour Worldwide modificar una reserva directamente, por ejemplo con una nueva fecha, hora o número de personas. Algunos revendedores cancelan y vuelven a reservar en su lugar.

 

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

Pickups/Dropoff Sync

❌

City Tour Worldwide no envía datos de recogida ni de regreso con sus reservas.

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

Custom Questions Sync

❌

City Tour Worldwide no envía las respuestas a sus preguntas de reserva.

Si depende de las preguntas de reserva, por ejemplo nombres o necesidades alimentarias, consulte con City Tour Worldwide cómo recopila esa información.

Extras Sync

❌

Los extras y complementos no se pueden reservar a través de City Tour Worldwide.

En City Tour Worldwide, 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 City Tour Worldwide.

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

Pass Walkup Scanning Sync

❌

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

Los clientes de City Tour Worldwide necesitan una reserva hecha a través de City Tour Worldwide antes de su visita.

Gift Card Sync

❌

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

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

✅ compatible · ❌ no compatible

 

Conviene saber: límites y detalles de la conexión con City Tour Worldwide

  • Retrasos: la disponibilidad y los precios llegan a City Tour Worldwide 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: City Tour Worldwide 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 City Tour Worldwide: 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: City Tour Worldwide 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: City Tour Worldwide 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 City Tour Worldwide.

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

Julià Travel, S.L.U.

Calle Pablo Iglesias 84, 08908 L'Hospitalet de Llobregat, Barcelona

España

 

ID de partner de Ventrata: 2335aa39-ca10-4d01-8a84-4a9edc4159e6

 

Palisis AG

Florastrasse 18a, 8610 Uster

Suiza

 

ID de partner de Ventrata: f4765bbb-2453-4404-8124-7ffb8f498e8e

¿Ha quedado contestada tu pregunta?