Passer au contenu principal

Zaui : backend opérateur

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

Zaui logo

 

Zaui est une plateforme de réservation basée à Vancouver pour les opérateurs de visites, d'activités, de transport et de location, active depuis 1999 et conçue pour un inventaire par siège et par créneau horaire. Elle est particulièrement forte auprès des entreprises de transport : navettes, autocars interurbains, transferts aéroport et port de croisière, services de bateaux, en plus des excursions et des circuits de plusieurs jours, avec gestion des canaux, tarification dynamique et enregistrement mobile depuis un seul tableau de bord.

 

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

 

Pour en savoir plus sur Zaui, consultez zaui.com.

 

📒 REMARQUE

Vous souhaitez plutôt que Zaui revende vos produits ? Consultez Zaui : connexion revendeur.

 

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 Zaui)

 

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

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

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

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

 

Créer la connexion Zaui

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

  • 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 l'OCTO API Key à votre opérateur. Les opérateurs peuvent configurer la connexion (canal) et obtenir la clé dans Zaui sous Resellers > Channel Partners, puis sélectionner Ventrata.

 

  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 Zaui et saisissez l'OCTO API Key. Laissez le point de terminaison par défaut https://api.zaui.io/octo, sauf indication contraire de l'opérateur ou de Zaui.

  3. Laissez le champ Point de terminaison OCTO (OCTO Endpoint) à sa valeur Zaui pré-remplie, sauf indication contraire de l'opérateur ou de Zaui.

  4. Press Update Operator.

 

 

Dans la section Partenaire backend (Backend Partner), choisissez Zaui 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 Zaui, laissez dans le champ Point de terminaison OCTO (OCTO Endpoint) la valeur par défaut pré-remplie pour Zaui

 

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

 

Étape 2 : 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 Zaui, et Tarification backend (Backend Pricing) pour utiliser les prix de Zaui.

  3. Press Update Product.

📒 REMARQUE

Zaui envoie à la fois les prix publics et les prix nets. Lorsque l'option Tarification backend (Backend Pricing) est cochée, Ventrata enregistre le prix public comme prix de vente et le prix net comme prix de revient, quel que soit le pourcentage de coût défini sur l'opérateur.

 

Cochez Disponibilité du backend (Backend Availability) pour récupérer les disponibilités depuis Zaui, et Tarification backend (Backend Pricing) pour récupérer les prix.

 

Sans ces options, le produit utilise les disponibilités et les prix définis dans Ventrata, mais transmet toujours les réservations à Zaui.

 

Cochez Backend connecté (Backend Connected) pour que ce produit utilise la connexion API (backend). Pour récupérer les disponibilités depuis Zaui, 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 à Zaui. Cliquez sur Modifier ce(tte) Produit (Update Product) pour enregistrer.

 

Mapper les produits vers Zaui

‼️ IMPORTANT

Le mappage indique à Ventrata pour quels produit, option et unités Zaui 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 Zaui correspondants dans les listes déroulantes, que Ventrata charge depuis Zaui. Ne laissez aucun champ vide.

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

 

Gérer la connexion Zaui

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

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

 

Fonctionnalités de la connexion en détail

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

 

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

 

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

 

Product Mapping

✅

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

Le fonctionnement est le suivant :

  • Get Products (GET /products) – Ventrata lit les produits, options et unités Zaui de l'opérateur pour remplir les listes déroulantes de l'onglet Mappages (Mappings).

 

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

Content Sync

❌

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

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

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 Zaui en temps réel pour les dates affichées.

  • Lorsque l'option Disponibilité du backend (Backend Availability) est activée, Ventrata envoie une requête en temps réel à Zaui lorsqu'un utilisateur interagit avec le calendrier des disponibilités (Dashboard, Web Checkout, terminal, etc.). Les requêtes portent généralement sur une période de 7 jours ou sur un jour précis. Tant que l'utilisateur n'interagit pas avec le calendrier, celui-ci peut afficher des données en cache, non actualisées, issues de la requête précédente.

 

En général, avec Zaui :

  • Les requêtes couvrent 7 jours à la fois, d'aujourd'hui jusqu'à environ un an à l'avance, au fil de la navigation et lorsque Ventrata charge le calendrier.

 

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

Le fonctionnement est le suivant :

  • Availability Check avec la capacité octo/pricing – Ventrata demande les prix à Zaui à chaque requête de disponibilité.

  • Lorsque l'option Tarification backend (Backend Pricing) est activée, Ventrata récupère depuis Zaui, dans la même requête de disponibilité en temps réel, à la fois les prix publics et les prix nets (de gros). Les prix sont affichés à l'utilisateur et mis en cache/enregistrés dans Ventrata comme tarifs générés par l'API. Les prix nets sont enregistrés comme prix de revient, quel que soit le pourcentage de coût 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 à Zaui.

Zaui envoie à la fois les prix publics et les prix nets. Lorsque l'option Tarification backend (Backend Pricing) est cochée, Ventrata enregistre le prix public comme prix de vente et le prix net comme prix de revient, quel que soit le pourcentage de coût défini sur l'opérateur.

Promotions Sync

❌

Les promotions ne sont pas transmises à Zaui.

Les promotions ne sont pas transmises à Zaui. 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 Zaui de l'opérateur.

Le fonctionnement est le suivant :

  1. Blocage : Booking Reservation (POST /bookings) – lorsque le produit est ajouté au panier dans Ventrata, Ventrata réserve les places dans Zaui.

  2. Confirmation : Booking Confirmation (POST /bookings/{uuid}/confirm) – après le paiement, Ventrata confirme la réservation dans Zaui avec les coordonnées du client, et le billet ou le bon renvoyé par Zaui devient le billet ou le bon Ventrata.

  3. Modification : Booking Update (PATCH /bookings/{uuid}) – les modifications effectuées dans Ventrata sont transmises à Zaui.

  4. Annulation : Booking Cancellation (POST /bookings/{uuid}/cancel) – les annulations effectuées dans Ventrata sont transmises à Zaui.

Blocage lorsqu'un produit est ajouté au panier. Confirmation après le paiement, avec envoi des coordonnées du client ; le bon ou billet de Zaui est intégré dans Ventrata (sauf PDF_FILE, que Ventrata ne prend pas en charge). Les modifications et annulations effectuées dans Ventrata sont transmises à Zaui.

 

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

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

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

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

Redemption Sync

❌

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

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

Non pris en charge. Le statut de réservation dans Zaui, par exemple validée (Redeemed), 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 Zaui.

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

Gift Card Sync

❌

Les cartes cadeaux Ventrata ne sont pas transmises à Zaui.

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

✅ pris en charge · ❌ non pris en charge

 

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

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

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

 

FAQ

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.

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

J'obtiens une erreur lors de l'enregistrement de 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 le support.

Il n'y a pas de case Backend connecté (Backend Connected) dans les paramètres du produit.

L'opérateur sélectionné sur le produit n'a très probablement aucun backend configuré. Vérifiez la configuration du backend et réessayez. Si le problème persiste, contactez le support.

 

Ressources utiles

 

 

Informations sur le partenaire

Zaui Software Ltd.

Suite 423 - 119 Pender Street West

Vancouver, BC V6B 1S5, Canada

 

ID partenaire Ventrata : 09fc078e-fea1-4519-92d4-5eef643ca954

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