Zum Hauptinhalt springen

CityPASS: Betreiber-Backend

Verbinden Sie CityPASS mit Ventrata, um Produkte von Betreibern, die CityPASS nutzen, mit Live-Verfügbarkeit und Buchungen weiterzuverkaufen. Vergünstigte City-Pässe für mehrere Attraktionen.

CityPASS logo

 

CityPASS betreibt ein Affiliate- und Reisebranchenprogramm rund um den eigenen Multi-Attraktions-Pass, der seit 1997 verkauft wird und den Eintritt zu bekannten Attraktionen in 17 großen Städten der USA und Kanadas zu einem festen, vergünstigten Preis bündelt. Das Programm bietet dieses Angebot über nachverfolgte Affiliate-Links und Branchenkonten auch Publishern, Reisebüros, Reiseveranstaltern, Hotels und Destinationsmarketing-Organisationen an und bringt den Passverkauf so zu Besuchern, die bereits eine Städtereise planen – von Alleinreisenden bis zu Familien und Gruppen.

 

Wenn Sie CityPASS mit Ventrata verbinden, können Sie Produkte von Betreibern weiterverkaufen, die CityPASS als Buchungssystem nutzen. Ventrata liest deren Live-Verfügbarkeit aus CityPASS, und jede Buchung, die Sie entgegennehmen, wird direkt im Konto des Betreibers bei CityPASS angelegt.

 

Weitere Informationen zu CityPASS finden Sie unter citypass.com.

 

📒 HINWEIS

Möchten Sie stattdessen Tickets von CityPASS an Ihrem eigenen Eingang scannen und einlösen? Siehe CityPASS: Reseller Connection.

 

📗 TIPP

Nehmen Sie nach der Zuordnung eine Testbuchung vor und bitten Sie CityPASS Affiliates & Travel Trade, den Eingang der Buchung im eigenen System zu bestätigen.

 

Hauptwebsite

Tags

Custom / Proprietary Operator System

Verbindungsfunktionen

Availability Sync · Bookings Sync

Entwickelt von

Ventrata (über CityPASS API)

 

Mit dieser Betreiber-Verbindung (auch Backend genannt) können Sie Produkte von Betreibern weiterverkaufen, die CityPASS als primäres Buchungssystem nutzen. Jede Buchung wird direkt in CityPASS angelegt. Zu den Funktionen dieser Verbindung gehören:

  • Availability Sync – die Live-Verfügbarkeit stammt aus dem Konto des Betreibers bei CityPASS.

  • Bookings Sync – Buchungen werden von Ventrata an CityPASS übermittelt, und CityPASS stellt die Tickets oder Voucher aus.

 

Die externe API von CityPASS, die für diese Verbindung verwendet wird, ist eine individuelle API, die nicht dem OCTO API-Standard entspricht. Dadurch können bestimmte Funktionen und Möglichkeiten eingeschränkt sein.

 

Verbindung mit CityPASS erstellen

🔐 Erforderliche Rollenberechtigungen: See Operators, Modify Operators, See Products, Modify Products

Bevor Sie beginnen:

  • Sie benötigen eine Handelsvereinbarung mit dem Betreiber über dessen Tarife und Konditionen.

  • Sie benötigen den CityPASS User und das CityPASS Password für den Betreiber. Siehe die folgenden Schritte.

  • Sie müssen die Produkte des Betreibers in Ventrata neu anlegen. Siehe Produkte erstellen. Die Verbindung synchronisiert Verfügbarkeit, Preise und Buchungen, legt aber keine Produkte in Ventrata an.

 

Schritt 1: Betreiber in Ventrata konfigurieren

Kontaktieren Sie CityPASS Affiliates & Travel Trade und fragen Sie an, ob Sie die Produkte über Ventrata weiterverkaufen dürfen.

 

  1. Gehen Sie im Ventrata Dashboard zu Produkte → Betreiber (Products → Operators) und öffnen Sie den Betreiber. Falls er noch nicht existiert, legen Sie ihn zuerst als Betreiber an.

  2. Wählen Sie im Abschnitt Backend-Partner (Backend Partner) CityPASS aus und geben Sie den CityPASS User und das CityPASS Password ein.

  3. Geben Sie im Abschnitt „Backend-Partner“ (Backend Partner) die Zugangsdaten ein, die Sie von CityPASS Affiliates & Travel Trade erhalten haben.

  4. Press Update Operator.

 

 

 

Schritt 2: Jedes Produkt verbinden

  1. Öffnen Sie das Produkt des Betreibers unter Produkte → Produkte (Products → Products) und bearbeiten Sie es. Prüfen Sie, ob Betreiber (Operator) auf diesen Betreiber gesetzt ist.

  2. Aktivieren Sie Backend verbunden (Backend Connected). Aktivieren Sie Backend-Verfügbarkeit (Backend Availability), um die Verfügbarkeit aus CityPASS zu verwenden.

  3. Press Update Product.

 

Aktivieren Sie „Backend verbunden“ (Backend Connected). Aktivieren Sie außerdem „Backend-Verfügbarkeit“, um die Verfügbarkeit abzurufen, und „Backend-Preisgestaltung“, um die Preise abzurufen. Ohne diese Optionen verwendet das Produkt die in Ventrata festgelegte Verfügbarkeit und die dort festgelegten Preise, sendet Buchungen aber weiterhin an CityPASS.

 

 

Produkte zu CityPASS zuordnen

‼️ WICHTIG

Über die Zuordnung erfährt Ventrata, für welches Produkt, welche Option und welche Einheiten in CityPASS die Verfügbarkeit geprüft und gebucht werden soll. Ist ein mit dem Backend verbundenes Produkt nicht korrekt zugeordnet, schlagen seine Buchungen fehl. Eine rote Markierung über die gesamte Produktzeile zeigt ein falsch zugeordnetes Produkt an.

 

  1. Gehen Sie im Ventrata Dashboard zu Produkte → Produkte (Products → Products) und öffnen Sie das Produkt.

  2. Öffnen Sie den Tab Zuordnungen (Mappings). Er wird angezeigt, sobald das Produkt auf Backend verbunden (Backend Connected) gesetzt ist.

  3. Wählen Sie für jede Ventrata-Option und -Einheit in den Dropdown-Menüs, die Ventrata aus CityPASS lädt, das passende Produkt, die passende Option und die passenden Einheiten in CityPASS aus. Lassen Sie kein Feld leer.

  4. Press Save Changes.

 

📗 TIPP

Nehmen Sie nach der Zuordnung eine Testbuchung vor und bitten Sie den Betreiber zu bestätigen, dass sie in seinem Konto bei CityPASS angekommen ist.

 

Verbindung mit CityPASS verwalten

  • Aktualisieren Sie die Zuordnung, wenn der Betreiber Produkte, Optionen oder Einheiten in CityPASS ändert.

  • Ersetzen Sie den Schlüssel beim Betreiber, wenn CityPASS oder der Betreiber einen neuen ausstellt.

  • Deaktivieren Sie Backend-Verfügbarkeit oder Backend-Preisgestaltung bei einem Produkt, um stattdessen die eigene Verfügbarkeit oder die eigenen Preise von Ventrata zu verwenden. Buchungen werden weiterhin an CityPASS übermittelt.

 

Verbindungsfunktionen im Detail

Dieser Abschnitt richtet sich an alle, die genau wissen möchten, wie die Verbindung mit CityPASS funktioniert. Die Richtung ist hier umgekehrt wie bei einer Wiederverkäufer-Verbindung: Ventrata ruft CityPASS auf, und zwar über die CityPASS API. Für jede Funktion wird erklärt, welche Aufrufe Ventrata wann ausführt und was das für Sie bedeutet.

 

Kurz gesagt: Ventrata fragt bei CityPASS die Verfügbarkeit ab, sobald jemand ein mit dem Backend verbundenes Produkt aufruft, und legt jede Buchung im Konto des Betreibers bei CityPASS an. CityPASS meldet keine Änderungen an Ventrata zurück.

 

Die Zeitangaben sind für CityPASS typisch, gerundet und können sich ändern.

 

Product Mapping

✅

Sie ordnen jedes Ventrata-Produkt, jede Option und jede Einheit im Ventrata Dashboard dem Produkt des Betreibers in CityPASS zu.

Das funktioniert wie folgt:

  • Produkte – Ventrata liest die Produkte, Optionen und Einheiten des Betreibers in CityPASS, um die Dropdown-Menüs auf dem Tab Zuordnungen (Mappings) zu füllen.

 

Was das für Sie bedeutet: Wenn etwas im Dropdown-Menü fehlt, hat der Betreiber es Ihnen in CityPASS nicht freigegeben. Bitten Sie ihn darum.

Content Sync

❌

Ventrata importiert keine Produktinhalte aus CityPASS.

Ventrata importiert keine Produktinhalte aus CityPASS. Sie legen die Produkte selbst in Ventrata an und beschreiben sie.

Availability Sync

✅

Bei aktivierter Backend-Verfügbarkeit prüft Ventrata die Live-Verfügbarkeit des Betreibers in CityPASS.

Das funktioniert wie folgt:

  • Verfügbarkeit – Wenn jemand den Verfügbarkeitskalender in Ventrata nutzt, zum Beispiel im Dashboard, in Ihrem Web Checkout oder an einem Terminal, fragt Ventrata bei CityPASS live die angezeigten Daten ab.

  • Synchronisiert die Verfügbarkeit aus CityPASS (keine weiteren Angaben).

 

Was das für Sie bedeutet: Kunden buchen auf Basis der Live-Verfügbarkeit des Betreibers in CityPASS. So können Sie keinen Zeitslot überverkaufen, den der Betreiber bereits anderweitig verkauft hat.

Pricing Sync

❌

Ventrata liest keine Preise aus CityPASS.

Ventrata liest keine Preise aus CityPASS. Die Produkte verwenden die Preise, die Sie in Ventrata festgelegt haben, und Buchungen werden weiterhin an CityPASS übermittelt.

Promotions Sync

❌

Werbeaktionen werden nicht an CityPASS übermittelt.

Werbeaktionen werden nicht an CityPASS übermittelt. Ihre Ventrata-Werbeaktionen gelten weiterhin für den Preis, den Ihr Kunde in Ventrata bezahlt.

Bookings Sync

✅

Buchungen, die in Ventrata für ein mit dem Backend verbundenes Produkt vorgenommen werden, werden im Konto des Betreibers bei CityPASS angelegt.

Das funktioniert wie folgt:

  1. Reservieren und bestätigen: Wenn das Produkt in den Warenkorb gelegt wird, prüft Ventrata die Buchung bei CityPASS. Nach der Zahlung legt Ventrata die Buchung mit den Kundendaten im Konto des Betreibers bei CityPASS an.

  2. Tickets: Die Referenz oder die Tickets, die CityPASS zurückgibt, werden in der Ventrata-Buchung gespeichert.

Sendet Buchungen, Änderungen und Stornierungen von Ventrata an CityPASS.

 

‼️ WICHTIG – Buchungen werden nur in eine Richtung synchronisiert, von Ventrata zu CityPASS. Wenn der Betreiber eine Buchung in CityPASS ändert oder storniert, wird Ventrata nicht benachrichtigt. Bitten Sie den Betreiber, Sie über alle Änderungen zu informieren.

Pickups/Dropoff Sync

❌

Angaben zu Abholung und Absetzen werden nicht an CityPASS übermittelt.

Angaben zu Abholung und Absetzen werden nicht an CityPASS übermittelt. Teilen Sie sie dem Betreiber auf anderem Weg mit, wenn ein Produkt sie benötigt.

Custom Questions Sync

❌

Antworten auf Ihre Buchungsfragen werden nicht an CityPASS übermittelt.

Antworten auf Ihre Buchungsfragen werden nicht an CityPASS übermittelt. Teilen Sie sie dem Betreiber auf anderem Weg mit, wenn er sie benötigt.

Extras Sync

❌

Extras und Zusatzleistungen werden nicht in CityPASS gebucht.

Extras und Zusatzleistungen werden nicht in CityPASS gebucht. Gebucht werden nur das Hauptprodukt, die Option und die Einheiten.

Redemption Sync

❌

Einlösungen und andere Statusänderungen in CityPASS werden nach der Bestätigung einer Buchung nicht an Ventrata zurückgemeldet.

Einlösungen und andere Statusänderungen in CityPASS werden nach der Bestätigung einer Buchung nicht an Ventrata zurückgemeldet.

Pass Walkup Scanning Sync

❌

Das Scannen von Pässen bei Laufkunden ist mit CityPASS nicht verfügbar.

Das Scannen von Pässen bei Laufkunden ist mit CityPASS nicht verfügbar.

Gift Card Sync

❌

Ventrata-Geschenkkarten werden nicht an CityPASS übermittelt.

Ventrata-Geschenkkarten werden nicht an CityPASS übermittelt. Zahlungen mit Geschenkkarten verbleiben in Ventrata.

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Verbindung mit CityPASS

  • Live-Verfügbarkeit: Die Verfügbarkeit wird aus CityPASS abgerufen, während Kunden das Angebot durchsuchen.

  • Buchungen in eine Richtung: Änderungen, die der Betreiber in CityPASS vornimmt, erreichen Ventrata nicht.

  • Individuelle API: Die API von CityPASS ist keine OCTO API, daher können einige Funktionen im Vergleich zu OCTO-Backends eingeschränkt sein.

  • CityPASS ist ein Anbieter von Multi-Attraktions-Pässen für siebzehn große Städte in den USA und Kanada; das Affiliate- und Reisebranchenprogramm des Unternehmens bietet das Angebot auch Publishern, Agenturen, Reiseveranstaltern, Hotels und Destinationsmarketing-Organisationen an.

 

FAQ

Beim Speichern der Backend-Konfiguration des Betreibers erhalte ich eine Fehlermeldung.

Höchstwahrscheinlich sind der CityPASS User und das CityPASS Password oder der Endpunkt falsch. Klären Sie dies mit Ihrem Betreiber ab. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

In den Produkteinstellungen gibt es kein Kontrollkästchen „Backend verbunden“ (Backend Connected).

Für den beim Produkt festgelegten Betreiber ist höchstwahrscheinlich kein Backend konfiguriert. Prüfen Sie die Einstellungen unter „Backend-Partner“ (Backend Partner) beim Betreiber und versuchen Sie es erneut. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

Das Produkt, die Option oder die Einheit, die ich zuordnen möchte, ist nicht im Dropdown-Menü enthalten.

Die Dropdown-Menüs zeigen, was der Betreiber Ihnen in CityPASS freigegeben hat. Fragen Sie beim Betreiber nach. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

Buchungen für ein mit dem Backend verbundenes Produkt schlagen fehl.

Prüfen Sie zuerst die Zuordnung des Produkts: Jede Option und jede Einheit muss zugeordnet sein. Prüfen Sie dann, ob der Zeitslot in CityPASS noch verfügbar ist. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

Beim Speichern der Backend-Konfiguration des Betreibers erhalte ich eine Fehlermeldung.

Höchstwahrscheinlich sind die Zugangsdaten falsch. Klären Sie dies mit CityPASS Affiliates & Travel Trade ab. Besteht das Problem weiterhin, wenden Sie sich an den technischen Support.

In den Produkteinstellungen gibt es kein Kontrollkästchen „Backend verbunden“ (Backend Connected).

Für den beim Produkt ausgewählten Betreiber ist höchstwahrscheinlich kein Backend konfiguriert. Prüfen Sie die Backend-Konfiguration des Betreibers und versuchen Sie es erneut.

 

Nützliche Ressourcen

 

 

Partnerinformationen

City Pass, Inc.

 

Ventrata-Partner-ID: 433aac31-5f98-4ad2-908e-6bc068366e02

Hat dies deine Frage beantwortet?