Passer au contenu principal

TripWorks : backend opérateur

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

TripWorks logo

 

TripWorks est une plateforme de réservation pour les opérateurs de visites, d'activités et d'attractions, utilisée surtout aux États-Unis pour les excursions aériennes et en mer, les visites touristiques et de ville, les activités d'aventure et de plein air, les attractions et les lieux de divertissement. Elle couvre la découverte, la réservation, les paiements, la planification, l'enregistrement et l'analyse, avec des agents IA de chat et d'appel qui prennent des réservations 24 h/24 et plus de 50 intégrations de distribution.

 

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

 

Pour en savoir plus sur TripWorks, consultez tripworks.com.

 

📒 REMARQUE

Chaque clé API vous connecte à un seul opérateur. Si vous revendez plusieurs opérateurs qui utilisent TripWorks, créez un opérateur distinct dans Ventrata pour chacun d'eux, avec sa propre clé API.

‼️ IMPORTANT

Le mappage indique à Ventrata pour quels produit, option et unités TripWorks demander les disponibilités et effectuer les réservations. Si les produits connectés au backend ne sont pas correctement mappés, les réservations échoueront. Une ligne de produit surlignée en rouge indique un produit mal mappé.

📗 ASTUCE

Effectuez une réservation test après le mappage et demandez à votre opérateur de confirmer qu'elle apparaît dans TripWorks.

 

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

 

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

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

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

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

 

Créer la connexion TripWorks

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

  • Chaque clé API ne vous connecte qu'à un seul opérateur.

  • 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 la demande à TripWorks pour vous. TripWorks émet une clé distincte pour chaque relation entre un revendeur et un opérateur. Demandez-lui de mettre [email protected] en copie afin que Ventrata puisse aider si nécessaire.

 

  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 TripWorks et saisissez la clé API OCTO (OCTO API Key). Conservez le point de terminaison par défaut, sauf indication contraire de TripWorks ou de votre opérateur.

  3. Saisissez le nom de l'opérateur (par exemple HeliNY) lors de la création de l'opérateur.

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

 

 

📒 REMARQUE – Chaque clé API OCTO vous connecte à un seul opérateur. Configurez chaque opérateur TripWorks 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 TripWorks, et Tarification backend (Backend Pricing) pour utiliser les prix de TripWorks.

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

📒 REMARQUE

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

 

Dans la section Opérateur et backend (Operator & Backend) du produit, attribuez l'opérateur TripWorks, cochez Backend connecté (Backend Connected) et laissez Disponibilité du backend (Backend Availability) cochée pour récupérer les disponibilités en temps réel.

 

Vous pouvez aussi cocher Tarification backend (Backend Pricing) pour récupérer les prix depuis TripWorks. Si cette case n'est pas cochée, le produit utilise la tarification définie dans Ventrata, mais les réservations sont toujours transmises à TripWorks.

 

Répétez l'opération pour chaque produit que vous revendez.

 

Mapper les produits vers TripWorks

‼️ IMPORTANT

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

  4. Cliquez sur Save Changes.

📒 REMARQUE

Les produits apparaissent sous leur nom d'expérience TripWorks. Mappez chaque unité Ventrata (par exemple Adulte, Enfant) vers l'unité TripWorks correspondante.

 

📗 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 TripWorks.

 

Gérer la connexion TripWorks

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

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

 

Fonctionnalités de la connexion en détail

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

 

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

 

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

 

Product Mapping

✅

Vous mappez chaque produit, option et unité Ventrata au produit TripWorks 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 TripWorks 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 TripWorks. Demandez-lui de le faire.

Content Sync

❌

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

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

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

  • Avec Disponibilité du backend (Backend Availability), Ventrata demande les disponibilités en temps réel à TripWorks lorsqu'un utilisateur parcourt les dates dans le Dashboard, le checkout ou d'autres canaux de vente.

 

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

Le fonctionnement est le suivant :

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

  • Avec Tarification backend (Backend Pricing), Ventrata récupère les prix depuis TripWorks en même temps que les disponibilités. Les prix incluent les taxes et frais de l'opérateur, de sorte que le prix affiché avec les disponibilités correspond au prix à la confirmation. Prix public ou net non précisé.

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

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

Les promotions ne sont pas transmises à TripWorks. 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 TripWorks 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 TripWorks.

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

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

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

Les disponibilités sont réservées dans TripWorks lorsqu'un produit est ajouté au panier, puis confirmées après le paiement, avec les coordonnées du client. Les modifications de réservation (date, heure, quantités) et les annulations effectuées dans Ventrata sont envoyées automatiquement à TripWorks.

 

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

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

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

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

Redemption Sync

❌

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

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

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

Gift Card Sync

❌

Les cartes cadeaux Ventrata ne sont pas transmises à TripWorks.

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

✅ pris en charge · ❌ non pris en charge

 

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

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

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

  • Bons/billets : TripWorks renvoie un code QR pour la réservation et pour chaque billet, et Ventrata les émet pour votre client. Le code QR renvoie au portail client TripWorks de l'opérateur, et c'est lui que l'opérateur scanne à l'arrivée.

 

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

Erreur lors de l'enregistrement de la configuration backend de l'opérateur.

L'OCTO API Key est probablement incorrecte ou pas encore active. Vérifiez-la auprès de votre opérateur. Si le problème persiste, contactez [email protected].

Le produit/l'option/l'unité que je souhaite mapper ne figure pas dans la liste déroulante.

La liste déroulante n'affiche que les produits, options et unités que l'opérateur a mis à votre disposition dans TripWorks. Demandez à votre opérateur de vérifier l'allocation de son côté.

 

Ressources utiles

 

 

Informations sur le partenaire

TripWorks, Inc.

1 High Street Ct.

Morristown, NJ 07960, United States

 

ID partenaire Ventrata : 01a159ec-f15a-73fd-96c5-917ef887269b

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