Outbox est une plateforme de billetterie cloud basée à Montréal pour les événements en direct et les salles, vendue en marque blanche avec billets numériques et wallet, placement libre et places numérotées, plans de salle en 3D, contrôle de l'inventaire et de la distribution et une API complète, en plusieurs langues et devises. L'entreprise revendique plus de 500 millions de billets vendus pour des clients comme le Centre Bell, le Cirque du Soleil, Osheaga, The O2 et des salles au Canada, aux États-Unis, au Royaume-Uni et au Mexique.
Connecter Outbox à Ventrata vous permet de revendre les produits d'opérateurs qui utilisent Outbox comme système de réservation. Ventrata lit leurs disponibilités et leurs prix en temps réel dans Outbox, et chaque réservation que vous prenez est créée directement dans le compte Outbox de l'opérateur.
Pour en savoir plus sur Outbox, consultez outbox.com.
‼️ IMPORTANT
L'API externe d'Outbox utilisée pour cette connexion est une API XML-RPC personnalisée qui ne suit pas le standard d'API OCTO, ce qui peut limiter certaines fonctionnalités et capacités.
‼️ IMPORTANT
Comme Outbox vend des places à horaire fixe, utilisez toujours la Disponibilité du backend (Backend Availability). Sans elle, des réservations peuvent être effectuées pour des créneaux qui n'existent pas ou qui sont complets dans Outbox, et elles échoueront.
📗 ASTUCE
Effectuez une réservation test après le mappage et demandez à l'opérateur de confirmer qu'elle est bien arrivée dans Outbox avec le bon créneau horaire et les bons types de billets.
Site web principal | |
Tags | Booking / Ticketing System |
Fonctionnalités de la connexion | Availability Sync · Pricing Sync · Bookings Sync |
Développé par | Ventrata (via Outbox Partner Sell API) |
Cette connexion opérateur (aussi appelée backend) vous permet de revendre les produits d'opérateurs qui utilisent Outbox comme système de réservation principal, chaque réservation étant créée directement dans Outbox. Fonctionnalités de cette connexion :
Availability Sync – les disponibilités en temps réel proviennent du compte Outbox de l'opérateur.
Pricing Sync – les prix proviennent d'Outbox, ou vous les définissez dans Ventrata.
Bookings Sync – les réservations sont transmises de Ventrata à Outbox, et Outbox émet les billets ou les bons.
L'API externe d'Outbox 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 Outbox
🔐 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 et de l'URL de l'API pour l'opérateur. Consultez les étapes ci-dessous.
Assurez-vous de recevoir les identifiants de production : l'environnement de test (staging) et la production utilisent des URL et des clés différentes, et les stocks de production sont configurés séparément de ceux de test.
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
Votre opérateur demande un nouveau canal API pour vous à son gestionnaire de compte chez Outbox, qui configure aussi les mises en vente (onsales) et les stocks que vous pouvez vendre. Outbox délivre les identifiants.
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 Outbox et saisissez la clé API et l'URL de l'API.
Saisissez la clé API : elle vous identifie comme canal de vente (revendeur) dans le système Outbox de l'opérateur et détermine les mises en vente (onsales, c'est-à-dire les produits) et la devise auxquelles vous avez accès. Chaque revendeur a besoin de sa propre clé ; les clés ne peuvent pas être partagées entre entreprises.
Saisissez l'URL de l'API : l'adresse de l'API Outbox de l'opérateur, généralement sur le domaine de billetterie de l'opérateur et se terminant par /extapi/ (par exemple https://tickets.onetimessquare.com/extapi/). Elle doit commencer par https://.
Cliquez sur Modifier ce(tte) Opérateur (Update Operator).
É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 d'Outbox, et Tarification backend (Backend Pricing) pour utiliser les prix d'Outbox.
Cliquez sur Modifier ce(tte) Produit (Update Product).
📒 REMARQUE
Outbox 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), puis Disponibilité du backend (Backend Availability) pour récupérer les créneaux et les disponibilités, et Tarification backend (Backend Pricing) pour récupérer les prix.
Mapper les produits vers Outbox
‼️ IMPORTANT
Le mappage indique à Ventrata pour quels produit, option et unités Outbox 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 Outbox correspondants dans les listes déroulantes, que Ventrata charge depuis Outbox. Ne laissez aucun champ vide.
Cliquez sur 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 Outbox.
Gérer la connexion Outbox
Mettez à jour le mappage lorsque l'opérateur modifie des produits, options ou unités dans Outbox.
Remplacez la clé sur l'opérateur si Outbox 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 à Outbox.
Fonctionnalités de la connexion en détail
Cette section s'adresse à tous ceux qui veulent savoir précisément comment fonctionne la connexion Outbox. Ici, le sens est l'inverse de celui d'une connexion revendeur : Ventrata appelle Outbox, via l'API Partner Sell d'Outbox. Pour chaque fonctionnalité, cette section explique quels appels Ventrata effectue, à quel moment, et ce que cela signifie pour vous.
En bref : Ventrata demande à Outbox 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 Outbox de l'opérateur. Outbox ne renvoie pas les modifications à Ventrata.
Les délais indiqués sont ceux généralement observés avec Outbox ; ils sont arrondis et peuvent évoluer.
Product Mapping | ✅ |
Vous mappez chaque produit, option et unité Ventrata au produit Outbox 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 Outbox. Demandez-lui de le faire. |
Content Sync | ❌ |
Ventrata n'importe pas le contenu des produits depuis Outbox. Ventrata n'importe pas le contenu des produits depuis Outbox. 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 Outbox. Le fonctionnement est le suivant :
Ce que cela signifie pour vous : les clients réservent sur la base des disponibilités Outbox 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'Outbox. Le fonctionnement est le suivant :
Outbox 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 à Outbox. Les promotions ne sont pas transmises à Outbox. 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 Outbox de l'opérateur. Le fonctionnement est le suivant :
Réservation : les places sont bloquées dans Outbox pendant la durée de blocage renvoyée par Outbox lorsqu'un produit est ajouté au panier ; chaque commande Outbox couvre un seul créneau. Confirmation : après le paiement, avec les coordonnées du client ; le prénom, le nom, l'e-mail et le pays sont obligatoires, le téléphone et le code postal sont transmis lorsqu'ils sont disponibles, et la langue du client est définie sur le français ou l'anglais selon ses paramètres régionaux. Le numéro de commande Outbox est enregistré comme Supplier Reference. Billets : un code-barres par place est émis sous forme de QR code sur chaque billet Ventrata, avec un PDF regroupant tous les billets de la commande ; les valeurs des QR codes correspondent au PDF Outbox. Modification : Outbox ne permet pas de modifier une commande existante via l'API, donc la mise à jour d'une réservation confirmée ne fait que réémettre ses billets ; pour changer la date, le créneau ou le nombre de billets, annulez et refaites la réservation. Annulation : l'annulation d'une réservation confirmée annule la commande Outbox ; l'annulation d'une réservation non confirmée (bloquée) libère les places bloquées.
‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Ventrata vers Outbox. Si l'opérateur modifie ou annule une réservation dans Outbox, 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 à Outbox. Les informations de prise en charge et de dépose ne sont pas transmises à Outbox. 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 à Outbox. Les réponses à vos questions de réservation ne sont pas transmises à Outbox. 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 Outbox. Les extras et options supplémentaires ne sont pas réservés dans Outbox. Seuls le produit principal, l'option et les unités le sont. |
Redemption Sync | ❌ |
Les validations et autres changements de statut dans Outbox ne sont pas renvoyés à Ventrata une fois la réservation confirmée. Les validations et autres changements de statut dans Outbox ne sont pas renvoyés à Ventrata une fois la réservation confirmée. Non pris en charge. Le statut de réservation dans Outbox (par exemple un billet scanné) n'est pas renvoyé à Ventrata. |
Pass Walkup Scanning Sync | ❌ |
Le scan des pass sur place (walk-up) n'est pas disponible avec Outbox. Le scan des pass sur place (walk-up) n'est pas disponible avec Outbox. |
Gift Card Sync | ❌ |
Les cartes cadeaux Ventrata ne sont pas transmises à Outbox. Les cartes cadeaux Ventrata ne sont pas transmises à Outbox. Les paiements par carte cadeau restent dans Ventrata. |
✅ pris en charge · ❌ non pris en charge
Bon à savoir : limites et détails de la connexion Outbox
Bon à savoir : limites et détails de la connexion Outbox
Disponibilités en temps réel : les disponibilités proviennent d'Outbox pendant que les clients consultent l'offre.
Réservations à sens unique : les modifications que l'opérateur effectue dans Outbox ne parviennent pas à Ventrata.
API personnalisée : l'API d'Outbox n'est pas une API OCTO : certaines fonctionnalités peuvent donc être limitées par rapport aux backends OCTO.
Billets : les QR codes et les billets PDF d'Outbox sont délivrés à vos clients.
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 et l'URL de l'API 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 Outbox. 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 Outbox. 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.
La clé API ou l'URL de l'API sont probablement incorrectes, ou des identifiants de test ont été utilisés avec une URL de production (ou inversement). Vérifiez ces informations avec votre opérateur. Si le problème persiste, contactez le support.
Le produit, l'option ou l'unité que je veux mapper n'apparaît pas dans la liste déroulante, ou la liste déroulante est vide.
Le produit, l'option ou l'unité que je veux mapper n'apparaît pas dans la liste déroulante, ou la liste déroulante est vide.
La liste déroulante est récupérée depuis Outbox en fonction des mises en vente (onsales) attribuées à votre clé API. Demandez à votre opérateur de vérifier auprès d'Outbox que les stocks sont configurés pour votre canal API dans l'environnement que vous utilisez (test et production sont configurés séparément). Si le problème persiste, contactez le support.
Des produits, options ou unités apparaissent comme « Undefined » dans les listes déroulantes de mappage.
Des produits, options ou unités apparaissent comme « Undefined » dans les listes déroulantes de mappage.
Les noms proviennent de la configuration des mises en vente de l'opérateur dans Outbox. Demandez à votre opérateur d'ajouter des titres et des descriptions de types de prix dans Outbox.
La confirmation de réservation échoue avec le message « Country code is required ».
La confirmation de réservation échoue avec le message « Country code is required ».
Outbox exige un pays pour chaque commande. Vérifiez que la page de paiement (checkout), le formulaire de réservation ou la connexion revendeur qui vend ce produit collecte le pays du client, puis réessayez.
Les prix diffèrent de ceux qu'attend l'opérateur.
Les prix diffèrent de ceux qu'attend l'opérateur.
Outbox renvoie des prix TTC qui incluent les frais de service de votre canal. Vérifiez avec votre opérateur les grilles tarifaires et les frais de service de votre canal API.
Aucun créneau n'est affiché pour une date.
Aucun créneau n'est affiché pour une date.
L'opérateur n'a aucun événement ni aucune place ouverte à la vente pour cette date dans Outbox. Vérifiez auprès de votre opérateur.
Ressources utiles
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
Outbox Technology Inc.
3575 Boulevard Saint-Laurent, Suite 705
Montréal, QC H2X 2T7, Canada
ID partenaire Ventrata : 01a06240-f33b-7362-b04f-35ed782cee0e