Berlin WelcomeCard es el billete turístico oficial de Berlín, emitido por la oficina de turismo visitBerlin y vendido más de 15 millones de veces. Combina transporte público ilimitado en las zonas AB o ABC con descuentos en más de 170 atracciones, y sus ampliaciones añaden la entrada a la Isla de los Museos o la entrada gratuita a más de 25 atracciones. A las atracciones les aporta visitantes de Alemania y del extranjero, tanto primerizos como habituales, que compran la tarjeta online o en puntos de venta y planifican sus visitas en torno a ella. Esta conexión la desarrolla y gestiona Public Ticket Solution.

Conectar Berlin WelcomeCard a Ventrata le permite escanear, validar y canjear pases de Berlin WelcomeCard en su entrada, en tornos, quioscos y terminales de punto de venta con tecnología de Ventrata, en la app móvil o en el Ventrata Dashboard, sin necesidad de una app de Berlin WelcomeCard aparte.

Para obtener más información sobre Berlin WelcomeCard, visite berlin-welcomecard.de.

Sitio web principal	berlin-welcomecard.de
Etiquetas	Destination Organization (DMO) · Multi-Attraction Pass
Tipo de conexión	Canje de pases: usted escanea los pases de Berlin WelcomeCard en su entrada
Funciones de la conexión	Product Mapping · Redemption Sync · Pass Walkup Scanning Sync
Desarrollado por	Ventrata (mediante visitBerlin Ticket Gateway API)

Esta conexión le permite:

Escanee o escriba un código de entrada de Berlin WelcomeCard en Ventrata y verifíquelo con Berlin WelcomeCard en tiempo real.
Cree automáticamente una reserva en Ventrata para cada entrada válida.
Registre la entrada en Berlin WelcomeCard en el momento del escaneo, para que la entrada quede marcada como utilizada.

Cómo funciona

El personal escanea o escribe un código de entrada de WelcomeCard en Ventrata: en la búsqueda de pedidos del Backoffice, en un escáner o terminal de Ventrata, o a través de la API de canje/check-in OCTO de Ventrata.
Ventrata solo trata como entradas de WelcomeCard los códigos que empiezan por «TE» seguido de al menos 12 caracteres. Los demás códigos se dejan para sus otras conexiones.
Si la entrada ya se había reservado para este revendedor, Ventrata devuelve esa reserva existente.
De lo contrario, Ventrata envía a Berlin WelcomeCard un escaneo de solo consulta para verificar la entrada y encontrar su variante de producto.
A continuación, Ventrata registra un escaneo de entrada en Berlin WelcomeCard, con su Entry Zone ID y su Organization ID y la hora actual.
Si Berlin WelcomeCard confirma que el escaneo se ha registrado correctamente, Ventrata guarda una reserva con fecha abierta de 1 unidad del producto, la opción y la unidad que haya mapeado a esa variante.

📒 NOTA

Códigos de entrada que coinciden con «TE» seguido de al menos 12 letras o dígitos (regex ^TE\w{12,}$). Esta conexión ignora cualquier otro código.

Crear la conexión con Berlin WelcomeCard

🔐 Permisos de rol necesarios: See Connections, Modify Connections

Antes de empezar:

Tenga a mano sus credenciales de la API de Berlin WelcomeCard: Username, Password, Product ID, Organization ID y Entry Zone ID.
Cree Berlin WelcomeCard como revendedor en Ventrata y selecciónelo en la conexión. El formulario indica que el campo Revendedor (Reseller) es opcional, pero las búsquedas lo necesitan.

Crear la conexión

Seleccione su revendedor Berlin WelcomeCard.
Introduzca el Username, la Password, el Product ID, el Organization ID y el Entry Zone ID.
Guarde. Ventrata inicia sesión, obtiene el producto y sus variantes, y crea una fila de mapeo por variante.

El formulario de conexión tiene estas opciones:

Reseller	El revendedor con el que se registran las reservas de WelcomeCard. Es opcional en el formulario, pero en la práctica es necesario para las búsquedas.
Berlin Welcomecard Username / Password	Ventrata inicia sesión con estos datos al guardar. Si el inicio de sesión falla, ambos campos se marcan como no válidos.
Berlin Welcomecard Product ID	El producto de WelcomeCard cuyas variantes carga Ventrata para el mapeo. Si no se encuentra el producto, el campo se marca como no válido.
Berlin Welcomecard Organization ID	Se envía con cada escaneo de entrada. No se comprueba al guardar.
Berlin Welcomecard Entry Zone ID	La zona de entrada en la que se registra cada escaneo. No se comprueba al guardar; un valor incorrecto solo se detecta en el momento del escaneo.

Mapear productos

Al guardar la conexión, Ventrata crea una fila por cada variante del producto de WelcomeCard configurado. Las variantes que ya no existen se eliminan. Si una entrada escaneada pertenece a una variante que aún no tiene fila, Ventrata añade la fila en el momento del escaneo.

Abra la conexión y seleccione cada fila de variante.
Elija el producto, la opción y la unidad de Ventrata que se reservarán para esa variante. La opción y la unidad son obligatorias.
Vuelva a guardar la conexión siempre que cambien las variantes de WelcomeCard. Las filas solo se actualizan al guardar.

📒 NOTA

Una entrada de una variante sin mapear falla con « is not mapped in <connection>» hasta que la mapee.

Redemption

Inmediatamente: Siempre. El escaneo de entrada se registra en Berlin WelcomeCard en el momento del escaneo, y la reserva solo se guarda si el proveedor confirma que se ha registrado correctamente.
Al canjear o en caso de no presentarse: No compatible. Las opciones Redeem on Redemption/Upgrade y Redeem on No-show no aparecen para esta conexión.
Qué se envía a Berlin WelcomeCard: Un evento de escaneo de entrada (scanEventCreate, kind entry) con su zona de entrada, su organización, la hora actual y el nombre de dispositivo «Ventrata».

Funciones de la conexión en detalle

Esta sección es para quien quiera conocer los detalles. Haga clic en una fila para ver cómo funciona cada funcionalidad.

Product Mapping	✅	Usted mapea cada pase de Berlin WelcomeCard con un producto de Ventrata en el Ventrata Dashboard. Al guardar la conexión, Ventrata crea una fila por cada variante del producto de WelcomeCard configurado. Las variantes que ya no existen se eliminan. Si una entrada escaneada pertenece a una variante que aún no tiene fila, Ventrata añade la fila en el momento del escaneo. Una entrada de una variante sin mapear falla con « is not mapped in <connection>» hasta que la mapee.
Content Sync	❌	El contenido de los productos no se sincroniza. Berlin WelcomeCard vende su propio pase. Sus productos y su contenido permanecen en Ventrata.
Availability Sync	❌	Su disponibilidad no se comparte con Berlin WelcomeCard. No hay intercambio de disponibilidad ni de aforo con Berlin WelcomeCard.
Pricing Sync	❌	Los precios no se sincronizan con Berlin WelcomeCard. La reserva utiliza su precio unitario de Ventrata y se liquida mediante voucher, por lo que el saldo del pedido es cero. No se envía ningún precio a Berlin WelcomeCard.
Promotions Sync	❌	Las promociones no se aplican a los pases de Berlin WelcomeCard. Sus promociones de Ventrata no se aplican a las reservas creadas al escanear un pase.
Bookings Sync	✅ / ❌	Limitado: las reservas solo se crean cuando se escanea un pase. Una reserva con fecha abierta por entrada, con cantidad 1 de la unidad mapeada, creada cuando se escanea la entrada. La referencia del revendedor es el código de la entrada sin el prefijo «TE». Se omiten las comprobaciones de cliente, preguntas, transporte y acompañante. Volver a escanear la misma entrada devuelve la reserva existente. No hay ninguna llamada de cancelación a Berlin WelcomeCard. Un escaneo registrado no se puede deshacer desde Ventrata.
Pickups/Dropoff Sync	❌	No forma parte de esta conexión. Los canjes de pases no incluyen recogidas.
Custom Questions Sync	❌	No forma parte de esta conexión. En los canjes de pases no se hacen ni se envían preguntas de reserva.
Extras Sync	❌	No forma parte de esta conexión. No se pueden añadir extras a un canje de pase.
Redemption Sync	✅	Los canjes se envían a Berlin WelcomeCard. Siempre. El escaneo de entrada se registra en Berlin WelcomeCard en el momento del escaneo, y la reserva solo se guarda si el proveedor confirma que se ha registrado correctamente. No compatible. Las opciones Redeem on Redemption/Upgrade y Redeem on No-show no aparecen para esta conexión. Un evento de escaneo de entrada (scanEventCreate, kind entry) con su zona de entrada, su organización, la hora actual y el nombre de dispositivo «Ventrata».
Pass Walkup Scanning Sync	✅	Usted escanea los pases de Berlin WelcomeCard en su entrada. El personal escanea o escribe un código de entrada de WelcomeCard en Ventrata: en la búsqueda de pedidos del Backoffice, en un escáner o terminal de Ventrata, o a través de la API de canje/check-in OCTO de Ventrata. Ventrata solo trata como entradas de WelcomeCard los códigos que empiezan por «TE» seguido de al menos 12 caracteres. Los demás códigos se dejan para sus otras conexiones. Si la entrada ya se había reservado para este revendedor, Ventrata devuelve esa reserva existente.
Gift Card Sync	❌	No forma parte de esta conexión. Los pases de Berlin WelcomeCard no son tarjetas regalo de Ventrata.

✅ compatible · ✅ / ❌ limitado · ❌ no compatible

Conviene saberlo: límites de esta conexión

Un Product ID de WelcomeCard por conexión. Para aceptar varios productos de WelcomeCard, probablemente necesite una conexión por producto.
Los mapeos solo se actualizan cuando vuelve a guardar la conexión.
El canje no se puede aplazar hasta la admisión o la no presentación.
Sin recogidas, extras, preguntas personalizadas ni recursos.
Los resultados de las búsquedas se almacenan en caché durante 5 minutos. Si Berlin WelcomeCard no responde en unos 12 segundos, el código se considera no encontrado.

Solución de problemas

"%{title} is not mapped in %{connection}"

La variante de la entrada no tiene mapeado ningún producto, opción ni unidad de Ventrata. Mapee la fila de la variante en la conexión y vuelva a escanear.

"Redemption not allowed"