Rotterdampas est le pass de réduction annuel officiel du Grand Rotterdam, destiné aux habitants et aux étudiants, qui donne accès gratuitement ou à prix réduit à des centaines de lieux culturels, de loisirs, sportifs et familiaux. Pour les opérateurs, il apporte un public local et national, environ 170 000 détenteurs de pass par an qui reviennent souvent et en heures creuses, les musées, attractions et activités familiales représentant l'essentiel des validations. Rotterdampas utilise Intersolve comme principal système de billetterie.
Connecter Rotterdampas à Ventrata vous permet de scanner, contrôler et valider les pass Rotterdampas à 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 Rotterdampas distincte.
Pour en savoir plus sur Rotterdampas, rendez-vous sur rotterdampas.nl.
📒 REMARQUE
Rotterdampas fonctionne sur Intersolve. Consultez Intersolve : connexion revendeur.
Site web principal | |
Tags | Multi-Attraction Pass |
Type de connexion | Validation des pass : vous scannez les pass Rotterdampas à votre entrée |
Fonctionnalités de la connexion | Product Mapping · Redemption Sync · Pass Walkup Scanning Sync |
Développé par | Ventrata (via l'API Rotterdampas) |
Cette connexion vous permet de :
Scanner ou saisir un numéro de carte Rotterdampas et voir les bons de cette carte valables dans votre établissement.
Créer automatiquement une réservation dans Ventrata pour chaque bon utilisable : un seul scan peut ainsi faire entrer plusieurs bons.
Enregistrer l'utilisation du bon auprès de Rotterdampas au moment du scan, ou plus tard lorsque le visiteur est admis ou marqué en non-présentation.
Fonctionnement
Le personnel scanne ou saisit un numéro de carte Rotterdampas, éventuellement suivi de #PIN.
Ventrata demande à Rotterdampas (Intersolve) les bons émis pour cette carte.
Chaque bon utilisable devient un code validable distinct (/) : une même carte peut donc renvoyer plusieurs réservations.
Les bons au statut Normal donnent lieu à une nouvelle réservation, ou la réservation existante est renvoyée. Les bons déjà au statut Redeemed ne renvoient qu'une réservation Ventrata existante.
Ventrata crée une réservation à date ouverte pour chaque bon, avec le produit, l'option et l'unité que vous avez mappés à ce type de bon.
Ventrata envoie Redeem à Rotterdampas pour chaque billet, immédiatement ou plus tard, selon vos paramètres de validation.
📒 REMARQUE
Un numéro de carte Rotterdampas, éventuellement suivi de #PIN. Soit le numéro court de 1 à 7 chiffres (Ventrata le complète avec le préfixe fixe Rotterdampas pour obtenir la forme à 19 chiffres), soit le numéro complet avec préfixe.
Créer la connexion Rotterdampas
🔐 Autorisations de rôle requises : See Connections, Modify Connections
Avant de commencer :
Munissez-vous de votre User Name et de votre Password API Rotterdampas.
Créez Rotterdampas en tant que revendeur dans Ventrata si vous souhaitez que les réservations soient enregistrées sous ce revendeur (le champ Revendeur (Reseller) est facultatif dans le formulaire).
Munissez-vous d'une vraie carte Rotterdampas contenant vos bons. Les types de bons n'apparaissent pour le mappage qu'après le scan d'une carte.
Créer la connexion
Sélectionnez votre revendeur Rotterdampas (facultatif).
Saisissez le User Name et le Password Rotterdampas.
Choisissez quand la validation est envoyée : laissez les deux options désactivées pour valider au moment du scan, ou cochez Valider lors de la validation/du surclassement (Redeem on Redemption/Upgrade) et/ou Valider en cas de non-présentation (Redeem on No-show).
Enregistrez. Ventrata vérifie les identifiants auprès de Rotterdampas.
Le formulaire de connexion comporte les options suivantes :
Reseller | Le revendeur sous lequel les réservations Rotterdampas sont enregistrées. Facultatif dans le formulaire. |
Rotterdampas User Name / Password | Obligatoire. Ventrata les vérifie par un appel de test lorsque vous créez la connexion ou les modifiez ; en cas d'échec, les deux champs sont marqués comme non valides. |
Valider lors de la validation/du surclassement (Redeem on Redemption/Upgrade) | Envoie la validation au fournisseur connecté lorsque la réservation est validée dans Ventrata. |
Valider en cas de non-présentation (Redeem on No-show) | Envoie la validation au fournisseur connecté lorsque la réservation est marquée en non-présentation dans Ventrata, y compris les non-présentations automatiques. |
Mapper les produits
Les lignes sont créées la première fois que Ventrata voit un type de bon (VoucherId) sur une carte scannée. Il n'y a pas de liste à charger à l'avance.
Scannez une carte Rotterdampas qui contient votre bon.
Ouvrez la connexion et repérez la nouvelle ligne correspondant à ce type de bon.
Choisissez le produit, l'option et l'unité Ventrata à réserver. L'option et l'unité sont obligatoires.
Scannez à nouveau la carte pour créer la réservation.
📒 REMARQUE
Une ligne n'est considérée comme mappée que si le produit est actif et que l'option et l'unité sont renseignées et non archivées.
📒 REMARQUE
Tant qu'une ligne n'est pas mappée, le bon échoue avec « is not mapped in <connection> ».
Redemption
Immédiatement : par défaut (les deux options désactivées), au moment du scan, Ventrata valide la commande et envoie Redeem à Rotterdampas pour chaque billet.
Lors de la validation ou de la non-présentation : si Valider lors de la validation/du surclassement (Redeem on Redemption/Upgrade) et/ou Valider en cas de non-présentation (Redeem on No-show) sont cochées, la réservation est enregistrée mais pas encore validée auprès de Rotterdampas. Ventrata envoie Redeem lorsque le billet est validé ou surclassé dans Ventrata, ou marqué en non-présentation.
Ce qui est envoyé à Rotterdampas : une requête Redeem pour le bon émis, avec le prix du billet en TransactionAmount en centimes et une référence fixe par billet, afin qu'une nouvelle tentative ne valide pas deux fois.
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 Rotterdampas à un produit Ventrata dans le Ventrata Dashboard. Les lignes sont créées la première fois que Ventrata voit un type de bon (VoucherId) sur une carte scannée. Il n'y a pas de liste à charger à l'avance. Une ligne n'est considérée comme mappée que si le produit est actif et que l'option et l'unité sont renseignées et non archivées. Tant qu'une ligne n'est pas mappée, le bon échoue avec « is not mapped in <connection> ». |
Content Sync | ❌ |
Le contenu des produits n'est pas synchronisé. Rotterdampas vend son propre pass. Vos produits et leur contenu restent dans Ventrata. |
Availability Sync | ❌ |
Vos disponibilités ne sont pas partagées avec Rotterdampas. Il n'y a aucun échange de disponibilités ni de capacité avec Rotterdampas. |
Pricing Sync | ❌ |
Les prix ne sont pas synchronisés avec Rotterdampas. La réservation utilise votre prix unitaire Ventrata et est soldée par une transaction de bon. Lors de la validation, Ventrata envoie le prix du billet à Rotterdampas en TransactionAmount, en sous-unités monétaires (centimes). |
Promotions Sync | ❌ |
Les promotions ne s'appliquent pas aux pass Rotterdampas. 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 bon utilisable : un seul scan peut donc créer plusieurs réservations. Les ID de bons étant réutilisés d'une saison à l'autre, Ventrata ne rapproche qu'une réservation antérieure effectuée dans la période de validité du bon (valid-from/valid-until), avec le même produit, la même option et la même unité. Il n'y a pas d'appel d'annulation ou d'annulation de validation vers Rotterdampas. |
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 à Rotterdampas. Par défaut (les deux options désactivées), au moment du scan, Ventrata valide la commande et envoie Redeem à Rotterdampas pour chaque billet. Si Valider lors de la validation/du surclassement (Redeem on Redemption/Upgrade) et/ou Valider en cas de non-présentation (Redeem on No-show) sont cochées, la réservation est enregistrée mais pas encore validée auprès de Rotterdampas. Ventrata envoie Redeem lorsque le billet est validé ou surclassé dans Ventrata, ou marqué en non-présentation. Une requête Redeem pour le bon émis, avec le prix du billet en TransactionAmount en centimes et une référence fixe par billet, afin qu'une nouvelle tentative ne valide pas deux fois. |
Pass Walkup Scanning Sync | ✅ |
Vous scannez les pass Rotterdampas à votre entrée. Le personnel scanne ou saisit un numéro de carte Rotterdampas, éventuellement suivi de #PIN. Ventrata demande à Rotterdampas (Intersolve) les bons émis pour cette carte. Chaque bon utilisable devient un code validable distinct (/) : une même carte peut donc renvoyer plusieurs réservations. |
Gift Card Sync | ❌ |
Ne fait pas partie de cette connexion. Les pass Rotterdampas ne sont pas des cartes cadeaux Ventrata. |
✅ pris en charge · ✅ / ❌ limité · ❌ non pris en charge
Bon à savoir : limites de cette connexion
Bon à savoir : limites de cette connexion
Les types de bons n'apparaissent pour le mappage qu'après le scan d'une vraie carte : vous ne pouvez donc pas mapper avant la mise en service, sauf si vous connaissez les ID des bons.
Un bon déjà validé ailleurs n'est jamais réadmis dans Ventrata.
Les textes d'erreur de Rotterdampas sont affichés au personnel mot pour mot.
Les requêtes expirent au bout de 20 secondes.
Pas de prise en charge, d'extras, de questions personnalisées ni de ressources.
Dépannage
« %{title} is not mapped in %{connection} »
« %{title} is not mapped in %{connection} »
Aucun produit, option et unité Ventrata n'est mappé pour ce type de bon. Mappez la ligne sur la connexion, puis scannez à nouveau.
« Invalid card status: %{status} »
« Invalid card status: %{status} »
Le statut du bon chez Rotterdampas n'est ni Normal ni Redeemed.
« Redemption not allowed »
« Redemption not allowed »
« This Rotterdampas voucher has already been redeemed »
« This Rotterdampas voucher has already been redeemed »
Le bon a été utilisé ailleurs et n'a aucune réservation dans votre compte Ventrata.
« Invalid response from Rotterdampas »
« Invalid response from Rotterdampas »
Rotterdampas a envoyé une réponse que Ventrata n'a pas pu lire.
« Rotterdampas request failed (code %{code}) »
« Rotterdampas request failed (code %{code}) »
Rotterdampas a renvoyé un code d'erreur sans description.
FAQ
Pourquoi un seul scan a-t-il créé plusieurs réservations ?
Pourquoi un seul scan a-t-il créé plusieurs réservations ?
Une carte Rotterdampas peut contenir plusieurs bons. Ventrata crée une réservation pour chaque bon utilisable.
Quel est le lien entre Rotterdampas et Intersolve ?
Quel est le lien entre Rotterdampas et Intersolve ?
Rotterdampas fonctionne sur la plateforme de bons d'Intersolve. Intersolve a développé Rotterdampas et en est le système de billetterie : cette connexion communique donc avec l'API d'Intersolve.
Que se passe-t-il si le personnel scanne à nouveau la carte ?
Que se passe-t-il si le personnel scanne à nouveau la carte ?
Pour un bon déjà réservé dans Ventrata, la réservation existante est renvoyée au lieu d'en créer une nouvelle. En cas de nouvelle tentative, la requête Redeem utilise la même référence, de sorte que Rotterdampas n'est pas débité deux fois.
Ressources utiles
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
Gemeente Rotterdam
Rotterdampas Servicepunt, Halvemaanpassage 90 (Timmerhuis), 3011 DL Rotterdam
Pays-Bas
ID partenaire Ventrata : 1ae100da-b3b2-4726-a71e-6185dd3f65db