Passer au contenu principal

Clorian : backend opérateur

Connectez Clorian à Ventrata pour revendre les produits des opérateurs Clorian avec des disponibilités, des prix et des réservations en temps réel.

Clorian logo

 

Clorian est une plateforme de billetterie basée à Barcelone pour les musées, monuments et lieux culturels, qui gère les ventes en ligne et sur place, les jauges par créneau horaire et le contrôle d'accès de sites comme la Sagrada Família, La Pedrera et la Mosquée-Cathédrale de Cordoue. Elle revendique plus de 28 millions de billets vendus par an via ses sites et un réseau de plus de 14 000 revendeurs.

 

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

 

Pour en savoir plus sur Clorian, consultez clorian.com.

 

📒 REMARQUE

Si votre inventaire de produits nécessite les deux modes de paiement (paiement différé et prépaiement), créez deux opérateurs distincts dans Ventrata pour traiter correctement les paiements.

‼️ IMPORTANT

Le mappage indique à Ventrata pour quel produit Clorian demander les disponibilités. Si des produits connectés au backend ne sont pas correctement mappés, leurs réservations échoueront. Une ligne de produit surlignée en rouge signifie que le produit n'est pas correctement mappé.

 

Site web principal

Tags

Booking / Ticketing System

Fonctionnalités de la connexion

Availability Sync · Pricing Sync · Bookings Sync

Développé par

Ventrata (via Clorian B2B API)

 

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

  • Availability Sync – les disponibilités en temps réel proviennent du compte Clorian de l'opérateur.

  • Pricing Sync – les prix proviennent de Clorian, ou vous les définissez dans Ventrata.

  • Bookings Sync – les réservations sont transmises de Ventrata à Clorian, et Clorian émet les billets ou les bons.

 

L'API externe de Clorian 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 Clorian

🔐 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 l'API Key, du nom d'utilisateur et du mot de passe de l'opérateur. Suivez les étapes ci-dessous.

  • Un accord commercial avec l'opérateur dont vous souhaitez revendre les produits via Clorian.

  • Les produits Clorian recréés dans Ventrata, en respectant exactement la configuration Clorian.

  • 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 : obtenir vos identifiants Clorian

Contactez Clorian et demandez votre API Key ainsi que votre nom d'utilisateur et votre mot de passe Clorian.

 

  • API Key

  • Username

  • Password

 

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

Contactez Clorian et demandez votre API Key, ainsi que votre nom d'utilisateur et votre mot de passe Clorian.

 

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

  2. Dans la section Partenaire backend (Backend Partner), sélectionnez Clorian et saisissez l'API Key, le nom d'utilisateur et le mot de passe.

  3. Dans le champ Partenaire backend (Backend Partner), sélectionnez Clorian.

  4. Saisissez l'API Key, le nom d'utilisateur et le mot de passe reçus de Clorian (obligatoire).

  5. Facultatif : choisissez le mode de paiement de vos produits : paiement différé (Deferred Payment, par défaut chez Clorian, facturé ultérieurement) ou prépaiement (Pre-payment, acompte).

  6. Cliquez sur Create Operator.

  7. Cliquez sur Modifier ce(tte) Opérateur (Update Operator).

 

 

 

Étape 3 : connectez chaque produit

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

  2. Cochez Backend connecté (Backend Connected). Cochez Disponibilité du backend (Backend Availability) pour utiliser les disponibilités de Clorian, et Tarification backend (Backend Pricing) pour utiliser les prix de Clorian.

  3. Cliquez sur Modifier ce(tte) Produit (Update Product).

📒 REMARQUE

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

 

Sur le produit, 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 de Clorian.

 

Click Update Product.

 

 

Mapper les produits vers Clorian

‼️ IMPORTANT

Le mappage indique à Ventrata pour quels produit, option et unités Clorian 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é.

 

  1. Dans le Ventrata Dashboard, accédez à Produits → Produits (Products → Products) et ouvrez le produit.

  2. Ouvrez l'onglet Mappages (Mappings). Il apparaît dès que le produit est défini sur Backend connecté (Backend Connected).

  3. Pour chaque option et unité Ventrata, sélectionnez le produit, l'option et les unités Clorian correspondants dans les listes déroulantes, que Ventrata charge depuis Clorian. Ne laissez aucun champ vide.

  4. 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 Clorian.

 

Gérer la connexion Clorian

  • Mettez à jour le mappage lorsque l'opérateur modifie des produits, options ou unités dans Clorian.

  • Remplacez la clé sur l'opérateur si Clorian 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 à Clorian.

 

Fonctionnalités de la connexion en détail

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

 

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

 

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

 

Product Mapping

✅

Vous mappez chaque produit, option et unité Ventrata au produit Clorian de l'opérateur dans le Ventrata Dashboard.

Le fonctionnement est le suivant :

  • Produits – Ventrata lit les produits, options et unités Clorian de l'opérateur pour remplir les listes déroulantes de l'onglet Mappages (Mappings).

  • Chemins observés : GET /v2/clients, GET /v2/products/{n}.

 

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 Clorian. Demandez-lui de le faire.

Content Sync

❌

Ventrata n'importe pas le contenu des produits depuis Clorian.

Ventrata n'importe pas le contenu des produits depuis Clorian. 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 Clorian.

Le fonctionnement est le suivant :

  • Disponibilités – lorsque quelqu'un utilise le calendrier des disponibilités dans Ventrata, par exemple dans le Dashboard, votre Web Checkout ou un terminal, Ventrata interroge Clorian en temps réel pour les dates affichées.

  • Disponibilités en temps réel synchronisées depuis Clorian.

  • Chemins observés : GET /v2/products/{n}, GET /v2/products/{n}/events.

 

Ce que cela signifie pour vous : les clients réservent sur la base des disponibilités Clorian 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 Clorian.

Le fonctionnement est le suivant :

  • Prix fixes synchronisés depuis Clorian, hors prix promotionnels. Repris lorsque l'option Tarification backend (Backend Pricing) est cochée sur le produit.

  • 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 à Clorian.

Clorian 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 à Clorian.

Les promotions ne sont pas transmises à Clorian. Vos promotions Ventrata s'appliquent toujours au prix que votre client paie dans Ventrata.

Non pris en charge : les produits avec promotions, y compris les promotions via l'API.

Bookings Sync

✅

Les réservations effectuées dans Ventrata pour un produit connecté au backend sont créées dans le compte Clorian de l'opérateur.

Le fonctionnement est le suivant :

  1. Blocage et confirmation : lorsque le produit est ajouté au panier, Ventrata vérifie la réservation auprès de Clorian, puis, après le paiement, crée la réservation dans le compte Clorian de l'opérateur avec les coordonnées du client.

  2. Billets : la référence ou les billets renvoyés par Clorian sont enregistrés sur la réservation Ventrata.

  3. Appels observés : Confirm Booking, Create Booking.

Les réservations et les annulations sont transmises de Ventrata à Clorian. Les modifications de réservations de Ventrata vers Clorian ne sont pas prises en charge.

 

‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Ventrata vers Clorian. Si l'opérateur modifie ou annule une réservation dans Clorian, 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 à Clorian.

Les informations de prise en charge et de dépose ne sont pas transmises à Clorian. 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 à Clorian.

Les réponses à vos questions de réservation ne sont pas transmises à Clorian. 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 Clorian.

Les extras et options supplémentaires ne sont pas réservés dans Clorian. Seuls le produit principal, l'option et les unités le sont.

Redemption Sync

❌

Les validations et autres changements de statut dans Clorian ne sont pas renvoyés à Ventrata une fois la réservation confirmée.

Les validations et autres changements de statut dans Clorian 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 Clorian.

Le scan des pass sur place (walk-up) n'est pas disponible avec Clorian.

Gift Card Sync

❌

Les cartes cadeaux Ventrata ne sont pas transmises à Clorian.

Les cartes cadeaux Ventrata ne sont pas transmises à Clorian. Les paiements par carte cadeau restent dans Ventrata.

✅ pris en charge · ❌ non pris en charge

 

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

  • Disponibilités en temps réel : les disponibilités proviennent de Clorian pendant que les clients consultent l'offre.

  • Réservations à sens unique : les modifications que l'opérateur effectue dans Clorian ne parviennent pas à Ventrata.

  • API personnalisée : l'API de Clorian n'est pas une API OCTO : certaines fonctionnalités peuvent donc être limitées par rapport aux backends OCTO.

  • Clorian est une plateforme de billetterie pour les grands sites et lieux culturels, qui traite plus de 32 millions de billets par an avec un réseau de plus de 14 000 distributeurs.

  • Mode de paiement par opérateur : paiement différé (Deferred Payment, par défaut chez Clorian) ou prépaiement (Pre-payment, acompte).

 

FAQ

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

L'API Key, le nom d'utilisateur et le mot de passe 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.

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 mis à votre disposition dans Clorian. Adressez-vous à l'opérateur. 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 Clorian. Si le problème persiste, contactez notre support technique.

 

Ressources utiles

 

 

Informations sur le partenaire

Tiqueteo Spain, S.L.

Carrer de Veneçuela, 103, 1, Sant Martí

08019 Barcelone, Espagne

 

ID partenaire Ventrata : b4dc43c9-5155-4d6c-8861-a73a83fce30d

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