Passer au contenu principal

Tootbus : connexion revendeur

Connectez Tootbus à Ventrata pour synchroniser les disponibilités et les prix et recevoir les réservations instantanément. Combinés d'attractions pour ceux qui visitent une ville pour la première fois.

Tootbus logo propulsé par Ventrata icon Ventrata

 

Tootbus est la marque de visites touristiques de RATP Dev, qui exploite des circuits hop-on hop-off en bus à impériale ouverte à faibles émissions à Paris, Londres, Bruxelles, Barcelone, Madrid, Rome et en Toscane. Elle regroupe des attractions partenaires, des croisières fluviales et des visites à pied dans des forfaits Discovery et des combos d'attractions, en plus de ses propres pass d'un à trois jours. Pour les opérateurs, elle apporte des visiteurs découvrant la ville pour la première fois, en début de séjour, qui achètent un pass de bus et ajoutent des produits tiers au même panier, avec pour marchés principaux les city breaks français, britanniques et belges.

 

Connecter Tootbus à Ventrata synchronise vos disponibilités et vos prix, et transmet les réservations, modifications et annulations avec des billets émis automatiquement. Tootbus utilise Ventrata comme principal système de billetterie.

 

Pour en savoir plus sur un partenariat avec Tootbus, rendez-vous sur tootbus.com.

 

Site web principal

Tags

Operator Reselling Others · Sightseeing & Hop-On Hop-Off · Ventrata Client

Marchés de destination

🇧🇪 Belgique · 🇫🇷 France · 🇬🇧 Royaume-Uni

Marchés sources

🌎 Monde

Spécialités

Combinés attractions pour les primo-visiteurs d'une ville

Fonctionnalités de la connexion

Availability Sync · Pricing Sync · Bookings Sync

GMV réservé via Ventrata (12 derniers mois)

US$100k+

Développé par

Ventrata (via l'API OCTO de Ventrata)

 

Cette connexion revendeur vous permet de vendre vos produits via Tootbus sans gérer manuellement les disponibilités, les prix et les réservations. Les fonctionnalités de cette connexion incluent :

  • Availability Sync – Tootbus consulte vos disponibilités en temps réel dans Ventrata.

  • Pricing Sync – Tootbus récupère vos prix à partir de la tarification revendeur définie dans Ventrata.

  • Bookings Sync – les réservations, modifications et annulations provenant de Tootbus sont créées instantanément dans Ventrata, et les clients reçoivent des billets Ventrata.

 

Créer la connexion Tootbus

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

 

Avant de commencer :

  • Vous avez un accord commercial avec Tootbus pour qu'il vende vos produits.

  • Tootbus est créé en tant que Revendeur (Reseller) dans Ventrata, avec une tarification publique et une tarification de gros/à la commission configurées.

 

Tootbus fonctionne sur Ventrata : il s'agit donc d'une connexion Ventrata vers Ventrata. Vous créez une connexion revendeur Ventrata pour Tootbus et partagez sa clé API de manière sécurisée. Tootbus se connecte ensuite et mappe vos produits dans son propre compte Ventrata.

 

  1. Dans le Ventrata Dashboard, allez dans Les liaisons > Les liaisons (Connections > Connections), cliquez sur + Nouvelle connexion (+ New Connection) et recherchez Ventrata Reseller Connection.

  2. Sélectionnez Tootbus comme revendeur. Si nécessaire, autorisez ou excluez des destinations et des produits sur la connexion, puis cliquez sur Créer la connexion (Create Connection).

  3. Cliquez sur l'icône en forme d'œil pour afficher la clé API, copiez-la et partagez-la de manière sécurisée avec votre contact chez Tootbus.

  4. Tootbus vous ajoute comme opérateur avec Ventrata (Operator Backend) comme backend, puis connecte et mappe chaque produit. Demandez-lui d'effectuer une réservation test et vérifiez qu'elle apparaît dans votre tableau des réservations.

 

📗 ASTUCE

Pour toutes les étapes avec captures d'écran, consultez Ventrata : connexion revendeur. Tootbus suit Ventrata : backend opérateur.

 

Gérer la connexion Tootbus

  • Autoriser ou exclure des produits : limitez les destinations, produits et options auxquels Tootbus peut accéder. Découvrez comment autoriser ou exclure des produits.

  • Renommez la connexion pour distinguer plusieurs connexions Tootbus.

 

Fonctionnalités de la connexion en détail

Cette section s'adresse à tous ceux qui veulent savoir précisément comment fonctionne la connexion Tootbus : quels appels de l'API OCTO de Ventrata Tootbus effectue (via l'intégration certifiée de Ventrata), quand il les effectue et ce que cela signifie pour vous. Chaque appel renvoie vers la documentation API de Ventrata.

 

En bref : Tootbus récupère dans Ventrata tout ce dont il a besoin. Il lit vos produits, consulte vos disponibilités et vos prix, et envoie les réservations et les annulations. Ventrata n'envoie pas les changements à Tootbus : toute modification effectuée dans Ventrata parvient à Tootbus lors de sa prochaine consultation.

 

Les délais indiqués sont typiques pour Tootbus et arrondis ; ils peuvent changer si Tootbus modifie sa façon de synchroniser.

 

Product Mapping

✅

Tootbus mappe vos produits aux siens dans son compte Ventrata.

Sur chaque produit connecté au backend, Tootbus choisit le produit, l'option et les unités correspondants de votre compte dans l'onglet Mappages (Mappings) du produit. Les produits mal mappés sont surlignés en rouge et leurs réservations échouent. Voir Ventrata : backend opérateur.

Content Sync

❌

Tootbus ne lit pas le contenu de vos produits dans Ventrata.

Tootbus utilise les descriptions, images et autres contenus configurés de son côté : mettez donc votre contenu à jour directement avec Tootbus.

Availability Sync

✅

Tootbus consulte vos disponibilités en temps réel dans Ventrata. Ventrata n'envoie pas les changements de disponibilité à Tootbus.

Le fonctionnement est le suivant :

  • Availability Check (POST /availability) – Tootbus envoie un produit, une option et une date ou une plage de dates. Ventrata répond avec chaque jour ou créneau réservable, son statut (AVAILABLE, LIMITED, SOLD_OUT, CLOSED ou FREESALE), les places restantes, le délai limite de réservation et un availabilityId, dont Tootbus a besoin pour réserver ce créneau.

  • Availability Calendar (POST /availability/calendar) – renvoie un résumé par jour plutôt que chaque créneau, généralement pour indiquer les dates ouvertes dans un sélecteur de dates.

  • Vérification à la réservation – lorsqu'un client réserve, Ventrata vérifie à nouveau la capacité avant de créer la réservation : Tootbus ne peut donc pas surréserver un créneau qui vient d'être complet, même si les disponibilités qu'il a enregistrées sont légèrement obsolètes.

 

En général, avec Tootbus :

  • Availability Check : Tootbus vérifie vos produits tout au long de la journée, en commençant généralement 28 jours à l'avance et en couvrant 7 jours par requête ; il consulte les dates jusqu'à environ un an à l'avance et revérifie le même produit et les mêmes dates environ toutes les 40 minutes.

  • Availability Calendar : Tootbus vérifie vos produits tout au long de la journée, en commençant généralement à la date du jour et en couvrant une seule journée par requête ; il consulte les dates jusqu'à environ 6 mois à l'avance et revérifie le même produit et les mêmes dates environ toutes les 2 heures.

  • Les consultations sont réparties sur la journée sans pic marqué, ce qui suggère un mélange de synchronisations planifiées et de recherches de clients en temps réel.

 

Ce que cela signifie pour vous : lorsque vous fermez une date, modifiez la capacité ou affichez complet dans Ventrata, Tootbus l'affiche après sa vérification suivante. Pour les dates qu'il vérifie régulièrement, c'est dans un délai d'environ 40 minutes. Les dates plus lointaines sont généralement vérifiées moins souvent.

Pricing Sync

✅

Vos prix sont renvoyés à chaque consultation des disponibilités, dès que Tootbus les demande avec la capability octo/pricing.

Le fonctionnement est le suivant :

 

En général, avec Tootbus :

 

📗 ASTUCE – Si les prix sur Tootbus semblent incorrects, vérifiez d'abord la tarification du revendeur Tootbus dans Ventrata : c'est elle que Tootbus lit.

Tootbus peut reprendre vos prix avec Tarification backend (Backend Pricing) sur son produit, ou définir ses propres prix dans son compte.

Promotions Sync

❌

Vos promotions Ventrata ne s'appliquent pas sur Tootbus.

Les prix sur Tootbus n'incluent pas les promotions que vous créez dans Ventrata. Mettez en place vos promotions directement avec Tootbus.

Bookings Sync

✅

Les réservations et annulations effectuées sur Tootbus sont créées instantanément dans Ventrata, et les clients reçoivent des billets Ventrata.

Le fonctionnement est le suivant :

  1. Blocage : Booking Reservation (POST /bookings) – lorsqu'un client commence le paiement sur Tootbus, Tootbus envoie le produit, l'option, le créneau choisi (availabilityId) et une unité par personne. Ventrata vérifie à nouveau la capacité et crée une réservation ON_HOLD, qui bloque les places pendant que le client paie. S'il n'y a plus de place, Ventrata refuse le blocage.

  2. Confirmation : Booking Confirmation (POST /bookings/{uuid}/confirm) – une fois le paiement effectué, Tootbus confirme le blocage, avec sa propre référence de réservation et les coordonnées du client. La réservation passe au statut CONFIRMED dans Ventrata, et Ventrata renvoie votre référence de réservation ainsi que les billets (un par personne) ou un bon (un par réservation), selon la configuration de votre produit, chacun avec un QR code et un lien PDF. Tootbus les transmet au client, qui les présente à votre entrée comme n'importe quel billet Ventrata.

  3. Expiration : si le client ne termine pas son paiement, Tootbus ne confirme jamais la réservation, et le blocage expire de lui-même en libérant les places.

  4. Annulation : Booking Cancellation (POST /bookings/{uuid}/cancel) – lorsqu'un client annule sur Tootbus, Tootbus annule la réservation dans Ventrata. Ventrata n'accepte l'annulation que si la réservation peut encore être annulée et que le délai limite d'annulation de l'option n'est pas dépassé. Sinon, la demande est refusée et Tootbus doit vous contacter.

  5. Modification : Tootbus n'utilise pas Booking Update (PATCH /bookings/{uuid}) : une modification arrive donc très probablement dans Ventrata sous la forme d'une annulation suivie d'une nouvelle réservation.

 

En général, avec Tootbus :

  • Tootbus ne définit pas de durée de blocage : c'est donc la durée de blocage par défaut qui s'applique.

  • Une réservation Tootbus typique concerne environ 2 personnes.

  • Il est normal de voir plus de blocages que de réservations confirmées : les blocages des clients qui ne terminent pas leur paiement expirent simplement.

  • Tootbus vérifie aussi les réservations qu'il a effectuées, avec Get Booking (GET /bookings/{uuid}) environ toutes les 30 minutes, par exemple pour rapprocher ses données.

 

‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Tootbus vers Ventrata. Si vous annulez, modifiez ou refaites une réservation de Tootbus dans Ventrata, par exemple dans le Dashboard, Tootbus n'en est pas informé. Contactez Tootbus pour que la réservation soit également annulée ou modifiée de son côté, ou demandez au client d'annuler via Tootbus.

Pickups/Dropoff Sync

❌

Tootbus n'envoie pas les informations de prise en charge ou de dépose avec ses réservations.

Si vos produits incluent une prise en charge, vérifiez auprès de Tootbus comment il recueille les informations de prise en charge, ou organisez-les directement avec le client.

Custom Questions Sync

❌

Tootbus n'envoie pas les réponses à vos questions de réservation.

Si vous vous appuyez sur des questions de réservation, par exemple les noms ou les besoins alimentaires, vérifiez auprès de Tootbus comment il recueille ces informations.

Extras Sync

❌

Les extras et options supplémentaires ne peuvent pas être réservés via Tootbus.

Les clients ne peuvent réserver que vos produits et options principaux sur Tootbus. Vendez les extras séparément, par exemple à l'arrivée.

Redemption Sync

❌

Les validations ne sont pas signalées à Tootbus.

Ventrata n'informe pas Tootbus lorsqu'un billet est scanné ou validé. Tootbus ne voit une validation que s'il relit la réservation dans Ventrata.

Pass Walkup Scanning Sync

❌

Les détenteurs d'un pass Tootbus ne peuvent pas être scannés à votre entrée sans réservation.

Les clients de Tootbus doivent disposer d'une réservation effectuée via Tootbus avant leur visite.

Gift Card Sync

❌

Les cartes cadeaux Ventrata ne peuvent être ni vendues ni utilisées via Tootbus.

Les cartes cadeaux achetées dans Ventrata ne peuvent pas être utilisées sur Tootbus, et Tootbus ne peut pas vendre de cartes cadeaux Ventrata.

✅ pris en charge · ❌ non pris en charge

 

Bon à savoir : limites et détails de la connexion Tootbus

  • Délais : les disponibilités et les prix ne parviennent à Tootbus que lorsqu'il les consulte : il y a donc toujours un court délai après une modification dans Ventrata.

  • Délai limite d'annulation : Tootbus ne peut annuler via l'API qu'avant le délai limite d'annulation de votre option. Les annulations plus tardives doivent être convenues avec vous.

  • Ce que Tootbus peut voir : uniquement les destinations, produits et options autorisés sur le revendeur et sur la connexion, et ouverts à la vente sur la source API directe. Découvrez comment autoriser ou exclure des produits.

  • Billets : Tootbus émet les billets ou le bon (voucher) Ventrata qu'il reçoit à la confirmation : le scan et la validation fonctionnent donc comme d'habitude.

  • Réservations test : Tootbus peut envoyer des réservations test pendant la configuration de la connexion. Les réservations test n'utilisent pas vos disponibilités et ne sont pas facturées.

 

FAQ

Aucun produit ne s'affiche sur la page de la connexion.

Vérifiez les destinations, produits et options autorisés sur votre revendeur et votre connexion. Vérifiez ensuite que vos produits et options sont ouverts à la vente sur la source API directe. Si le problème persiste, contactez notre Support technique.

Mes produits Ventrata utilisent des tarifs selon la taille de la réservation (Booking Size), et la tarification ne fonctionne pas correctement sur Tootbus.

Après chaque modification de tarif, mettez à jour le mappage des produits pour que les catégories du partenaire restent synchronisées avec Ventrata. Assurez-vous que le tarif est ouvert à la vente via l'API directe.

 

 

Informations sur le partenaire

RATP Development SA

9 Rue Brahms

75012 Paris, France

 

ID partenaire Ventrata : b3f1d7b2-1cca-481a-af23-5c56d6103277

 

Ventrata Ltd

55 Baker Street

Londres, W1U 7EU, Royaume-Uni

 

ID partenaire Ventrata : a6a2a406-088a-4466-b87c-7fcc17770b71

Avez-vous trouvé la réponse à votre question ?