Onebox est un système de distribution de billets basé à Barcelone pour les événements et les loisirs, utilisé par des promoteurs, des salles, des festivals, des théâtres, des musées, des stades et des parcs à thème pour gérer les ventes, la tarification dynamique, les plans de salle, les jauges et le contrôle d'accès. Parmi ses clients figurent l'Atlético de Madrid et le Teatro Apolo ; l'entreprise revendique plus de 65 millions de billets vendus, et son réseau de distribution touche des opérateurs de billetterie, des agences de voyages, des hôtels et des centres commerciaux dans toute l'Espagne.
Connecter Onebox à Ventrata vous permet de revendre les produits d'opérateurs qui utilisent Onebox comme système de réservation. Ventrata lit leurs disponibilités et leurs prix en temps réel dans Onebox, et chaque réservation que vous prenez est créée directement dans le compte Onebox de l'opérateur.
Pour en savoir plus sur Onebox, consultez oneboxtds.com.
📒 REMARQUE
Cette connexion sera bientôt disponible. Elle est en cours de développement. Si vous souhaitez l'utiliser, contactez notre support technique ou votre Customer Success Manager Ventrata.
‼️ IMPORTANT
Le mappage indique à Ventrata pour quel produit demander les disponibilités à Onebox. Si un produit connecté au backend n'est pas correctement mappé, ses réservations échoueront. Une ligne de produit surlignée en rouge signifie que le produit n'est pas correctement mappé.
📒 REMARQUE
Recréez les produits d'Onebox dans Ventrata, en respectant exactement la configuration Onebox.
📗 ASTUCE
Seuls les champs marqués d'un astérisque (*) sont obligatoires lors de la création de l'opérateur.
Site web principal | |
Tags | Booking / Ticketing System |
Fonctionnalités de la connexion | Availability Sync · Pricing Sync · Bookings Sync |
Développé par | Ventrata (via Onebox Distribution API) |
Cette connexion opérateur (aussi appelée backend) vous permet de revendre les produits d'opérateurs qui utilisent Onebox comme système de réservation principal, chaque réservation étant créée directement dans Onebox. Fonctionnalités de cette connexion :
Availability Sync – les disponibilités en temps réel proviennent du compte Onebox de l'opérateur.
Pricing Sync – les prix proviennent d'Onebox, ou vous les définissez dans Ventrata.
Bookings Sync – les réservations sont transmises de Ventrata à Onebox, et Onebox émet les billets ou les bons.
L'API externe d'Onebox utilisée pour cette connexion est une API personnalisée qui ne suit pas le standard d'API OCTO, ce qui peut limiter certaines fonctionnalités et capacités.
Créer la connexion Onebox
🔐 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 du Channel ID et du Client Secret de l'opérateur. Suivez les étapes ci-dessous.
Recréez les produits d'Onebox dans Ventrata, en respectant exactement la configuration Onebox.
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 : signer un accord commercial et demander les identifiants
Signez un accord commercial avec l'opérateur dont vous prévoyez de revendre les produits via Onebox.
Contactez Onebox et demandez les identifiants ci-dessous.
Channel ID
Client Secret
Étape 2 : configurer l'opérateur dans Ventrata
Contactez Onebox et demandez le Channel ID et le Client Secret.
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 Onebox et saisissez le Channel ID et le Client Secret.
Press Update Operator.
Étape 3 : 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 d'Onebox, et Tarification backend (Backend Pricing) pour utiliser les prix d'Onebox.
Press Update Product.
📒 REMARQUE
Onebox n'envoie que des prix nets. Avec l'option Tarification backend (Backend Pricing) cochée, Ventrata enregistre le prix net comme votre prix de revient et calcule le prix public à partir du pourcentage de coût défini sur l'opérateur dans le Ventrata Dashboard.
Cochez Backend connecté (Backend Connected) et laissez l'option Disponibilité du backend (Backend Availability) cochée.
Cochez Tarification backend (Backend Pricing) si vous souhaitez reprendre les prix du partenaire backend.
Mapper les produits vers Onebox
‼️ IMPORTANT
Le mappage indique à Ventrata pour quels produit, option et unités Onebox 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 Onebox correspondants dans les listes déroulantes, que Ventrata charge depuis Onebox. 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 Onebox.
Gérer la connexion Onebox
Mettez à jour le mappage lorsque l'opérateur modifie des produits, options ou unités dans Onebox.
Remplacez la clé sur l'opérateur si Onebox 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 à Onebox.
Fonctionnalités de la connexion en détail
Cette section s'adresse à tous ceux qui veulent savoir précisément comment fonctionne la connexion Onebox. Ici, le sens est l'inverse de celui d'une connexion revendeur : Ventrata appelle Onebox, via Onebox Distribution API. Pour chaque fonctionnalité, cette section explique quels appels Ventrata effectue, à quel moment, et ce que cela signifie pour vous.
En bref : Ventrata demande à Onebox 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 Onebox de l'opérateur. Onebox ne renvoie pas les modifications à Ventrata.
Les délais indiqués sont ceux généralement observés avec Onebox ; ils sont arrondis et peuvent évoluer.
Product Mapping | ✅ |
Vous mappez chaque produit, option et unité Ventrata au produit Onebox 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 Onebox. Demandez-lui de le faire. |
Content Sync | ❌ |
Ventrata n'importe pas le contenu des produits depuis Onebox. Ventrata n'importe pas le contenu des produits depuis Onebox. 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 Onebox. Le fonctionnement est le suivant :
En général, avec Onebox :
Ce que cela signifie pour vous : les clients réservent sur la base des disponibilités Onebox 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 d'Onebox. Le fonctionnement est le suivant :
Onebox n'envoie que des prix nets. Avec l'option Tarification backend (Backend Pricing) cochée, Ventrata enregistre le prix net comme votre prix de revient et calcule le prix public à partir du pourcentage de coût défini sur l'opérateur dans le Ventrata Dashboard. |
Promotions Sync | ❌ |
Les promotions ne sont pas transmises à Onebox. Les promotions ne sont pas transmises à Onebox. 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 Onebox de l'opérateur. Le fonctionnement est le suivant :
Transmet les réservations de Ventrata à Onebox. Les modifications et annulations de réservations de Ventrata vers Onebox ne sont pas prises en charge.
‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Ventrata vers Onebox. Si l'opérateur modifie ou annule une réservation dans Onebox, 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 à Onebox. Les informations de prise en charge et de dépose ne sont pas transmises à Onebox. 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 à Onebox. Les réponses à vos questions de réservation ne sont pas transmises à Onebox. 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 Onebox. Les extras et options supplémentaires ne sont pas réservés dans Onebox. Seuls le produit principal, l'option et les unités le sont. |
Redemption Sync | ❌ |
Les validations et autres changements de statut dans Onebox ne sont pas renvoyés à Ventrata une fois la réservation confirmée. Les validations et autres changements de statut dans Onebox 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 Onebox. Le scan des pass sur place (walk-up) n'est pas disponible avec Onebox. |
Gift Card Sync | ❌ |
Les cartes cadeaux Ventrata ne sont pas transmises à Onebox. Les cartes cadeaux Ventrata ne sont pas transmises à Onebox. Les paiements par carte cadeau restent dans Ventrata. |
✅ pris en charge · ❌ non pris en charge
Bon à savoir : limites et détails de la connexion Onebox
Bon à savoir : limites et détails de la connexion Onebox
Disponibilités en temps réel : les disponibilités proviennent d'Onebox pendant que les clients consultent l'offre.
Réservations à sens unique : les modifications que l'opérateur effectue dans Onebox ne parviennent pas à Ventrata.
API personnalisée : l'API d'Onebox n'est pas une API OCTO : certaines fonctionnalités peuvent donc être limitées par rapport aux backends OCTO.
Onebox est un système centralisé de distribution de billets (TDS) qui donne accès à l'inventaire, aux prix et aux plans de salle numérotés d'événements de plusieurs sites via une passerelle API unique.
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.
Le Channel ID et le Client Secret ou le point de terminaison sont très probablement incorrects. 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.
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 Onebox. 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 Onebox. Si le problème persiste, contactez notre support technique.
Ressources utiles
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
ONEBOX IBERICA, S.L.
Via Augusta 21 - 23
08006 Barcelone, Espagne
ID partenaire Ventrata : 4b72f238-0436-4b6a-ae39-5849d1f7740c