Zum Hauptinhalt springen

Rotterdampas: Wiederverkäufer-Verbindung

Pässe von Rotterdampas mit Ventrata an Ihrem Eingang scannen, validieren und einlösen sowie die Verbindung einrichten und zuordnen.

Rotterdampas logo

 

Rotterdampas ist der offizielle Jahres-Rabattpass für den Großraum Rotterdam, ausgegeben für Einwohner und Studierende, mit freiem oder ermäßigtem Eintritt in Hunderte Kultur-, Freizeit-, Sport- und Familieneinrichtungen. Betreibern bringt Rotterdampas ein lokales und inländisches Publikum – rund 170.000 Passinhaber pro Jahr, die wiederholt und außerhalb der Spitzenzeiten kommen –, wobei Museen, Attraktionen und Familienaktivitäten die wichtigsten Einlösungen sind. Rotterdampas nutzt Intersolve als primäres Ticketingsystem.

 

Wenn Sie Rotterdampas mit Ventrata verbinden, können Sie Pässe von Rotterdampas 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 Rotterdampas.

 

Weitere Informationen zu Rotterdampas finden Sie unter rotterdampas.nl.

 

📒 HINWEIS

Rotterdampas läuft auf Intersolve. Siehe Intersolve: Wiederverkäufer-Verbindung.

 

Hauptwebsite

Tags

Multi-Attraction Pass

Verbindungstyp

Pass-Einlösung: Sie scannen Pässe von Rotterdampas an Ihrem Eingang

Verbindungsfunktionen

Product Mapping · Redemption Sync · Pass Walkup Scanning Sync

Entwickelt von

Ventrata (über die API von Rotterdampas)

 

Mit dieser Verbindung können Sie:

  • Eine Kartennummer von Rotterdampas scannen oder eingeben und die Voucher auf dieser Karte sehen, die in Ihrer Einrichtung gültig sind.

  • Für jeden nutzbaren Voucher automatisch eine Buchung in Ventrata anlegen, sodass ein einziger Scan für mehrere Voucher gelten kann.

  • Die Voucher-Nutzung bei Rotterdampas beim Scannen erfassen oder später, wenn der Besucher eingelassen oder als nicht erschienen markiert wird.

 

So funktioniert es

  1. Mitarbeitende scannen eine Kartennummer von Rotterdampas oder geben sie ein, optional gefolgt von #PIN.

  2. Ventrata fragt bei Rotterdampas (Intersolve) die auf diese Karte ausgestellten Voucher ab.

  3. Jeder nutzbare Voucher wird zu einem eigenen einlösbaren Code (/), sodass eine Karte mehrere Buchungen liefern kann.

  4. Voucher mit dem Status „Normal“ erhalten eine neue Buchung, oder die bestehende wird zurückgegeben. Bereits eingelöste Voucher („Redeemed“) liefern nur eine bestehende Ventrata-Buchung zurück.

  5. Ventrata legt für jeden Voucher eine Buchung ohne festes Datum an, mit dem Produkt, der Option und der Einheit, die Sie diesem Vouchertyp zugeordnet haben.

  6. Ventrata sendet für jedes Ticket „Redeem“ an Rotterdampas, je nach Ihren Einlöseeinstellungen sofort oder später.

📒 HINWEIS

Eine Kartennummer von Rotterdampas, optional gefolgt von #PIN. Entweder die kurze 1- bis 7-stellige Nummer (Ventrata ergänzt sie mit dem festen Präfix von Rotterdampas zur 19-stelligen Form) oder die vollständige Nummer mit Präfix.

 

Verbindung mit Rotterdampas erstellen

🔐 Erforderliche Rollenberechtigungen: See Connections, Modify Connections

 

Bevor Sie beginnen:

  • Halten Sie Ihren API-Benutzernamen (API User Name) und Ihr Passwort für Rotterdampas bereit.

  • Legen Sie Rotterdampas in Ventrata als Wiederverkäufer an, wenn Buchungen darunter erfasst werden sollen (das Feld „Reseller“ ist im Formular optional).

  • Halten Sie eine echte Karte von Rotterdampas mit Ihren Vouchern bereit. Vouchertypen erscheinen erst zur Zuordnung, nachdem eine Karte gescannt wurde.

 

Verbindung erstellen

  1. Wählen Sie Ihren Wiederverkäufer Rotterdampas aus (optional).

  2. Geben Sie den Benutzernamen (User Name) und das Passwort für Rotterdampas ein.

  3. Legen Sie fest, wann die Einlösung gesendet wird: Lassen Sie beide Optionen deaktiviert, um beim Scannen einzulösen, oder aktivieren Sie „Redeem on Redemption/Upgrade“ und/oder „Redeem on No-show“.

  4. Speichern Sie. Ventrata validiert die Zugangsdaten bei Rotterdampas.

 

 

Das Verbindungsformular bietet folgende Optionen:

Reseller

Der Wiederverkäufer, unter dem Buchungen von Rotterdampas erfasst werden. Im Formular optional.

Rotterdampas User Name / Password

Pflichtfeld. Ventrata prüft die Angaben mit einem Testaufruf, wenn Sie die Verbindung erstellen oder sie ändern; schlägt dieser fehl, werden beide Felder als ungültig markiert.

Redeem on Redemption/Upgrade

Die Einlösung an den verbundenen Anbieter senden, wenn die Buchung in Ventrata eingelöst wird.

Redeem on No-show

Die Einlösung an den verbundenen Anbieter senden, wenn die Buchung in Ventrata als nicht erschienen markiert wird, einschließlich automatischer No-shows.

 

Produkte zuordnen

Zeilen werden angelegt, wenn Ventrata zum ersten Mal einen Vouchertyp (VoucherId) auf einer gescannten Karte erkennt. Es gibt keine Liste, die vorab geladen werden kann.

  1. Scannen Sie eine Karte von Rotterdampas, die Ihren Voucher enthält.

  2. Öffnen Sie die Verbindung und suchen Sie die neue Zeile für diesen Vouchertyp.

  3. Wählen Sie das zu buchende Ventrata-Produkt, die Option und die Einheit. Option und Einheit sind Pflichtangaben.

  4. Scannen Sie die Karte erneut, um die Buchung anzulegen.

📒 HINWEIS

Eine Zeile gilt nur dann als zugeordnet, wenn das Produkt aktiv ist und Option und Einheit festgelegt und nicht verworfen sind.

📒 HINWEIS

Solange eine Zeile nicht zugeordnet ist, schlägt der Voucher mit „ is not mapped in <connection>“ fehl.

 

Redemption

  • Sofort: Standard (beide Optionen deaktiviert): Beim Scannen validiert Ventrata die Bestellung und sendet für jedes Ticket „Redeem“ an Rotterdampas.

  • Bei Einlösung oder Nichterscheinen: Wenn „Redeem on Redemption/Upgrade“ und/oder „Redeem on No-show“ aktiviert sind, wird die Buchung gespeichert, aber noch nicht bei Rotterdampas eingelöst. Ventrata sendet „Redeem“, wenn das Ticket in Ventrata eingelöst oder upgegradet oder als nicht erschienen markiert wird.

  • Was an Rotterdampas gesendet wird: Eine Redeem-Anfrage für den ausgestellten Voucher, mit dem Ticketpreis als TransactionAmount in Cent und einer festen Referenz pro Ticket, damit eine Wiederholung nicht doppelt einlöst.

 

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 Rotterdampas im Ventrata Dashboard einem Ventrata-Produkt zu.

Zeilen werden angelegt, wenn Ventrata zum ersten Mal einen Vouchertyp (VoucherId) auf einer gescannten Karte erkennt. Es gibt keine Liste, die vorab geladen werden kann.

Eine Zeile gilt nur dann als zugeordnet, wenn das Produkt aktiv ist und Option und Einheit festgelegt und nicht verworfen sind.

Solange eine Zeile nicht zugeordnet ist, schlägt der Voucher mit „ is not mapped in <connection>“ fehl.

Content Sync

❌

Produktinhalte werden nicht synchronisiert.

Rotterdampas verkauft einen eigenen Pass. Ihre Produkte und deren Inhalte bleiben in Ventrata.

Availability Sync

❌

Ihre Verfügbarkeit wird nicht mit Rotterdampas geteilt.

Es findet kein Austausch von Verfügbarkeit oder Kapazität mit Rotterdampas statt.

Pricing Sync

❌

Preise werden nicht mit Rotterdampas synchronisiert.

Die Buchung verwendet Ihren Ventrata-Einheitspreis und wird mit einer Voucher-Transaktion ausgeglichen. Bei der Einlösung sendet Ventrata den Ticketpreis als TransactionAmount in der kleinsten Währungseinheit (Cent) an Rotterdampas.

Promotions Sync

❌

Werbeaktionen gelten nicht für Pässe von Rotterdampas.

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 nutzbarem Voucher, sodass ein Scan mehrere Buchungen erzeugen kann. Voucher-IDs werden saisonübergreifend wiederverwendet. Ventrata ordnet daher nur eine frühere Buchung zu, die innerhalb des Gültigkeitszeitraums (valid-from/valid-until) des Vouchers mit demselben Produkt, derselben Option und derselben Einheit vorgenommen wurde.

Es gibt keinen Stornierungs- oder Einlösungsrücknahme-Aufruf an Rotterdampas.

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 Rotterdampas gesendet.

Standard (beide Optionen deaktiviert): Beim Scannen validiert Ventrata die Bestellung und sendet für jedes Ticket „Redeem“ an Rotterdampas.

Wenn „Redeem on Redemption/Upgrade“ und/oder „Redeem on No-show“ aktiviert sind, wird die Buchung gespeichert, aber noch nicht bei Rotterdampas eingelöst. Ventrata sendet „Redeem“, wenn das Ticket in Ventrata eingelöst oder upgegradet oder als nicht erschienen markiert wird.

Eine Redeem-Anfrage für den ausgestellten Voucher, mit dem Ticketpreis als TransactionAmount in Cent und einer festen Referenz pro Ticket, damit eine Wiederholung nicht doppelt einlöst.

Pass Walkup Scanning Sync

✅

Sie scannen Pässe von Rotterdampas an Ihrem Eingang.

Mitarbeitende scannen eine Kartennummer von Rotterdampas oder geben sie ein, optional gefolgt von #PIN.

Ventrata fragt bei Rotterdampas (Intersolve) die auf diese Karte ausgestellten Voucher ab.

Jeder nutzbare Voucher wird zu einem eigenen einlösbaren Code (/), sodass eine Karte mehrere Buchungen liefern kann.

Gift Card Sync

❌

Nicht Teil dieser Verbindung.

Pässe von Rotterdampas sind keine Ventrata-Geschenkkarten.

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

 

Gut zu wissen: Einschränkungen dieser Verbindung

  • Vouchertypen erscheinen erst zur Zuordnung, nachdem eine echte Karte gescannt wurde. Sie können also vor dem Livegang nur zuordnen, wenn Sie die Voucher-IDs kennen.

  • Ein bereits anderswo eingelöster Voucher wird in Ventrata nie erneut akzeptiert.

  • Fehlertexte von Rotterdampas werden den Mitarbeitenden wortwörtlich angezeigt.

  • Anfragen laufen nach 20 Sekunden ab.

  • Keine Abholungen, Extras, benutzerdefinierten Fragen oder Ressourcen.

 

Fehlerbehebung

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

Dem Vouchertyp ist kein Ventrata-Produkt, keine Option und keine Einheit zugeordnet. Ordnen Sie die Zeile in der Verbindung zu und scannen Sie dann erneut.

„Invalid card status: %{status}“

Der Status des Vouchers bei Rotterdampas ist weder „Normal“ noch „Redeemed“.

„Redemption not allowed“

„This Rotterdampas voucher has already been redeemed“

Der Voucher wurde anderswo verwendet und zu ihm gibt es keine Buchung in Ihrem Ventrata-Konto.

„Invalid response from Rotterdampas“

Rotterdampas hat eine Antwort gesendet, die Ventrata nicht lesen konnte.

„Rotterdampas request failed (code %{code})“

Rotterdampas hat einen Fehlercode ohne Beschreibung zurückgegeben.

 

FAQ

Warum hat ein Scan mehrere Buchungen erzeugt?

Eine Karte von Rotterdampas kann mehrere Voucher enthalten. Ventrata legt für jeden nutzbaren Voucher eine Buchung an.

In welcher Beziehung stehen Rotterdampas und Intersolve?

Rotterdampas läuft auf der Voucher-Plattform von Intersolve. Intersolve hat Rotterdampas entwickelt und ist das zugehörige Ticketingsystem, daher kommuniziert diese Verbindung mit der API von Intersolve.

Was passiert, wenn Mitarbeitende die Karte erneut scannen?

Bei einem bereits in Ventrata gebuchten Voucher wird die bestehende Buchung zurückgegeben statt einer neuen. Bei einer Wiederholung verwendet die Redeem-Anfrage dieselbe Referenz, sodass Rotterdampas nicht doppelt belastet wird.

 

Nützliche Ressourcen

 

 

Partnerinformationen

Gemeente Rotterdam

Rotterdampas Servicepunt, Halvemaanpassage 90 (Timmerhuis), 3011 DL Rotterdam

Niederlande

 

Ventrata-Partner-ID: 1ae100da-b3b2-4726-a71e-6185dd3f65db

Hat dies deine Frage beantwortet?