Berlin WelcomeCard ist das offizielle Touristenticket Berlins, herausgegeben von der Tourismusorganisation visitBerlin und mehr als 15 Millionen Mal verkauft. Es kombiniert unbegrenzte Nutzung des öffentlichen Nahverkehrs in den Zonen AB oder ABC mit Rabatten bei mehr als 170 Attraktionen; Upgrades fügen den Eintritt zur Museumsinsel oder freien Eintritt zu über 25 Attraktionen hinzu. Attraktionen bringt es Erst- und Wiederholungsbesucher aus Deutschland und dem Ausland, die die Karte online oder an Verkaufsstellen kaufen und ihr Sightseeing danach planen. Diese Verbindung wird von Public Ticket Solution entwickelt und verwaltet.

Wenn Sie Berlin WelcomeCard mit Ventrata verbinden, können Sie Pässe von Berlin WelcomeCard an Ihrem Eingang scannen, validieren und einlösen – an Drehkreuzen, Kiosken und Kassenterminals mit Ventrata, in der mobilen App oder im Ventrata Dashboard, ohne separate App von Berlin WelcomeCard.

Weitere Informationen zu Berlin WelcomeCard finden Sie unter berlin-welcomecard.de.

Hauptwebsite	berlin-welcomecard.de
Tags	Destination Organization (DMO) · Multi-Attraction Pass
Verbindungstyp	Pass-Einlösung: Sie scannen Pässe von Berlin WelcomeCard an Ihrem Eingang
Verbindungsfunktionen	Product Mapping · Redemption Sync · Pass Walkup Scanning Sync
Entwickelt von	Ventrata (über die visitBerlin Ticket Gateway API)

Mit dieser Verbindung können Sie:

Scannen oder tippen Sie einen Ticketcode von Berlin WelcomeCard in Ventrata ein und prüfen Sie ihn in Echtzeit bei Berlin WelcomeCard.
Legen Sie für jedes gültige Ticket automatisch eine Buchung in Ventrata an.
Erfassen Sie den Eintritt beim Scannen bei Berlin WelcomeCard, damit das Ticket als verwendet markiert wird.

So funktioniert es

Mitarbeitende scannen oder tippen einen WelcomeCard-Ticketcode in Ventrata ein: in der Bestellsuche im Backoffice, auf einem Ventrata-Scanner oder -Terminal oder über die OCTO-Einlösungs-/Check-in-API von Ventrata.
Ventrata behandelt nur Codes, die mit „TE“ beginnen und auf die mindestens 12 Zeichen folgen, als WelcomeCard-Tickets. Andere Codes bleiben Ihren anderen Verbindungen überlassen.
Wurde das Ticket für diesen Wiederverkäufer bereits gebucht, gibt Ventrata die bestehende Buchung zurück.
Andernfalls sendet Ventrata einen reinen Abfrage-Scan an Berlin WelcomeCard, um das Ticket zu prüfen und seine Produktvariante zu ermitteln.
Anschließend erfasst Ventrata einen Eintritts-Scan bei Berlin WelcomeCard mit Ihrer Entry Zone ID, Ihrer Organization ID und der aktuellen Uhrzeit.
Bestätigt Berlin WelcomeCard den Erfolg, speichert Ventrata eine Buchung ohne festes Datum für 1 Einheit des Produkts, der Option und der Einheit, die Sie dieser Variante zugeordnet haben.

📒 HINWEIS

Ticketcodes, die „TE“ gefolgt von mindestens 12 Buchstaben oder Ziffern entsprechen (Regex ^TE\w{12,}$). Alle anderen Codes werden von dieser Verbindung ignoriert.

Verbindung mit Berlin WelcomeCard erstellen

🔐 Erforderliche Rollenberechtigungen: See Connections, Modify Connections

Bevor Sie beginnen:

Halten Sie Ihre API-Zugangsdaten für Berlin WelcomeCard bereit: Username, Password, Product ID, Organization ID und Entry Zone ID.
Legen Sie Berlin WelcomeCard in Ventrata als Wiederverkäufer an und wählen Sie Berlin WelcomeCard in der Verbindung aus. Im Formular ist das Feld „Reseller“ als optional markiert, für Abfragen wird es jedoch benötigt.

Verbindung erstellen

Wählen Sie Ihren Wiederverkäufer Berlin WelcomeCard aus.
Geben Sie Username, Password, Product ID, Organization ID und Entry Zone ID ein.
Speichern Sie. Ventrata meldet sich an, ruft das Produkt und seine Varianten ab und legt pro Variante eine Zuordnungszeile an.

Das Verbindungsformular bietet folgende Optionen:

Reseller	Der Wiederverkäufer, unter dem WelcomeCard-Buchungen erfasst werden. Im Formular optional, in der Praxis aber für die Suche erforderlich.
Berlin Welcomecard Username / Password	Ventrata meldet sich beim Speichern mit diesen Daten an. Schlägt die Anmeldung fehl, werden beide Felder als ungültig markiert.
Berlin Welcomecard Product ID	Das WelcomeCard-Produkt, dessen Varianten Ventrata zur Zuordnung lädt. Wird das Produkt nicht gefunden, wird das Feld als ungültig markiert.
Berlin Welcomecard Organization ID	Wird mit jedem Eintritts-Scan gesendet. Beim Speichern nicht geprüft.
Berlin Welcomecard Entry Zone ID	Die Eintrittszone, für die jeder Scan erfasst wird. Beim Speichern nicht geprüft; ein falscher Wert fällt erst beim Scannen auf.

Produkte zuordnen

Wenn Sie die Verbindung speichern, legt Ventrata pro Variante des konfigurierten WelcomeCard-Produkts eine Zeile an. Varianten, die nicht mehr existieren, werden entfernt. Gehört ein gescanntes Ticket zu einer Variante, für die es noch keine Zeile gibt, fügt Ventrata die Zeile beim Scannen hinzu.

Öffnen Sie die Verbindung und wählen Sie jede Variantenzeile aus.
Wählen Sie das Ventrata-Produkt, die Option und die Einheit, die für diese Variante gebucht werden sollen. Option und Einheit sind Pflichtangaben.
Speichern Sie die Verbindung erneut, wenn sich die WelcomeCard-Varianten ändern. Die Zeilen werden nur beim Speichern aktualisiert.

📒 HINWEIS

Ein Ticket für eine nicht zugeordnete Variante schlägt mit „ is not mapped in <connection>“ fehl, bis Sie sie zuordnen.

Redemption

Sofort: Immer. Der Eintritts-Scan wird beim Scannen bei Berlin WelcomeCard erfasst, und die Buchung wird nur gespeichert, wenn der Anbieter Erfolg meldet.
Bei Einlösung oder Nichterscheinen: Nicht unterstützt. Die Optionen „Einlösen bei Einlösung/Upgrade“ (Redeem on Redemption/Upgrade) und „Einlösen bei Nichterscheinen“ (Redeem on No-show) werden für diese Verbindung nicht angezeigt.
Was an Berlin WelcomeCard gesendet wird: Ein Eintritts-Scan-Ereignis (scanEventCreate, kind entry) mit Ihrer Eintrittszone, Ihrer Organisation, der aktuellen Uhrzeit und dem Gerätenamen „Ventrata“.

Verbindungsfunktionen im Detail

Dieser Abschnitt richtet sich an alle, die es genau wissen möchten. Klicken Sie auf eine Zeile, um zu sehen, wie die jeweilige Funktion funktioniert.

Product Mapping	✅	Sie ordnen jedes Pass-Angebot von Berlin WelcomeCard im Ventrata Dashboard einem Ventrata-Produkt zu. Wenn Sie die Verbindung speichern, legt Ventrata pro Variante des konfigurierten WelcomeCard-Produkts eine Zeile an. Varianten, die nicht mehr existieren, werden entfernt. Gehört ein gescanntes Ticket zu einer Variante, für die es noch keine Zeile gibt, fügt Ventrata die Zeile beim Scannen hinzu. Ein Ticket für eine nicht zugeordnete Variante schlägt mit „ is not mapped in <connection>“ fehl, bis Sie sie zuordnen.
Content Sync	❌	Produktinhalte werden nicht synchronisiert. Berlin WelcomeCard verkauft einen eigenen Pass. Ihre Produkte und deren Inhalte bleiben in Ventrata.
Availability Sync	❌	Ihre Verfügbarkeit wird nicht mit Berlin WelcomeCard geteilt. Es findet kein Austausch von Verfügbarkeit oder Kapazität mit Berlin WelcomeCard statt.
Pricing Sync	❌	Preise werden nicht mit Berlin WelcomeCard synchronisiert. Die Buchung verwendet Ihren Ventrata-Einheitspreis und wird per Voucher beglichen, sodass die Bestellung auf null ausgeglichen ist. An Berlin WelcomeCard wird kein Preis gesendet.
Promotions Sync	❌	Werbeaktionen gelten nicht für Pässe von Berlin WelcomeCard. Ihre Ventrata-Werbeaktionen gelten nicht für Buchungen, die durch das Scannen eines Passes entstehen.
Bookings Sync	✅ / ❌	Eingeschränkt: Buchungen werden nur angelegt, wenn ein Pass gescannt wird. Eine Buchung ohne festes Datum pro Ticket, mit Menge 1 der zugeordneten Einheit, angelegt beim Scannen des Tickets. Die Wiederverkäufer-Referenz ist der Ticketcode ohne das Präfix „TE“. Prüfungen von Kunden, Fragen, Transport und Begleitpersonen werden übersprungen. Ein erneuter Scan desselben Tickets gibt die bestehende Buchung zurück. Es gibt keinen Stornierungsaufruf an Berlin WelcomeCard. Ein erfasster Scan kann in Ventrata nicht rückgängig gemacht werden.
Pickups/Dropoff Sync	❌	Nicht Teil dieser Verbindung. Pass-Einlösungen enthalten keine Abholungen.
Custom Questions Sync	❌	Nicht Teil dieser Verbindung. Bei Pass-Einlösungen werden keine Buchungsfragen gestellt oder gesendet.
Extras Sync	❌	Nicht Teil dieser Verbindung. Zu einer Pass-Einlösung können keine Extras hinzugefügt werden.
Redemption Sync	✅	Einlösungen werden an Berlin WelcomeCard gesendet. Immer. Der Eintritts-Scan wird beim Scannen bei Berlin WelcomeCard erfasst, und die Buchung wird nur gespeichert, wenn der Anbieter Erfolg meldet. Nicht unterstützt. Die Optionen „Einlösen bei Einlösung/Upgrade“ (Redeem on Redemption/Upgrade) und „Einlösen bei Nichterscheinen“ (Redeem on No-show) werden für diese Verbindung nicht angezeigt. Ein Eintritts-Scan-Ereignis (scanEventCreate, kind entry) mit Ihrer Eintrittszone, Ihrer Organisation, der aktuellen Uhrzeit und dem Gerätenamen „Ventrata“.
Pass Walkup Scanning Sync	✅	Sie scannen Pässe von Berlin WelcomeCard an Ihrem Eingang. Mitarbeitende scannen oder tippen einen WelcomeCard-Ticketcode in Ventrata ein: in der Bestellsuche im Backoffice, auf einem Ventrata-Scanner oder -Terminal oder über die OCTO-Einlösungs-/Check-in-API von Ventrata. Ventrata behandelt nur Codes, die mit „TE“ beginnen und auf die mindestens 12 Zeichen folgen, als WelcomeCard-Tickets. Andere Codes bleiben Ihren anderen Verbindungen überlassen. Wurde das Ticket für diesen Wiederverkäufer bereits gebucht, gibt Ventrata die bestehende Buchung zurück.
Gift Card Sync	❌	Nicht Teil dieser Verbindung. Pässe von Berlin WelcomeCard sind keine Ventrata-Geschenkkarten.

✅ unterstützt · ✅ / ❌ eingeschränkt · ❌ nicht unterstützt

Gut zu wissen: Einschränkungen dieser Verbindung

Eine WelcomeCard Product ID pro Verbindung. Um mehrere WelcomeCard-Produkte zu akzeptieren, benötigen Sie voraussichtlich eine Verbindung pro Produkt.
Zuordnungen werden nur aktualisiert, wenn Sie die Verbindung erneut speichern.
Die Einlösung kann nicht auf den Einlass oder das Nichterscheinen verschoben werden.
Keine Abholungen, Extras, benutzerdefinierten Fragen oder Ressourcen.
Suchergebnisse werden 5 Minuten lang zwischengespeichert. Antwortet Berlin WelcomeCard nicht innerhalb von etwa 12 Sekunden, gilt der Code als nicht gefunden.

Fehlerbehebung

„%{title} is not mapped in %{connection}“

Der Variante des Tickets ist kein Ventrata-Produkt, keine Option und keine Einheit zugeordnet. Ordnen Sie die Variantenzeile in der Verbindung zu und scannen Sie dann erneut.

„Redemption not allowed“