Berlin WelcomeCard est le titre touristique officiel de Berlin, émis par l'office de tourisme visitBerlin et vendu à plus de 15 millions d'exemplaires. Il associe un accès illimité aux transports publics dans les zones AB ou ABC à des réductions dans plus de 170 attractions, et des options supplémentaires ajoutent l'entrée à l'île aux Musées ou l'accès gratuit à plus de 25 attractions. Pour les attractions, il apporte des visiteurs allemands et étrangers, venus pour la première fois ou habitués, qui achètent la carte en ligne ou dans des points de vente et organisent leurs visites autour d'elle. Cette connexion est développée et gérée par Public Ticket Solution.

Connecter Berlin WelcomeCard à Ventrata vous permet de scanner, contrôler et valider les pass Berlin WelcomeCard à votre entrée, sur les tourniquets, bornes, terminaux de point de vente propulsés par Ventrata, sur l'application mobile ou dans le Ventrata Dashboard, sans application Berlin WelcomeCard distincte.

Pour en savoir plus sur Berlin WelcomeCard, rendez-vous sur berlin-welcomecard.de.

Site web principal	berlin-welcomecard.de
Tags	Destination Organization (DMO) · Multi-Attraction Pass
Type de connexion	Validation des pass : vous scannez les pass Berlin WelcomeCard à votre entrée
Fonctionnalités de la connexion	Product Mapping · Redemption Sync · Pass Walkup Scanning Sync
Développé par	Ventrata (via visitBerlin Ticket Gateway API)

Cette connexion vous permet de :

Scannez ou saisissez un code de billet Berlin WelcomeCard dans Ventrata et vérifiez-le auprès de Berlin WelcomeCard en temps réel.
Créez automatiquement une réservation dans Ventrata pour chaque billet valide.
Enregistrez l'entrée auprès de Berlin WelcomeCard au moment du scan, afin que le billet soit marqué comme utilisé.

Fonctionnement

Le personnel scanne ou saisit un code de billet WelcomeCard dans Ventrata : dans la recherche de commandes du Backoffice, sur un scanner ou un terminal Ventrata, ou via l'API OCTO de validation/enregistrement de Ventrata.
Ventrata ne traite comme billets WelcomeCard que les codes qui commencent par « TE » suivi d'au moins 12 caractères. Les autres codes sont laissés à vos autres connexions.
Si le billet a déjà été réservé pour ce revendeur, Ventrata renvoie la réservation existante.
Sinon, Ventrata envoie à Berlin WelcomeCard un scan en mode consultation uniquement pour vérifier le billet et trouver sa variante de produit.
Ventrata enregistre ensuite un scan d'entrée auprès de Berlin WelcomeCard, avec votre Entry Zone ID, votre Organization ID et l'heure actuelle.
Si Berlin WelcomeCard confirme la réussite, Ventrata enregistre une réservation à date ouverte pour 1 unité du produit, de l'option et de l'unité que vous avez mappés à cette variante.

📒 REMARQUE

Les codes de billet qui correspondent à « TE » suivi d'au moins 12 lettres ou chiffres (regex ^TE\w{12,}$). Tout autre code est ignoré par cette connexion.

Créer la connexion Berlin WelcomeCard

🔐 Autorisations de rôle requises : See Connections, Modify Connections

Avant de commencer :

Préparez vos identifiants API Berlin WelcomeCard : Username, Password, Product ID, Organization ID et Entry Zone ID.
Créez Berlin WelcomeCard en tant que revendeur dans Ventrata et sélectionnez-le sur la connexion. Le formulaire indique le champ Revendeur (Reseller) comme facultatif, mais il est nécessaire pour les recherches.

Créer la connexion

Sélectionnez votre revendeur Berlin WelcomeCard.
Saisissez le Username, le Password, le Product ID, l'Organization ID et l'Entry Zone ID.
Enregistrez. Ventrata se connecte, récupère le produit et ses variantes, et crée une ligne de mappage par variante.

Le formulaire de connexion comporte les options suivantes :

Reseller	Le revendeur sous lequel les réservations WelcomeCard sont enregistrées. Facultatif dans le formulaire, mais nécessaire en pratique pour les recherches.
Berlin Welcomecard Username / Password	Ventrata se connecte avec ces identifiants lorsque vous enregistrez. Si la connexion échoue, les deux champs sont signalés comme non valides.
Berlin Welcomecard Product ID	Le produit WelcomeCard dont Ventrata charge les variantes pour le mappage. Si le produit est introuvable, le champ est signalé comme non valide.
Berlin Welcomecard Organization ID	Envoyé avec chaque scan d'entrée. Non vérifié lors de l'enregistrement.
Berlin Welcomecard Entry Zone ID	La zone d'entrée à laquelle chaque scan est rattaché. Non vérifiée lors de l'enregistrement ; une valeur erronée n'apparaît qu'au moment du scan.

Mapper les produits

Lorsque vous enregistrez la connexion, Ventrata crée une ligne par variante du produit WelcomeCard configuré. Les variantes qui n'existent plus sont supprimées. Si un billet scanné appartient à une variante qui n'a pas encore de ligne, Ventrata ajoute la ligne au moment du scan.

Ouvrez la connexion et sélectionnez chaque ligne de variante.
Choisissez le produit, l'option et l'unité Ventrata à réserver pour cette variante. L'option et l'unité sont obligatoires.
Enregistrez à nouveau la connexion chaque fois que les variantes WelcomeCard changent. Les lignes ne sont actualisées qu'à l'enregistrement.

📒 REMARQUE

Un billet d'une variante non mappée échoue avec « is not mapped in <connection> » tant que vous ne l'avez pas mappée.

Redemption

Immédiatement : toujours. Le scan d'entrée est enregistré auprès de Berlin WelcomeCard au moment du scan, et la réservation n'est enregistrée que si le fournisseur signale une réussite.
À la validation ou en cas de non-présentation : non pris en charge. Les options Redeem on Redemption/Upgrade et Redeem on No-show n'apparaissent pas pour cette connexion.
Ce qui est envoyé à Berlin WelcomeCard : un événement de scan d'entrée (scanEventCreate, kind entry) avec votre zone d'entrée, votre organisation, l'heure actuelle et le nom d'appareil « Ventrata ».

Fonctionnalités de la connexion en détail

Cette section s'adresse à ceux qui veulent les détails. Cliquez sur une ligne pour voir comment fonctionne chaque fonctionnalité.

Product Mapping	✅	Vous mappez chaque offre de pass Berlin WelcomeCard à un produit Ventrata dans le Ventrata Dashboard. Lorsque vous enregistrez la connexion, Ventrata crée une ligne par variante du produit WelcomeCard configuré. Les variantes qui n'existent plus sont supprimées. Si un billet scanné appartient à une variante qui n'a pas encore de ligne, Ventrata ajoute la ligne au moment du scan. Un billet d'une variante non mappée échoue avec « is not mapped in <connection> » tant que vous ne l'avez pas mappée.
Content Sync	❌	Le contenu des produits n'est pas synchronisé. Berlin WelcomeCard vend son propre pass. Vos produits et leur contenu restent dans Ventrata.
Availability Sync	❌	Vos disponibilités ne sont pas partagées avec Berlin WelcomeCard. Il n'y a aucun échange de disponibilités ni de capacité avec Berlin WelcomeCard.
Pricing Sync	❌	Les prix ne sont pas synchronisés avec Berlin WelcomeCard. La réservation utilise le prix unitaire de votre unité Ventrata et est réglée par bon : le solde de la commande est donc nul. Aucun prix n'est envoyé à Berlin WelcomeCard.
Promotions Sync	❌	Les promotions ne s'appliquent pas aux pass Berlin WelcomeCard. Vos promotions Ventrata ne s'appliquent pas aux réservations créées en scannant un pass.
Bookings Sync	✅ / ❌	Limité : les réservations ne sont créées que lorsqu'un pass est scanné. Une réservation à date ouverte par billet, avec une quantité de 1 pour l'unité mappée, créée au moment du scan du billet. La référence revendeur est le code du billet sans son préfixe « TE ». Les contrôles client, questions, transport et accompagnant sont ignorés. Scanner à nouveau le même billet renvoie la réservation existante. Il n'y a pas d'appel d'annulation vers Berlin WelcomeCard. Un scan enregistré ne peut pas être annulé depuis Ventrata.
Pickups/Dropoff Sync	❌	Ne fait pas partie de cette connexion. Les validations de pass ne comportent pas de prise en charge.
Custom Questions Sync	❌	Ne fait pas partie de cette connexion. Les questions de réservation ne sont ni posées ni envoyées pour les validations de pass.
Extras Sync	❌	Ne fait pas partie de cette connexion. Aucun extra ne peut être ajouté à une validation de pass.
Redemption Sync	✅	Les validations sont envoyées à Berlin WelcomeCard. Toujours. Le scan d'entrée est enregistré auprès de Berlin WelcomeCard au moment du scan, et la réservation n'est enregistrée que si le fournisseur signale une réussite. Non pris en charge. Les options Redeem on Redemption/Upgrade et Redeem on No-show n'apparaissent pas pour cette connexion. Un événement de scan d'entrée (scanEventCreate, kind entry) avec votre zone d'entrée, votre organisation, l'heure actuelle et le nom d'appareil « Ventrata ».
Pass Walkup Scanning Sync	✅	Vous scannez les pass Berlin WelcomeCard à votre entrée. Le personnel scanne ou saisit un code de billet WelcomeCard dans Ventrata : dans la recherche de commandes du Backoffice, sur un scanner ou un terminal Ventrata, ou via l'API OCTO de validation/enregistrement de Ventrata. Ventrata ne traite comme billets WelcomeCard que les codes qui commencent par « TE » suivi d'au moins 12 caractères. Les autres codes sont laissés à vos autres connexions. Si le billet a déjà été réservé pour ce revendeur, Ventrata renvoie la réservation existante.
Gift Card Sync	❌	Ne fait pas partie de cette connexion. Les pass Berlin WelcomeCard ne sont pas des cartes cadeaux Ventrata.

✅ pris en charge · ✅ / ❌ limité · ❌ non pris en charge

Bon à savoir : limites de cette connexion

Un seul Product ID WelcomeCard par connexion. Pour accepter plusieurs produits WelcomeCard, il vous faudra probablement une connexion par produit.
Les mappages ne sont actualisés que lorsque vous enregistrez à nouveau la connexion.
La validation ne peut pas être différée à l'admission ou à la non-présentation.
Pas de prise en charge, d'extras, de questions personnalisées ni de ressources.
Les résultats de recherche sont mis en cache pendant 5 minutes. Si Berlin WelcomeCard ne répond pas dans un délai d'environ 12 secondes, le code est considéré comme introuvable.

Dépannage

« %{title} is not mapped in %{connection} »

Aucun produit, option ni unité Ventrata n'est mappé à la variante du billet. Mappez la ligne de variante sur la connexion, puis scannez à nouveau.

« Redemption not allowed »