Passer au contenu principal

Local Experiences : connexion revendeur

Connectez Local Experiences à Ventrata pour synchroniser les disponibilités et les prix et recevoir les réservations instantanément.

Local Experiences logo

 

Local Experiences est une marketplace en ligne basée à Londres pour les visites et activités, qui revend l'offre des opérateurs sans organiser elle-même de visites. Elle propose des balades guidées, des billets coupe-file et de courtes expériences dans des villes européennes comme Rome, Florence, Venise, Naples, Paris, Barcelone, Lisbonne et Athènes, ainsi qu'à Dubaï. Pour les opérateurs, elle apporte des voyageurs individuels et de grands groupes qui réservent à des prix accessibles, avec des visites dans plus de 20 langues, les achats cadeaux et réservations de groupe étant gérés en plus des billets standard.

 

Connecter Local Experiences à Ventrata synchronise vos disponibilités et vos prix et transmet les réservations, modifications et annulations, avec émission automatique des billets.

 

Pour en savoir plus sur un partenariat avec Local Experiences, rendez-vous sur localexperiences.tours.

 

Site web principal

Tags

Travel Agent

Marchés de destination

🌎 Monde

Marchés sources

🌎 Monde

Spécialités

Grands groupes et achats de cadeaux à des prix accessibles

Fonctionnalités de la connexion

Availability Sync · Pricing Sync · Bookings Sync

Développé par

Local Experiences (via l'API OCTO de Ventrata)

 

Cette connexion revendeur vous permet de vendre vos produits via Local Experiences sans gérer manuellement les disponibilités, les prix et les réservations. Les fonctionnalités de cette connexion comprennent :

  • Availability Sync – Local Experiences consulte vos disponibilités en temps réel dans Ventrata.

  • Pricing Sync – Local Experiences obtient vos prix à partir de votre tarification revendeur dans Ventrata.

  • Bookings Sync – les réservations, modifications et annulations provenant de Local Experiences sont créées instantanément dans Ventrata, et les clients reçoivent des billets Ventrata.

 

Créer la connexion Local Experiences

🔐 Autorisations de rôle requises : See Connections, Modify Connections, See Connection Key

Avant de commencer :

  • Vous devez avoir un accord commercial avec Local Experiences pour qu'il vende vos produits. Pour vous renseigner sur un partenariat, contactez-le via localexperiences.tours.

  • Vous devez avoir créé Local Experiences en tant que revendeur dans Ventrata, avec sa tarification (prix public, prix de gros/commission) correctement définie. Notez que cette connexion API exige que le revendeur utilise le mode de règlement « Facturer sur mon compte » (Bill to my account).

 

  1. Dans le Ventrata Dashboard, allez dans Les liaisons → Les liaisons (Connections → Connections), cliquez sur + Nouvelle connexion (+ New Connection) et sélectionnez Local Experiences dans la liste des partenaires.

  2. Sélectionnez le revendeur Local Experiences dans la liste de vos revendeurs (il doit être créé avant la connexion). La connexion héritera de la configuration du revendeur, comme la tarification, les destinations et produits autorisés, etc.

  3. (Facultatif) Vous pouvez aussi attribuer à la connexion le nom (Name) de votre choix, ce qui peut être utile si vous prévoyez d'avoir plusieurs connexions Local Experiences et souhaitez les distinguer plus facilement par la suite.

  4. Cliquez sur le bouton Créer un(e) Connexion Octo (Create Octo Connection).

 

📗 ASTUCE

Si nécessaire, vous pouvez aussi autoriser ou exclure des produits ou des destinations au niveau de la connexion, en plus de ce que vous avez configuré sur le revendeur.

 

Mapper les produits avec Local Experiences

Transmettez de manière sécurisée la clé API OCTO affichée sur la connexion que vous avez créée à votre contact chez Local Experiences, et demandez-lui de mapper vos produits via l'API OCTO de Ventrata, avec la tarification (octo/pricing) activée. En général, l'équipe de Local Experiences s'en charge en quelques jours ouvrés au maximum.

 

Votre configuration Ventrata est terminée. Vous n'avez aucune autre étape à effectuer.

 

📗 ASTUCE

Local Experiences peut accéder à tous les produits activés sur la connexion, mais vous pouvez aussi lui fournir les identifiants de produit et d'option indiqués sur la page de la connexion lorsque vous le contactez, pour préciser ce qu'il faut mapper.

 

 

Gérer la connexion Local Experiences

  • Autoriser ou exclure des produits : limitez les destinations, produits et options auxquels Local Experiences a accès. Découvrez comment autoriser ou exclure des produits.

  • Renommez la connexion pour distinguer plusieurs connexions Local Experiences.

 

Fonctionnalités de la connexion en détail

Cette section s'adresse à tous ceux qui veulent savoir précisément comment fonctionne la connexion Local Experiences : quels appels à l'API OCTO de Ventrata Local Experiences effectue, à quel moment, et ce que cela signifie pour vous. Chaque appel renvoie à la documentation de l'API Ventrata.

 

En bref : Local Experiences récupère auprès de Ventrata tout ce dont il a besoin. Il lit vos produits, vérifie vos disponibilités et vos prix, et envoie les réservations et annulations. Ventrata ne transmet pas les modifications à Local Experiences : tout ce que vous modifiez dans Ventrata parvient à Local Experiences lors de sa vérification suivante.

 

Les délais indiqués sont ceux généralement observés pour Local Experiences, arrondis, et peuvent évoluer si Local Experiences modifie sa façon de synchroniser.

 

Product Mapping

❌

Vous ne pouvez pas mapper les produits depuis Ventrata. Local Experiences les mappe de son côté, via votre gestionnaire de compte ou le portail de Local Experiences.

Le fonctionnement est le suivant :

  • Get Products (GET /products) – lorsque Local Experiences configure votre connexion, et chaque fois qu'il actualise ses offres, il lit tous les produits activés sur la connexion, avec leurs options et leurs unités (types de billets comme Adulte ou Enfant).

  • Get Product (GET /products/{productId}) – Local Experiences relit un produit précis pour prendre en compte les modifications de ses options, unités, délais limites de réservation et paramètres.

  • Mappage du côté de Local Experiences – Local Experiences relie chaque option et unité Ventrata à sa propre offre et à ses types de billets. Votre gestionnaire de compte Local Experiences s'en charge pour vous, ou vous le faites dans le portail de Local Experiences s'il en propose un. Vous partagez uniquement la clé API de la connexion.

 

En général, avec Local Experiences :

  • Local Experiences lit votre liste complète de produits environ une fois par jour.

  • Il relit chaque produit environ une fois par jour.

 

Ce que cela signifie pour vous : Local Experiences ne peut vendre que ce qu'il a mappé. Lorsque vous ajoutez un produit, une option ou une unité dans Ventrata, Local Experiences peut le voir lors de sa prochaine actualisation, mais ne le vendra pas tant qu'il n'est pas mappé. Prévenez donc votre gestionnaire de compte Local Experiences chaque fois que vous en ajoutez un.

Content Sync

✅ / ❌

Local Experiences peut lire le contenu de vos produits, comme les descriptions et les images, depuis Ventrata.

Le fonctionnement est le suivant :

  • Capability octo/content – lorsque Local Experiences l'ajoute à l'en-tête Octo-Capabilities, Get Products (GET /products) et Get Product (GET /products/{productId}) renvoient aussi le contenu de vos produits, comme les descriptions, les points forts, les inclusions et les images.

  • Les modifications de contenu dans Ventrata parviennent à Local Experiences lors de sa prochaine actualisation des produits.

 

En général, avec Local Experiences :

  • Local Experiences demande octo/content.

Availability Sync

✅

Local Experiences consulte vos disponibilités en temps réel dans Ventrata. Ventrata ne transmet pas les changements de disponibilité à Local Experiences.

Le fonctionnement est le suivant :

  • Availability Check (POST /availability) – Local Experiences envoie un produit, une option et une date ou une plage de dates. Ventrata répond avec chaque jour ou créneau réservable, son statut (AVAILABLE, LIMITED, SOLD_OUT, CLOSED ou FREESALE), les places restantes, le délai limite de réservation et un availabilityId, dont Local Experiences a besoin pour réserver ce créneau.

  • Availability Batch (POST /availability/batch) : renvoie en une seule requête les disponibilités de nombreux produits ; appel conçu pour les synchronisations en arrière-plan.

  • Vérification à la réservation – lorsqu'un client réserve, Ventrata vérifie à nouveau la capacité avant de créer la réservation : Local Experiences ne peut donc pas surréserver un créneau qui vient d'être complet, même si les disponibilités qu'il a enregistrées ne sont pas tout à fait à jour.

 

En général, avec Local Experiences :

  • Availability Check : Local Experiences vérifie vos produits 24 h/24, en commençant généralement à la date du jour et en couvrant environ un an par requête ; il consulte les dates jusqu'à environ un an à l'avance et revérifie le même produit et les mêmes dates environ toutes les 2 heures.

  • Availability Batch : Local Experiences vérifie vos produits 24 h/24, en commençant généralement à la date du jour et en couvrant environ un an par requête ; il consulte les dates jusqu'à environ un an à l'avance et revérifie le même produit et les mêmes dates environ toutes les 20 minutes.

  • Les vérifications sont réparties uniformément sur 24 heures, ce qui indique une synchronisation planifiée en arrière-plan plutôt que des recherches de clients en direct.

 

Ce que cela signifie pour vous : lorsque vous fermez une date, modifiez la capacité ou êtes complet dans Ventrata, Local Experiences l'affiche après sa vérification suivante. Pour les dates qu'il vérifie régulièrement, le changement apparaît dans un délai d'environ 2 heures. Les dates plus éloignées sont généralement vérifiées moins souvent.

Pricing Sync

✅

Vos prix sont renvoyés à chaque vérification de disponibilité, dès que Local Experiences les demande avec la capability octo/pricing.

Le fonctionnement est le suivant :

  • Capability octo/pricing – Local Experiences demande les prix en ajoutant octo/pricing à l'en-tête Octo-Capabilities de ses requêtes. Sans elle, Ventrata envoie les disponibilités sans aucun prix.

  • Availability Check (POST /availability) – lorsque la tarification est activée, chaque jour ou créneau est renvoyé avec votre prix par unité (type de billet) : le prix retail (prix public) payé par le client et le prix net que vous facturez à Local Experiences, tous deux issus de la tarification du revendeur dans Ventrata (prix public et prix de gros/commission).

  • Prix de groupe – lorsque Local Experiences envoie aussi le nombre de personnes de chaque type d'unité qui réservent, Ventrata calcule le prix de ce groupe précis. C'est important pour les tarifs Booking Size et les autres tarifications de groupe.

  • Booking Reservation (POST /bookings) et Booking Confirmation (POST /bookings/{uuid}/confirm) – la réservation est renvoyée avec son prix public et son prix net définitifs : la réservation dans Ventrata enregistre donc toujours le prix auquel elle a été vendue.

 

En général, avec Local Experiences :

  • Local Experiences demande octo/pricing pour toutes ses vérifications de disponibilité : il vend donc à vos prix Ventrata.

  • Local Experiences n'envoie pas le nombre de personnes par type d'unité : les prix sont donc renvoyés par personne, et les tarifications de groupe comme les tarifs Booking Size peuvent ne pas s'afficher correctement sur Local Experiences.

 

‼️ IMPORTANT – Demandez l'activation de la tarification. Lorsque vous demandez à Local Experiences de mapper vos produits, demandez-lui aussi d'activer la tarification (octo/pricing), ou activez-la vous-même si vous effectuez le mappage dans le portail de Local Experiences. Sinon, elle risque d'être désactivée, et Local Experiences ne recevra pas vos prix Ventrata.

📗 ASTUCE – Si les prix sur Local Experiences semblent incorrects, vérifiez d'abord la tarification du revendeur Local Experiences dans Ventrata : c'est ce que Local Experiences lit.

Promotions Sync

❌

Vos promotions Ventrata ne s'appliquent pas sur Local Experiences.

Les prix sur Local Experiences n'incluent pas les promotions que vous créez dans Ventrata. Mettez en place vos éventuelles promotions directement avec Local Experiences.

Bookings Sync

✅

Les réservations et annulations effectuées sur Local Experiences sont créées instantanément dans Ventrata, et les clients reçoivent des billets Ventrata.

Le fonctionnement est le suivant :

  1. Blocage : Booking Reservation (POST /bookings) – lorsqu'un client commence le paiement sur Local Experiences, Local Experiences envoie le produit, l'option, le créneau choisi (availabilityId) et un élément d'unité par personne. Ventrata vérifie à nouveau la capacité et crée une réservation ON_HOLD, qui bloque les places pendant que le client paie. S'il n'y a plus de place, Ventrata refuse le blocage.

  2. Confirmation : Booking Confirmation (POST /bookings/{uuid}/confirm) – une fois le paiement accepté, Local Experiences confirme le blocage. La réservation passe à CONFIRMED dans Ventrata, et Ventrata renvoie votre référence de réservation ainsi que les billets (un par personne) ou un bon (un par réservation), selon la configuration de votre produit, chacun avec un QR code et un lien PDF. Local Experiences les remet au client, qui les présente à votre entrée comme n'importe quel billet Ventrata.

  3. Expiration : si le client ne termine pas le paiement, Local Experiences ne confirme jamais, et le blocage expire de lui-même en libérant les places.

  4. Annulation : Booking Cancellation (POST /bookings/{uuid}/cancel) – lorsqu'un client annule sur Local Experiences, Local Experiences annule la réservation dans Ventrata. Ventrata ne l'accepte que si la réservation peut encore être annulée et que le délai limite d'annulation de l'option n'est pas dépassé. Sinon, il refuse la demande, et Local Experiences doit vous contacter.

  5. Modification : Booking Update (PATCH /bookings/{uuid}) – permet à Local Experiences de modifier une réservation existante, par exemple une nouvelle date, un nouvel horaire ou un autre nombre de personnes. Certains revendeurs annulent et réservent à nouveau à la place.

 

‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Local Experiences vers Ventrata. Si vous annulez, modifiez ou refaites dans Ventrata une réservation provenant de Local Experiences, par exemple dans le Dashboard, Local Experiences n'en est pas informé. Contactez Local Experiences pour que la réservation soit également annulée ou modifiée de son côté, ou demandez au client d'annuler via Local Experiences.

Pickups/Dropoff Sync

❌

Local Experiences n'envoie pas les informations de prise en charge ou de dépose avec ses réservations.

Si vos produits incluent une prise en charge, vérifiez avec Local Experiences comment il recueille ces informations, ou organisez-la avec le client.

Custom Questions Sync

❌

Local Experiences n'envoie pas les réponses à vos questions de réservation.

Si vous utilisez des questions de réservation, par exemple pour les noms ou les régimes alimentaires, vérifiez avec Local Experiences comment il recueille ces informations.

Extras Sync

❌

Les extras et options supplémentaires ne peuvent pas être réservés via Local Experiences.

Les clients ne peuvent réserver que vos produits et options principaux sur Local Experiences. Vendez les extras séparément, par exemple à l'arrivée.

Redemption Sync

❌

Les validations ne sont pas signalées à Local Experiences.

Ventrata n'informe pas Local Experiences lorsqu'un billet est scanné ou validé. Local Experiences ne voit une validation que s'il relit la réservation depuis Ventrata.

Pass Walkup Scanning Sync

❌

Les détenteurs d'un pass Local Experiences ne peuvent pas être scannés à votre entrée sans réservation.

Les clients de Local Experiences doivent avoir effectué une réservation via Local Experiences avant leur visite.

Gift Card Sync

❌

Les cartes cadeaux Ventrata ne peuvent pas être vendues ni utilisées via Local Experiences.

Les cartes cadeaux achetées dans Ventrata ne peuvent pas être utilisées sur Local Experiences, et Local Experiences ne peut pas vendre de cartes cadeaux Ventrata.

✅ pris en charge · ✅ / ❌ limité · ❌ non pris en charge

 

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

  • Délais : les disponibilités et les prix ne parviennent à Local Experiences que lorsqu'il effectue une vérification : il y a donc toujours un léger décalage après une modification dans Ventrata.

  • Délai limite d'annulation : Local Experiences ne peut annuler via l'API qu'avant le délai limite d'annulation de votre option. Les annulations plus tardives doivent être convenues avec vous.

  • Ce que Local Experiences peut voir : uniquement les destinations, produits et options autorisés sur le revendeur et la connexion, et activés à la vente sur la source API directe (Direct API). Découvrez comment autoriser ou exclure des produits.

  • Billets : Local Experiences émet les billets ou le bon Ventrata reçus lors de la confirmation : le scan et la validation fonctionnent donc comme d'habitude.

  • Réservations test : Local Experiences peut envoyer des réservations test pendant la configuration de la connexion. Les réservations test n'utilisent pas vos disponibilités et ne sont pas facturées.

 

FAQ

Aucun produit ne s'affiche sur la page de la connexion.

Vérifiez les destinations, produits et options autorisés sur votre revendeur et votre connexion. Vérifiez ensuite que vos produits et options sont ouverts à la vente sur la source API directe. Si le problème persiste, contactez notre Support technique.

Mes produits Ventrata utilisent des tarifs Booking Size, et la tarification ne fonctionne pas correctement sur Local Experiences.

Après chaque modification de tarif, mettez à jour le mappage des produits pour que les catégories du partenaire restent synchronisées avec Ventrata. Assurez-vous que le tarif est ouvert à la vente via l'API directe.

 

 

Informations sur le partenaire

LOCAL EXPERIENCES LTD

20 Wenlock Road, London, England, N1 7GU

United Kingdom

 

ID partenaire Ventrata : e79dc9d6-619e-4dc9-a995-09295960c72b

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