con tecnología de Holidu Smart Destination

Zürich Tourism es la organización oficial de marketing de destino de Zúrich, que promociona la ciudad y la región circundante entre viajeros de ocio, de negocios y de eventos, y vende la Zürich Card, visitas guiadas a pie, excursiones y entradas para eventos a través de su sitio web y de una oficina de información al visitante con personal en la estación central de Zúrich. Para los operadores, aporta visitantes de la ciudad que compran antes del viaje y a su llegada en el mostrador de la estación, además de negocio profesional y de congresos gestionado por su sección de empresas. Zürich Tourism utiliza Holidu Smart Destination como proveedor de conectividad.

Al conectar Zürich Tourism con Ventrata, se sincronizan su disponibilidad y sus precios, y recibe las reservas, los cambios y las cancelaciones con las entradas emitidas automáticamente. Zürich Tourism funciona con Holidu Smart Destination 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 Zürich Tourism, visite zuerich.com.

Sitio web principal	zuerich.com
Etiquetas	Destination Organization (DMO)
Mercados de destino	🇨🇭 Suiza
Mercados emisores	🌎 Global
Especialidades	Zürich Card oficial, rutas a pie y excursiones en el mostrador de la estación
Funciones de la conexión	Availability Sync · Pricing Sync · Bookings Sync
Desarrollado por	Holidu Smart Destination (TOMAS) (mediante la API OCTO de Ventrata)

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

Availability Sync: Zürich Tourism consulta su disponibilidad en tiempo real en Ventrata.
Pricing Sync: Zürich Tourism obtiene sus precios a partir de los precios de su revendedor en Ventrata.
Bookings Sync: las reservas, modificaciones y cancelaciones de Zürich Tourism se crean al instante en Ventrata, y los clientes reciben entradas de Ventrata.

Crear la conexión con Zürich Tourism

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

Antes de empezar:

Debe tener un acuerdo comercial con Zürich Tourism para que el partner pueda vender sus productos. Para informarse sobre cómo asociarse con ellos, póngase en contacto a través de zuerich.com.
Debe tener Zürich Tourism 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)».

En el Ventrata Dashboard, vaya a Conexiones → Conexiones (Connections → Connections), haga clic en + Nueva conexión (+ New Connection) y seleccione Zürich Tourism (con tecnología de Holidu Smart Destination) en la lista de partners.
Seleccione el revendedor Zürich Tourism 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.
(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 Zürich Tourism y desea distinguirlas más fácilmente en el futuro.
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 Zürich Tourism

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

Zürich Tourism 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 Zürich Tourism

Permitir o excluir productos: limite a qué destinos, productos y opciones puede acceder Zürich Tourism. Consulte cómo permitir o excluir productos.
Cambie el nombre de la conexión para distinguir varias conexiones con Zürich Tourism.

Funciones de la conexión en detalle

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

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

Product Mapping	❌	No puede mapear productos desde Ventrata. Zürich Tourism los mapea por su parte, a través de su gestor de cuenta o del portal de Zürich Tourism. Funciona así: Get Products (`GET /products`): cuando Zürich Tourism 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}`): Zürich Tourism 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 Zürich Tourism: Zürich Tourism vincula cada opción y unidad de Ventrata con su propio anuncio y sus tipos de entrada. Su gestor de cuenta en Zürich Tourism lo hace por usted, o lo hace usted mismo en el portal de Zürich Tourism, si Zürich Tourism ofrece uno. Usted solo comparte la clave API de la conexión. Qué significa esto para usted: Zürich Tourism solo puede vender lo que ha mapeado. Cuando añade un producto, una opción o una unidad en Ventrata, es posible que Zürich Tourism lo vea en su siguiente actualización, pero no lo venderá hasta que esté mapeado. Por eso, avise a su gestor de cuenta en Zürich Tourism cada vez que añada uno.
Content Sync	❌	Zürich Tourism no lee el contenido de sus productos desde Ventrata. Zürich Tourism utiliza las descripciones, imágenes y demás contenido configurados por su parte, así que actualice su contenido directamente con Zürich Tourism.
Availability Sync	✅	Zürich Tourism consulta su disponibilidad en tiempo real en Ventrata. Ventrata no envía los cambios de disponibilidad a Zürich Tourism. Funciona así: Availability Check (`POST /availability`): Zürich Tourism 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 Zürich Tourism 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 Zürich Tourism no puede sobrevender una franja que acaba de agotarse, aunque la disponibilidad que tiene almacenada esté ligeramente desactualizada. Qué significa esto para usted: cuando cierra una fecha, cambia el aforo o agota plazas en Ventrata, Zürich Tourism lo muestra solo después de su siguiente consulta, por lo que puede haber un breve retraso. La comprobación de Ventrata al reservar sigue evitando la sobreventa.
Pricing Sync	✅	Sus precios se devuelven con cada consulta de disponibilidad, una vez que Zürich Tourism los solicita con la capability octo/pricing. Funciona así: Capability `octo/pricing`: Zürich Tourism 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 Zürich Tourism, 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 Zürich Tourism 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ó. ‼️ IMPORTANTE – Pida que se activen los precios. Cuando pida a Zürich Tourism 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 Zürich Tourism. De lo contrario, podrían estar desactivados y Zürich Tourism no recibiría sus precios de Ventrata.
Promotions Sync	❌	Sus promociones de Ventrata no se aplican en Zürich Tourism. Los precios en Zürich Tourism no incluyen las promociones que cree en Ventrata. Configure las promociones directamente con Zürich Tourism.
Bookings Sync	✅	Las reservas y cancelaciones realizadas en Zürich Tourism se crean al instante en Ventrata, y los clientes reciben entradas de Ventrata. Funciona así: Retención: Booking Reservation (`POST /bookings`): cuando un cliente inicia el proceso de pago en Zürich Tourism, Zürich Tourism 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. Confirmación: Booking Confirmation (`POST /bookings/{uuid}/confirm`): una vez realizado el pago, Zürich Tourism 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. Zürich Tourism se los entrega al cliente, que los muestra en su entrada como cualquier entrada de Ventrata. Caducidad: si el cliente no termina de pagar, Zürich Tourism nunca confirma, y la retención caduca por sí sola y libera las plazas. Cancelación: Booking Cancellation (`POST /bookings/{uuid}/cancel`): cuando un cliente cancela en Zürich Tourism, Zürich Tourism 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 Zürich Tourism tiene que ponerse en contacto con usted. Modificación: Booking Update (`PATCH /bookings/{uuid}`): permite a Zürich Tourism 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 Zürich Tourism a Ventrata. Si cancela, modifica o vuelve a reservar en Ventrata una reserva procedente de Zürich Tourism, por ejemplo en el Dashboard, Zürich Tourism no recibe ningún aviso. Póngase en contacto con Zürich Tourism para que la reserva también se cancele o modifique por su parte, o pida al cliente que cancele a través de Zürich Tourism.
Pickups/Dropoff Sync	❌	Zürich Tourism no envía datos de recogida ni de regreso con sus reservas. Si sus productos incluyen recogidas, consulte con Zürich Tourism cómo recopila los datos de recogida, o acuérdelos con el cliente.
Custom Questions Sync	❌	Zürich Tourism 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 Zürich Tourism cómo recopila esa información.
Extras Sync	❌	Los extras y complementos no se pueden reservar a través de Zürich Tourism. En Zürich Tourism, 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 Zürich Tourism. Ventrata no avisa a Zürich Tourism cuando se escanea o se canjea una entrada. Zürich Tourism solo ve un canje si vuelve a leer la reserva desde Ventrata.
Pass Walkup Scanning Sync	❌	Los titulares de pases de Zürich Tourism no pueden acceder escaneando su pase en su entrada sin una reserva. Los clientes de Zürich Tourism necesitan una reserva hecha a través de Zürich Tourism antes de su visita.
Gift Card Sync	❌	Las tarjetas regalo de Ventrata no se pueden vender ni canjear a través de Zürich Tourism. Las tarjetas regalo compradas en Ventrata no se pueden usar en Zürich Tourism, y Zürich Tourism no puede vender tarjetas regalo de Ventrata.

✅ compatible · ❌ no compatible

Conviene saber: límites y detalles de la conexión con Zürich Tourism

Retrasos: la disponibilidad y los precios llegan a Zürich Tourism 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: Zürich Tourism 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 Zürich Tourism: 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: Zürich Tourism 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: Zürich Tourism 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 Zürich Tourism.

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

📚 Más sobre las conexiones de Ventrata

Información del partner

Zürich Tourismus

Gessnerallee 3, 8001 Zürich

Suiza

zuerich.com

ID de partner de Ventrata: 6c400e45-18a2-4fcf-b311-87b6a77a86ad

Holidu Smart Destination GmbH

Riesstraße 24, 80992 München

Alemania

holidu.de/hsd

ID de partner de Ventrata: 73d55f64-f964-494c-ae18-5efa566220ac

Zürich Tourism: conexión de revendedor