FareHarbor, filiale de Booking Holdings, est une plateforme de réservation et de gestion d'entreprise utilisée par plus de 20 000 entreprises de visites, d'activités, de location et d'attractions, surtout adoptée par les petits et moyens opérateurs d'Amérique du Nord et d'Europe. Son offre couvre la vente en ligne et sur place, la gestion de l'inventaire, les paiements, les événements privés, le reporting, la planification du personnel, une application mobile et des programmes partenaires pour les affiliés et les API.
Connecter FareHarbor à Ventrata vous permet de revendre les produits d'opérateurs qui utilisent FareHarbor comme système de réservation. Ventrata lit leurs disponibilités et leurs prix en temps réel dans FareHarbor, et chaque réservation que vous prenez est créée directement dans le compte FareHarbor de l'opérateur.
Pour en savoir plus sur FareHarbor, consultez fareharbor.com.
📒 REMARQUE
Vous souhaitez plutôt que FareHarbor revende vos produits ? Consultez FareHarbor : connexion revendeur.
‼️ IMPORTANT
FareHarbor vous facture, en tant que distributeur ou revendeur, des frais pour l'utilisation de cette connexion. Pour plus de détails, contactez directement FareHarbor. Ventrata ne facture aucun frais supplémentaire pour cette connexion.
Site web principal | |
Tags | Booking / Ticketing System |
Fonctionnalités de la connexion | Availability Sync · Pricing Sync · Bookings Sync |
Développé par | Ventrata (via FareHarbor External API) |
Cette connexion opérateur (aussi appelée backend) vous permet de revendre les produits d'opérateurs qui utilisent FareHarbor comme système de réservation principal, chaque réservation étant créée directement dans FareHarbor. Fonctionnalités de cette connexion :
Availability Sync – les disponibilités en temps réel proviennent du compte FareHarbor de l'opérateur.
Pricing Sync – les prix publics et nets proviennent de FareHarbor, ou vous définissez les prix dans Ventrata.
Bookings Sync – les réservations sont transmises de Ventrata à FareHarbor, et FareHarbor émet les billets ou les bons.
L'API externe de FareHarbor 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 FareHarbor
🔐 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 d'un accord de distribution avec FareHarbor et de votre User Key FareHarbor. Consultez l'étape 1.
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 : s'inscrire comme distributeur FareHarbor
Si vous ne vous êtes encore jamais connecté à un opérateur FareHarbor, écrivez à [email protected] en mettant en copie [email protected] et [email protected] pour demander un accord de distribution. Indiquez :. Précisez que vous utilisez Ventrata.
Le nom commercial, le numéro de TVA et l'adresse de votre entreprise
Le nom complet, l'adresse e-mail et la fonction du signataire
Les opérateurs FareHarbor avec lesquels vous souhaitez vous connecter
Les pages de votre site web où vous prévoyez de vendre leurs produits (le cas échéant)
Le fait que vous utilisez Ventrata
Une fois l'accord en place, [email protected] ou [email protected] vous envoie votre User Key FareHarbor. Si vous vous êtes déjà connecté à des opérateurs FareHarbor, vous en avez déjà une.
Étape 2 : configurer l'opérateur dans Ventrata
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 FareHarbor et saisissez la clé. Laissez le champ du point de terminaison par défaut, sauf indication contraire de l'opérateur.
Cliquez sur Modifier ce(tte) Opérateur (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 de FareHarbor, et Tarification backend (Backend Pricing) pour utiliser les prix de FareHarbor.
Cliquez sur Modifier ce(tte) Produit (Update Product).
📒 REMARQUE
FareHarbor 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.
Mapper les produits vers FareHarbor
‼️ IMPORTANT
Le mappage indique à Ventrata pour quels produit, option et unités FareHarbor 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 dans les listes déroulantes l'item et les types de clients FareHarbor correspondants, que Ventrata charge depuis FareHarbor. 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 FareHarbor.
Gérer la connexion FareHarbor
Mettez à jour le mappage lorsque l'opérateur modifie des produits, options ou unités dans FareHarbor.
Remplacez la clé sur l'opérateur si FareHarbor 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 à FareHarbor.
Fonctionnalités de la connexion en détail
Cette section s'adresse à tous ceux qui veulent savoir précisément comment fonctionne la connexion FareHarbor. Ici, le sens est l'inverse de celui d'une connexion revendeur : Ventrata appelle FareHarbor, via l'External API de FareHarbor. Pour chaque fonctionnalité, cette section explique quels appels Ventrata effectue, à quel moment, et ce que cela signifie pour vous.
En bref : Ventrata demande à FareHarbor 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 FareHarbor de l'opérateur. FareHarbor ne renvoie pas les modifications à Ventrata.
Les délais indiqués sont ceux généralement observés avec FareHarbor ; ils sont arrondis et peuvent évoluer.
Product Mapping | ✅ |
Vous mappez chaque produit, option et unité Ventrata vers l'item FareHarbor de l'opérateur dans le Ventrata Dashboard. Le fonctionnement est le suivant :
Ce que cela signifie pour vous : si un item ou un type de client manque dans la liste déroulante, c'est que l'opérateur ne l'a pas mis à votre disposition dans FareHarbor. Demandez-lui de le faire. |
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 FareHarbor. Le fonctionnement est le suivant :
En général, avec FareHarbor :
Ce que cela signifie pour vous : les clients réservent toujours sur la base des disponibilités FareHarbor en temps réel de l'opérateur. |
Pricing Sync | ✅ |
Avec l'option Tarification backend (Backend Pricing) activée, Ventrata reprend les tarifs FareHarbor de l'opérateur, publics et nets, à partir des disponibilités. Le fonctionnement est le suivant :
FareHarbor 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. |
Bookings Sync | ✅ / ❌ |
Les réservations effectuées dans Ventrata sont créées dans FareHarbor. FareHarbor n'a pas d'étape de blocage, et les annulations doivent être vérifiées auprès de l'opérateur. Le fonctionnement est le suivant :
‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Ventrata vers FareHarbor. Si l'opérateur modifie ou annule une réservation dans FareHarbor, Ventrata n'en est pas informé. Demandez à l'opérateur de vous signaler toute modification qu'il effectue. 📒 REMARQUE – Comme FareHarbor ne bloque pas les places pendant le paiement, un créneau peut être complet dans FareHarbor pendant que votre client paie. Ventrata vérifie à nouveau avant de créer la réservation et l'arrête s'il n'y a plus de place. |
Content Sync | ❌ |
Ventrata n'importe pas le contenu des produits depuis FareHarbor. Ventrata n'importe pas le contenu des produits depuis FareHarbor. Vous créez et décrivez vous-même les produits dans Ventrata. |
Promotions Sync | ❌ |
Les promotions ne sont pas transmises à FareHarbor. Les promotions ne sont pas transmises à FareHarbor. Vos promotions Ventrata s'appliquent toujours au prix que votre client paie dans Ventrata. |
Pickups/Dropoff Sync | ❌ |
Les informations de prise en charge et de dépose ne sont pas transmises à FareHarbor. Les informations de prise en charge et de dépose ne sont pas transmises à FareHarbor. 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 à FareHarbor. Les réponses à vos questions de réservation ne sont pas transmises à FareHarbor. 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 FareHarbor. Les extras et options supplémentaires ne sont pas réservés dans FareHarbor. Seuls le produit principal, l'option et les unités le sont. |
Redemption Sync | ❌ |
Les validations et autres changements de statut dans FareHarbor ne sont pas renvoyés à Ventrata une fois la réservation confirmée. Les validations et autres changements de statut dans FareHarbor 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 FareHarbor. Le scan des pass sur place (walk-up) n'est pas disponible avec FareHarbor. |
Gift Card Sync | ❌ |
Les cartes cadeaux Ventrata ne sont pas transmises à FareHarbor. Les cartes cadeaux Ventrata ne sont pas transmises à FareHarbor. Les paiements par carte cadeau restent dans Ventrata. |
✅ pris en charge · ✅ / ❌ limité · ❌ non pris en charge
Bon à savoir : limites et détails de la connexion FareHarbor
Bon à savoir : limites et détails de la connexion FareHarbor
Frais : FareHarbor facture les distributeurs pour cette connexion. Ventrata, non.
Pas de blocage dans FareHarbor : les places ne sont bloquées que dans Ventrata pendant le paiement, et Ventrata revérifie les disponibilités avant de réserver.
API personnalisée : l'External API de FareHarbor n'est pas une API OCTO ; certaines fonctionnalités peuvent donc être limitées par rapport aux backends OCTO.
Réservations à sens unique : les modifications que l'opérateur effectue dans FareHarbor ne parviennent pas à Ventrata.
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.
Votre User Key FareHarbor est très probablement incorrecte. Vérifiez-la et, 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 les items et types de clients que l'opérateur a mis à votre disposition dans FareHarbor. Vérifiez auprès de 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 FareHarbor. Si le problème persiste, contactez notre support technique.
Ressources utiles
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
FareHarbor B.V.
Vijzelstraat 66-80
1017 HL Amsterdam, Pays-Bas
ID partenaire Ventrata : 11496205-33a3-470e-9449-13f00f85c8d5