Bókun est la plateforme de réservation et de distribution de Tripadvisor pour les opérateurs de visites, d'attractions, d'activités, de location et de transport terrestre, utilisée par des milliers d'entreprises dans le monde. Sa marketplace regroupe plus de 2 600 OTA et revendeurs, et son appartenance au même groupe que Viator en fait un backend fréquent pour les opérateurs dont la demande provient en grande partie de Tripadvisor.
Connecter Bókun à Ventrata vous permet de revendre les produits d'opérateurs qui utilisent Bókun comme système de réservation. Ventrata lit leurs disponibilités et leurs prix en temps réel dans Bókun, et chaque réservation que vous prenez est créée directement dans le compte Bókun de l'opérateur.
Pour en savoir plus sur Bókun, consultez bokun.io.
📒 REMARQUE
Vous souhaitez plutôt que Bókun revende vos produits ? Consultez Bókun : connexion revendeur.
📒 REMARQUE
Cette connexion sera bientôt disponible. Elle est en cours de développement, avec un lancement prévu en novembre–décembre 2026. Si vous souhaitez l'utiliser, contactez notre support technique ou votre Customer Success Manager Ventrata.
Site web principal | |
Tags | Booking / Ticketing System |
Fonctionnalités de la connexion | Availability Sync · Pricing Sync · Bookings Sync |
Développé par | Ventrata (via l'API OCTO de Bókun) |
Cette connexion opérateur (aussi appelée backend) vous permet de revendre les produits d'opérateurs qui utilisent Bókun comme système de réservation principal, chaque réservation étant créée directement dans Bókun. Fonctionnalités de cette connexion :
Availability Sync – les disponibilités en temps réel proviennent du compte Bókun de l'opérateur.
Pricing Sync – les prix proviennent de Bókun, ou vous les définissez dans Ventrata.
Bookings Sync – les réservations, modifications et annulations sont transmises de Ventrata à Bókun, et Bókun émet les billets ou les bons.
Créer la connexion Bókun
🔐 Autorisations de rôle requises : See Operators, Modify Operators, See Products, Modify Products
Avant de commencer :
Vous devez disposer d'un accord commercial avec l'opérateur définissant ses tarifs et ses conditions.
Vous devez disposer de la clé API OCTO (OCTO API Key) pour l'opérateur. Consultez les étapes ci-dessous.
L'entreprise dont vous souhaitez revendre les produits est créée en tant qu'opérateur dans Ventrata.
Les produits de l'opérateur sont créés dans Ventrata. La connexion synchronise les disponibilités, les prix et les réservations, mais ne crée pas les produits.
Vous devez recréer les produits de l'opérateur dans Ventrata. Découvrez comment créer des produits. La connexion synchronise les disponibilités, les prix et les réservations, mais ne crée pas les produits dans Ventrata.
Étape 1 : configurer l'opérateur dans Ventrata
Demandez-la à l'opérateur qui utilise Bókun. Il la crée dans Bókun : Settings → Connectivity → API keys → Create an API key → Save → activer OCTO sur cette clé API.
Dans le Ventrata Dashboard, accédez à Produits → Les opérateurs (Products → Operators) et ouvrez l'opérateur. S'il n'existe pas encore, créez-le d'abord en tant qu'opérateur.
Dans la section Partenaire backend (Backend Partner), sélectionnez Bókun et saisissez l'OCTO API Key. Laissez le point de terminaison par défaut
https://api.bokun.io/octo/v1, sauf indication contraire de l'opérateur ou de Bókun.Choisissez Bókun dans la section Partenaire backend (Backend Partner) de l'opérateur.
Saisissez l'OCTO API Key. Laissez l'OCTO Endpoint à sa valeur par défaut pré-remplie, sauf indication contraire de l'opérateur.
Click Update Operator.
Press Update Operator.
📒 REMARQUE – Chaque clé API OCTO vous connecte à un seul opérateur. Configurez chaque opérateur Bókun séparément.
Étape 2 : connectez chaque produit
Ouvrez le produit de l'opérateur dans Produits → Produits (Products → Products) et modifiez-le. Vérifiez que le champ Opérateur (Operator) est bien défini sur cet opérateur.
Cochez Backend connecté (Backend Connected). Cochez Disponibilité du backend (Backend Availability) pour utiliser les disponibilités de Bókun, et Tarification backend (Backend Pricing) pour utiliser les prix de Bókun.
Press Update Product.
📒 REMARQUE
Bókun envoie uniquement les prix publics. Lorsque l'option Tarification backend (Backend Pricing) est cochée, Ventrata enregistre le prix public et calcule votre prix net (de revient) à partir du pourcentage de coût défini sur l'opérateur dans le Ventrata Dashboard.
Définissez comme opérateur du produit l'opérateur doté du backend Bókun, cochez Backend connecté (Backend Connected), puis Disponibilité du backend (Backend Availability) et/ou Tarification backend (Backend Pricing). Sans ces options, le produit utilise les disponibilités/prix définis dans Ventrata, mais transmet toujours les réservations à Bókun.
Mapper les produits vers Bókun
‼️ IMPORTANT
Le mappage indique à Ventrata pour quels produit, option et unités Bókun il doit vérifier les disponibilités et réserver. Si un produit connecté au backend n'est pas correctement mappé, ses réservations échouent. Une ligne de produit surlignée en rouge signale un produit mal mappé.
Dans le Ventrata Dashboard, accédez à Produits → Produits (Products → Products) et ouvrez le produit.
Ouvrez l'onglet Mappages (Mappings). Il apparaît dès que le produit est défini sur Backend connecté (Backend Connected).
Pour chaque option et unité Ventrata, sélectionnez le produit, l'option et les unités Bókun correspondants dans les listes déroulantes, que Ventrata charge depuis Bókun. Ne laissez aucun champ vide.
Press Save Changes.
📗 ASTUCE
Effectuez une réservation test après le mappage, et demandez à l'opérateur de confirmer qu'elle est bien arrivée dans son compte Bókun.
Gérer la connexion Bókun
Mettez à jour le mappage lorsque l'opérateur modifie des produits, options ou unités dans Bókun.
Remplacez la clé sur l'opérateur si Bókun ou l'opérateur en émet une nouvelle.
Désactivez l'option Disponibilité du backend (Backend Availability) ou Tarification backend (Backend Pricing) sur un produit pour utiliser à la place les disponibilités ou les prix de Ventrata. Les réservations sont toujours transmises à Bókun.
Fonctionnalités de la connexion en détail
Cette section s'adresse à toute personne qui souhaite savoir précisément comment fonctionne la connexion Bókun. Ici, le sens est l'inverse de celui d'une connexion revendeur : Ventrata appelle Bókun, via l'API OCTO de Bókun. Pour chaque fonctionnalité, cette section explique quels appels Ventrata effectue, à quel moment, et ce que cela signifie pour vous.
En bref : Ventrata demande à Bókun les disponibilités et les prix chaque fois que quelqu'un consulte un produit connecté au backend, et crée chaque réservation dans le compte Bókun de l'opérateur. Bókun ne renvoie pas les modifications à Ventrata.
Les délais indiqués sont ceux généralement observés avec Bókun ; ils sont arrondis et peuvent évoluer.
Product Mapping | ✅ |
Vous mappez chaque produit, option et unité Ventrata au produit Bókun de l'opérateur dans le Ventrata Dashboard. Le fonctionnement est le suivant :
Ce que cela signifie pour vous : si un élément manque dans la liste déroulante, c'est que l'opérateur ne l'a pas mis à votre disposition dans Bókun. Demandez-lui de le faire. |
Content Sync | ❌ |
Ventrata n'importe pas le contenu des produits depuis Bókun. Ventrata n'importe pas le contenu des produits depuis Bókun. Vous créez et décrivez vous-même les produits dans Ventrata. |
Availability Sync | ✅ |
Lorsque l'option Disponibilité du backend (Backend Availability) est activée, Ventrata vérifie les disponibilités en temps réel de l'opérateur dans Bókun. Le fonctionnement est le suivant :
En général, avec Bókun :
Ce que cela signifie pour vous : les clients réservent sur la base des disponibilités Bókun en temps réel de l'opérateur : vous ne pouvez donc pas survendre un créneau que l'opérateur a déjà vendu ailleurs. |
Pricing Sync | ✅ |
Lorsque l'option Tarification backend (Backend Pricing) est activée, Ventrata reprend les prix de Bókun. Le fonctionnement est le suivant :
Bókun envoie uniquement les prix publics. Lorsque l'option Tarification backend (Backend Pricing) est cochée, Ventrata enregistre le prix public et calcule votre prix net (de revient) à partir du pourcentage de coût défini sur l'opérateur dans le Ventrata Dashboard. |
Promotions Sync | ❌ |
Les promotions ne sont pas transmises à Bókun. Les promotions ne sont pas transmises à Bókun. Vos promotions Ventrata s'appliquent toujours au prix que votre client paie dans Ventrata. |
Bookings Sync | ✅ |
Les réservations effectuées dans Ventrata pour un produit connecté au backend sont créées dans le compte Bókun de l'opérateur. Le fonctionnement est le suivant :
Les réservations, modifications et annulations des produits connectés au backend (Backend Connected) sont transmises automatiquement à Bókun : blocage lorsque le produit est ajouté au panier, confirmation après le paiement (avec les coordonnées du client), mise à jour lorsqu'une réservation est modifiée, annulation lorsqu'une réservation est annulée. Le bon ou billet de Bókun est intégré dans Ventrata, sauf PDF_FILE, que Ventrata ne prend pas en charge.
‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Ventrata vers Bókun. Si l'opérateur modifie ou annule une réservation dans Bókun, Ventrata n'en est pas informé. Demandez à l'opérateur de vous signaler toute modification qu'il effectue. |
Pickups/Dropoff Sync | ❌ |
Les informations de prise en charge et de dépose ne sont pas transmises à Bókun. Les informations de prise en charge et de dépose ne sont pas transmises à Bókun. Communiquez-les à l'opérateur par un autre moyen si un produit en a besoin. |
Custom Questions Sync | ❌ |
Les réponses à vos questions de réservation ne sont pas transmises à Bókun. Les réponses à vos questions de réservation ne sont pas transmises à Bókun. Communiquez-les à l'opérateur par un autre moyen s'il en a besoin. |
Extras Sync | ❌ |
Les extras et options supplémentaires ne sont pas réservés dans Bókun. Les extras et options supplémentaires ne sont pas réservés dans Bókun. Seuls le produit principal, l'option et les unités le sont. |
Redemption Sync | ❌ |
Les validations et autres changements de statut dans Bókun ne sont pas renvoyés à Ventrata une fois la réservation confirmée. Les validations et autres changements de statut dans Bókun ne sont pas renvoyés à Ventrata une fois la réservation confirmée. Non pris en charge. Le statut de réservation dans Bókun (par exemple validée) n'est pas renvoyé à Ventrata après la confirmation. |
Pass Walkup Scanning Sync | ❌ |
Le scan des pass sur place (walk-up) n'est pas disponible avec Bókun. Le scan des pass sur place (walk-up) n'est pas disponible avec Bókun. |
Gift Card Sync | ❌ |
Les cartes cadeaux Ventrata ne sont pas transmises à Bókun. Les cartes cadeaux Ventrata ne sont pas transmises à Bókun. Les paiements par carte cadeau restent dans Ventrata. |
✅ pris en charge · ❌ non pris en charge
Bon à savoir : limites et détails de la connexion Bókun
Bon à savoir : limites et détails de la connexion Bókun
Disponibilités en temps réel : les disponibilités proviennent de Bókun pendant que les clients consultent l'offre.
Réservations à sens unique : les modifications que l'opérateur effectue dans Bókun ne parviennent pas à Ventrata.
Bókun, qui fait partie de Tripadvisor, est un système de réservation, de gestion de l'inventaire et des canaux pour les visites, activités et attractions.
FAQ
J'obtiens une erreur lorsque j'enregistre la configuration du backend de l'opérateur.
J'obtiens une erreur lorsque j'enregistre la configuration du backend de l'opérateur.
La clé API OCTO (OCTO API Key) ou le point de terminaison sont très probablement incorrects. Vérifiez-les avec votre opérateur. Si le problème persiste, contactez notre support technique.
Il n'y a pas de case Backend connecté (Backend Connected) dans les paramètres du produit.
Il n'y a pas de case Backend connecté (Backend Connected) dans les paramètres du produit.
L'opérateur défini sur le produit n'a très probablement pas de backend configuré. Vérifiez les paramètres Partenaire backend (Backend Partner) de l'opérateur et réessayez. Si le problème persiste, contactez notre support technique.
Le produit, l'option ou l'unité que je veux mapper n'apparaît pas dans la liste déroulante.
Le produit, l'option ou l'unité que je veux mapper n'apparaît pas dans la liste déroulante.
Les listes déroulantes affichent ce que l'opérateur a mis à votre disposition dans Bókun. Adressez-vous à l'opérateur. Si le problème persiste, contactez notre support technique.
Les réservations échouent pour un produit connecté au backend.
Les réservations échouent pour un produit connecté au backend.
Vérifiez d'abord le mappage du produit : chaque option et chaque unité doivent être mappées. Vérifiez ensuite que le créneau est toujours disponible dans Bókun. Si le problème persiste, contactez notre support technique.
Erreur lors de la mise à jour de l'opérateur pour enregistrer la configuration du backend.
Erreur lors de la mise à jour de l'opérateur pour enregistrer la configuration du backend.
L'OCTO API Key ou l'OCTO Endpoint est probablement incorrect. Vérifiez ces informations auprès de votre opérateur. Si le problème persiste, contactez le support Ventrata.
Le produit/l'option/l'unité que je souhaite mapper ne figure pas dans la liste déroulante.
Le produit/l'option/l'unité que je souhaite mapper ne figure pas dans la liste déroulante.
La liste déroulante est récupérée depuis Bókun en fonction des produits, options et unités que l'opérateur a mis à votre disposition. Vérifiez ces informations avec votre opérateur. Si le problème persiste, contactez le support de Ventrata.
Ressources utiles
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
Tripadvisor LLC dba Bókun
400 1st Avenue
Needham, MA 02494, États-Unis
ID partenaire Ventrata : 18d71b21-57e4-4811-8818-a7be06311725