Xola est une plateforme de réservation et d'e-commerce pour les opérateurs de visites, d'activités et d'attractions, qui couvre le paiement en ligne, le point de vente, les bornes, les décharges numériques, la planification du personnel et de l'équipement, les listes d'attente et les avis, Xolabot se chargeant de la récupération des paniers et du suivi marketing. Ses opérateurs se concentrent dans les catégories aventure et expériences, comme les tours en hélicoptère, les tyroliennes, les escape games, les sports nautiques, les excursions en bateau et les sorties de pêche.

Connecter Xola à Ventrata vous permet de revendre les produits d'opérateurs qui utilisent Xola comme système de réservation. Ventrata lit leurs disponibilités et leurs prix en temps réel dans Xola, et chaque réservation que vous prenez est créée directement dans le compte Xola de l'opérateur.

Pour en savoir plus sur Xola, consultez xola.com.

Site web principal	xola.com
Tags	Booking / Ticketing System
Fonctionnalités de la connexion	Availability Sync · Pricing Sync · Bookings Sync
Développé par	Ventrata (via l'API OCTO de Xola)

Cette connexion opérateur (aussi appelée backend) vous permet de revendre les produits d'opérateurs qui utilisent Xola comme système de réservation principal, chaque réservation étant créée directement dans Xola. Fonctionnalités de cette connexion :

Availability Sync – les disponibilités en temps réel proviennent du compte Xola de l'opérateur.
Pricing Sync – les prix publics et nets proviennent de Xola, ou vous définissez les prix dans Ventrata.
Bookings Sync – les réservations, modifications et annulations sont transmises de Ventrata à Xola, et Xola émet les billets ou les bons.

Créer la connexion Xola

🔐 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 être référencé comme canal de distribution (Distribution Channel) dans l'App Store de Xola. Consultez l'étape 1.
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 : se faire référencer dans l'App Store de Xola

Écrivez à [email protected] et à [email protected] en indiquant les noms des opérateurs Xola avec lesquels vous souhaitez vous connecter, ainsi que votre logo, le nom de votre entreprise et un interlocuteur pour la fiche de votre application. Comptez plusieurs jours pour que Xola examine et approuve votre demande.

Étape 2 : obtenir l'OCTO API Key de l'opérateur

Une fois référencé, demandez à l'opérateur d'installer votre application dans Xola, de sélectionner les expériences qu'il souhaite partager avec vous et de vous communiquer l'OCTO API Key de manière sécurisée.

Étape 3 : configurer l'opérateur dans Ventrata

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 Xola et saisissez l'OCTO API Key. Laissez le Point de terminaison OCTO (OCTO Endpoint) par défaut https://octo.xola.com/latest, sauf indication contraire de l'opérateur ou de Xola.
Press Update Operator.

Dans la section Partenaire backend (Backend Partner), choisissez Xola dans la liste des connexions disponibles et saisissez la clé API OCTO que votre opérateur vous a fournie. Sauf instruction contraire de l'opérateur ou de Xola, laissez dans le champ Point de terminaison OCTO (OCTO Endpoint) la valeur par défaut pré-remplie pour Xola

📒 REMARQUE – Chaque clé API vous connecte à un seul opérateur. Configurez chaque opérateur Xola séparément.

Étape 4 : 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 Xola, et Tarification backend (Backend Pricing) pour utiliser les prix de Xola.
Press Update Product.

📒 REMARQUE

Xola 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.

Cochez Backend connecté (Backend Connected) pour que ce produit utilise la connexion API (backend). Pour récupérer les disponibilités depuis Xola, vérifiez que l'option Disponibilité du backend (Backend Availability) est cochée ; pour récupérer les prix, cochez Tarification backend (Backend Pricing). Si vous ne cochez pas Disponibilité du backend et/ou Tarification backend, le produit utilise les disponibilités et/ou les prix configurés dans Ventrata, mais transmet toujours les réservations à Xola. Cliquez sur Modifier ce(tte) Produit (Update Product) pour enregistrer.

Mapper les produits vers Xola

‼️ IMPORTANT

Le mappage indique à Ventrata pour quels produit, option et unités Xola 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 dans les listes déroulantes l'expérience, l'option et les unités Xola correspondantes, que Ventrata charge depuis Xola. Ne laissez aucun champ vide.
Press Save Changes.

La page du produit affiche maintenant un onglet Mappages (Mappings). Ouvrez cet onglet et mappez votre produit, vos options et vos unités Ventrata en sélectionnant les produits, options et unités correspondants dans les listes déroulantes reçues de Xola. Vérifiez qu'aucun champ n'est laissé vide (non mappé), puis cliquez sur Enregistrer les modifications (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 Xola.

Gérer la connexion Xola

Mettez à jour le mappage lorsque l'opérateur modifie des produits, options ou unités dans Xola.
Remplacez la clé sur l'opérateur si Xola 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 à Xola.

Fonctionnalités de la connexion en détail

Cette section s'adresse à tous ceux qui veulent savoir précisément comment fonctionne la connexion Xola. Ici, le sens est l'inverse de celui d'une connexion revendeur : Ventrata appelle Xola, via l'API OCTO de Xola. Pour chaque fonctionnalité, cette section explique quels appels Ventrata effectue, à quel moment, et ce que cela signifie pour vous.

En bref : Ventrata demande à Xola 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 Xola de l'opérateur. Xola ne renvoie pas les modifications à Ventrata.

Les délais indiqués sont ceux généralement observés avec Xola ; ils sont arrondis et peuvent évoluer.

Product Mapping	✅	Vous mappez chaque produit, option et unité Ventrata vers l'expérience Xola de l'opérateur dans le Ventrata Dashboard. Le fonctionnement est le suivant : Get Products (`GET /products`) – Ventrata lit les expériences que l'opérateur a partagées avec vous dans Xola, avec leurs options et unités, pour remplir les listes déroulantes de l'onglet Mappages (Mappings). Capabilities (`GET /capabilities`) – Ventrata vérifie quelles capacités OCTO le compte Xola de l'opérateur prend en charge. En général, avec Xola : Ventrata relit les produits et les capacités de l'opérateur dans Xola toutes les quelques heures ; les nouvelles expériences que l'opérateur partage avec vous apparaissent donc dans les listes déroulantes sans aucune action de votre part. Ce que cela signifie pour vous : si une expérience, une option ou une unité manque dans la liste déroulante, c'est que l'opérateur ne l'a pas encore partagée avec vous dans Xola. Demandez-lui de l'ajouter à votre application.
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 Xola. Le fonctionnement est le suivant : Availability Check (`POST /availability`) – lorsque quelqu'un utilise le calendrier des disponibilités dans Ventrata, par exemple dans le Dashboard, votre Web Checkout ou un terminal, Ventrata interroge Xola en temps réel pour les dates affichées. Xola répond avec chaque créneau, son statut et la capacité restante. Avant que quelqu'un n'interagisse avec le calendrier, celui-ci peut afficher le résultat de la dernière vérification de ces dates (en cache). En général, avec Xola : Les requêtes couvrent généralement un seul jour ou quelques jours à la fois, à partir d'aujourd'hui et jusqu'à environ 6 mois à l'avance, au fil de la navigation. Ce que cela signifie pour vous : les clients réservent toujours sur la base des disponibilités Xola 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. Ventrata demande les disponibilités à Xola par plages de 7 jours ou pour un seul jour.
Pricing Sync	✅	Avec l'option Tarification backend (Backend Pricing) activée, Ventrata reprend à la fois les prix publics et les prix nets de Xola. Le fonctionnement est le suivant : Availability Check avec la capacité `octo/pricing` – Ventrata demande les prix à Xola à chaque demande de disponibilités. Les prix sont affichés à l'utilisateur et enregistrés dans Ventrata en tant que tarifs générés par l'API. Les prix nets (de gros) de Xola sont enregistrés comme prix de revient, quel que soit le pourcentage de coût que vous avez défini sur l'opérateur. Lorsque l'option Tarification backend (Backend Pricing) est désactivée, le produit utilise les prix que vous définissez dans Ventrata, et les réservations sont toujours transmises à Xola. Xola 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.
Bookings Sync	✅	Les réservations, modifications et annulations effectuées dans Ventrata pour un produit connecté au backend sont envoyées automatiquement à Xola. Le fonctionnement est le suivant : Blocage : Booking Reservation (`POST /bookings`) – lorsque le produit est ajouté au panier dans Ventrata, Ventrata réserve les places dans Xola. Confirmation : Booking Confirmation (`POST /bookings/{uuid}/confirm`) – après le paiement, Ventrata confirme la réservation dans Xola avec les coordonnées du client. Le billet ou le bon renvoyé par Xola devient le billet ou le bon Ventrata, sauf PDF_FILE, que Ventrata ne prend pas en charge. Modification : Booking Update (`PATCH /bookings/{uuid}`) – lorsqu'une réservation est modifiée dans Ventrata, la modification est envoyée à Xola. Annulation : Booking Cancellation (`POST /bookings/{uuid}/cancel`) – lorsqu'une réservation est annulée dans Ventrata, elle l'est aussi dans Xola. ‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Ventrata vers Xola. Si l'opérateur modifie ou annule une réservation dans Xola, Ventrata n'en est pas informé. Demandez à l'opérateur de vous signaler toute modification qu'il effectue.
Content Sync	❌	Ventrata n'importe pas le contenu des produits depuis Xola. Ventrata n'importe pas le contenu des produits depuis Xola. Vous créez et décrivez vous-même les produits dans Ventrata.
Promotions Sync	❌	Les promotions ne sont pas transmises à Xola. Les promotions ne sont pas transmises à Xola. Vos promotions Ventrata s'appliquent toujours au prix que votre client paie dans Ventrata.
Pickups/Dropoff Sync	❌	Les informations de prise en charge et de dépose ne sont pas transmises à Xola. Les informations de prise en charge et de dépose ne sont pas transmises à Xola. 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 à Xola. Les réponses à vos questions de réservation ne sont pas transmises à Xola. 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 Xola. Les extras et options supplémentaires ne sont pas réservés dans Xola. Seuls le produit principal, l'option et les unités le sont.
Redemption Sync	❌	Les validations et autres changements de statut dans Xola ne sont pas renvoyés à Ventrata une fois la réservation confirmée. Les validations et autres changements de statut dans Xola ne sont pas renvoyés à Ventrata une fois la réservation confirmée.
Pass Walkup Scanning Sync	❌	Le scan des pass sur place (walk-up) n'est pas disponible avec Xola. Le scan des pass sur place (walk-up) n'est pas disponible avec Xola.
Gift Card Sync	❌	Les cartes cadeaux Ventrata ne sont pas transmises à Xola. Les cartes cadeaux Ventrata ne sont pas transmises à Xola. Les paiements par carte cadeau restent dans Ventrata.

✅ pris en charge · ❌ non pris en charge

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

Un opérateur par clé : chaque opérateur Xola vous fournit sa propre OCTO API Key.
Expériences partagées uniquement : vous ne pouvez mapper et vendre que les expériences que l'opérateur a partagées avec votre application dans Xola.
Disponibilités en temps réel : les disponibilités proviennent de Xola au fil de la navigation ; il n'y a donc aucune disponibilité à synchroniser manuellement.
Réservations à sens unique : les modifications que l'opérateur effectue dans Xola ne parviennent pas à Ventrata.

FAQ

J'obtiens une erreur lorsque j'enregistre la configuration du backend de l'opérateur.

L'OCTO API Key ou l'OCTO Endpoint est très probablement incorrect. Vérifiez-les auprès de 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.

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.

Les listes déroulantes affichent ce que l'opérateur a partagé avec vous dans Xola. Demandez à l'opérateur de le partager. Si le problème persiste, contactez notre support technique.

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 Xola. Si le problème persiste, contactez notre support technique.

Ressources utiles

📚 En savoir plus sur les connexions Ventrata

Informations sur le partenaire

Xola, Inc.

Hewes Building, 995 Market St

San Francisco, CA 94103, États-Unis

xola.com

ID partenaire Ventrata : 360a0ae4-5437-4c21-9dfa-68c0e8e22c8a

Xola : backend opérateur