Get Mappings (via l'API GraphQL du Supplier Portal de GetYourGuide) – lorsque vous ouvrez la connexion ou cliquez sur Actualiser le mappage (Refresh Mapping), Ventrata se connecte à votre compte GetYourGuide en tant qu'utilisateur Operations que vous avez ajouté à l'étape 2, et lit tous vos produits et options GetYourGuide, avec leur statut actuel et leurs paramètres de connectivité. GetYourGuide ne publie pas de documentation pour cette API ; le lien présente le concept équivalent de mappage en autonomie dans l'API OCTO de Ventrata.

Update Mappings (via l'API GraphQL du Supplier Portal de GetYourGuide) – lorsque vous cliquez sur Mettre à jour le mappage de la connexion (Update Connection Mapping), Ventrata ouvre le produit correspondant dans votre compte GetYourGuide. Il vérifie les paramètres de base (comme les catégories de billets), efface les disponibilités, prix et promotions existants, et écrit le mappage dans les paramètres de connectivité de l'option. Il désactive aussi les add-ons de l'option et synchronise immédiatement vos deals pour ce produit (voir Promotions Sync).

Product Details (GET /1/products/{productId}) – lorsqu'un External Product ID est saisi pour le premier produit que vous mappez, GetYourGuide demande à Ventrata ses informations de base, y compris votre Ventrata API Supplier ID (= ID/clé de connexion).

Products List (GET /1/suppliers/{supplierId}/products/) – avec cet ID, GetYourGuide récupère la liste des produits disponibles sur la connexion, avec leurs External Product IDs, et les affiche dans une liste déroulante pour faciliter le mappage des autres produits. Ventrata construit la liste avec Get Products (GET /products) d'OCTO : elle ne contient donc que les produits activés sur la connexion.

Pricing Categories (GET /1/products/{productId}/pricing-categories/) – GetYourGuide importe les unités de votre produit comme ses catégories de prix. Ventrata les lit avec Get Product (GET /products/{productId}) d'OCTO.

Availability Query (GET /1/get-availabilities/) – GetYourGuide vérifie qu'il y a au moins 2 créneaux ou jours disponibles dans les 365 prochains jours, que les catégories de prix (unités) renvoyées correspondent à celles configurées ou importées sur GetYourGuide, et que les prix sont valides (par exemple, pas d'incohérence de devise).

Reservation (POST /1/reserve/) – GetYourGuide effectue quelques réservations test (réservations en attente), généralement pour le nombre minimum et maximum de participants autorisé pour chaque catégorie de prix (type d'unité).

Reservation Cancellation (POST /1/cancel-reservation/) – GetYourGuide annule (libère) ensuite ces réservations test.

Les appels de mappage n'ont lieu que lorsque quelqu'un ouvre ou modifie une connexion : ils arrivent donc par courtes salves, et non selon un calendrier.

Ventrata se connecte à votre compte GetYourGuide (y compris avec la connexion en deux étapes de GetYourGuide) chaque fois qu'il lit ou enregistre vos mappages.

GetYourGuide n'appelle Product Details, Products List et Pricing Categories que lorsque quelqu'un effectue un mappage dans son Supplier Portal.

Availability Query (GET /1/get-availabilities/, GetYourGuide → Ventrata) – GetYourGuide demande un produit et une plage de dates. Ventrata répond avec chaque jour ou créneau disponible, ses places restantes, son heure limite de réservation et ses prix, et GetYourGuide les met en cache (les stocke) dans son système. En coulisses, l'adaptateur consulte votre mappage et appelle Availability Check (POST /availability) d'OCTO. GetYourGuide resynchronise à une fréquence prédéfinie, qui peut varier en fonction de nombreux facteurs :

Notify Availability Update (POST /1/notify-availability-update, Ventrata → GetYourGuide) – lorsque vos disponibilités changent en raison de nouvelles réservations dans Ventrata ou de modifications portant sur une date/un horaire précis (et non de modifications groupées), Ventrata envoie à GetYourGuide les places restantes (et les prix) mises à jour pour ce créneau. Ventrata pousse immédiatement pour les créneaux commençant dans les 90 prochains jours auxquels il reste 10 places ou moins, y compris les créneaux complets. Les autres changements arrivent chez GetYourGuide lors de sa synchronisation planifiée suivante.

Reservation (POST /1/reserve/, GetYourGuide → Ventrata) – lorsqu'un client ajoute votre produit à son panier sur GetYourGuide, Ventrata revérifie qu'il reste suffisamment de capacité et refuse le blocage dans le cas contraire. GetYourGuide ne peut donc pas surréserver un créneau, même si ses disponibilités en cache sont légèrement dépassées.

Availability Query : 24 h/24 et assez régulier, avec de légers pics en journée. En moyenne, chaque produit mappé est vérifié à quelques minutes d'intervalle.

Environ la moitié des requêtes portent sur des dates du mois à venir. Les autres vont plus loin, jusqu'à près d'un an à l'avance.

La plupart des requêtes portent sur une seule journée ; les requêtes plus longues couvrent généralement environ une semaine.

Les dates demandées incluent un décalage horaire : le fuseau horaire de votre produit a donc son importance.

Notify Availability Update : poussé 24 h/24, quelques instants après le changement qui l'a déclenché. Les envois arrivent par salves qui suivent l'activité de réservation et vos propres modifications.

Pricing Categories (GET /1/products/{productId}/pricing-categories/, GetYourGuide → Ventrata) – pendant le mappage, GetYourGuide récupère les informations sur les unités de votre produit et les met à jour (les importe) comme ses catégories de prix.

Availability Query (GET /1/get-availabilities/, GetYourGuide → Ventrata) – GetYourGuide appelle régulièrement Ventrata pour resynchroniser le prix public de chaque catégorie de billet et le met en cache, selon le même calendrier que les disponibilités. Les prix proviennent de la tarification du revendeur GetYourGuide dans Ventrata, via l'Availability Check d'OCTO.

Notify Availability Update (POST /1/notify-availability-update, Ventrata → GetYourGuide) – lorsque vos disponibilités changent en raison de nouvelles réservations dans Ventrata, de tarifs ou de modifications portant sur une date/un horaire précis (et non de modifications groupées), Ventrata envoie les prix publics mis à jour à GetYourGuide.

Booking (POST /1/book/, GetYourGuide → Ventrata) – chaque réservation contient le prix public utilisé par GetYourGuide.

Tarifs Booking Size – Ventrata et GetYourGuide calculent différemment les structures de paliers sur plusieurs unités : une seule unité mappée par produit peut donc utiliser une tarification dynamique par paliers. Les tarifs supplémentaires restent autorisés et fonctionnent, mais avec une tarification statique. Voici un exemple où l'unité Adulte a la tarification par paliers activée, tandis que les unités Enfant et Bébé restent statiques :

Il n'y a pas d'appel de tarification distinct : les prix accompagnent chaque réponse de disponibilité et chaque envoi.

GetYourGuide n'appelle Pricing Categories que pendant le mappage d'un produit.

List Deals (GET /1/deals), Delete a deal (DELETE /1/deals/{dealId}) et Create a Deal (POST /1/deals), Ventrata → GetYourGuide : pour les produits que vous mappez depuis le Ventrata Dashboard (et non depuis le portail GetYourGuide), Ventrata lit vos offres spéciales GetYourGuide et vérifie qu'elles correspondent aux promotions publiques autorisées pour votre revendeur GetYourGuide. Il le fait toutes les 60 minutes. Si quelque chose ne correspond pas, Ventrata supprime toutes les offres spéciales et les recrée pour qu'elles correspondent au Ventrata Dashboard. GetYourGuide ne propose aucun appel pour modifier un deal : chaque modification consiste donc en une suppression suivie d'un nouveau deal.

Lorsque vous enregistrez un mappage dans le Ventrata Dashboard, Ventrata synchronise aussi immédiatement les deals de ce produit.

Seules les promotions publiques de base applicables à toutes les unités avec une configuration au prorata sont actuellement prises en charge par GetYourGuide. Les autres promotions ne sont pas synchronisées.

La vérification des deals s'exécute 24 h/24, par cycles horaires, et juste après les changements de mappage.

Les suppressions et recréations sont fréquentes, car la moindre différence reconstruit les deals du produit.

Starts at

Ends at

Days Before

Notice Days

Redeemable Day

Ces quatre appels arrivent 24 h/24, au rythme des achats des clients, avec des pics en journée.

Il y a plus de blocages que de réservations. C'est normal : GetYourGuide libère presque immédiatement chaque blocage qui ne devient pas une réservation, au lieu de le laisser expirer.

Chaque modification de réservation apparaît dans Ventrata sous la forme d'une nouvelle réservation et d'une réservation annulée sous la même référence.

Si un appel de réservation échoue ou expire, GetYourGuide le relance jusqu'à 10 fois, toutes les 10 minutes (voir les relances de réservation de GetYourGuide) : une réservation peut donc parfois arriver un peu après le paiement du client.

Ticket Redemption by Booking Reference (POST /1/redeem-booking, Ventrata → GetYourGuide) – dès qu'un des billets d'une réservation est validé (même si la réservation n'est que partiellement validée), Ventrata envoie une notification de validation de la réservation à GetYourGuide. Cela peut aider à éviter les annulations et remboursements de réservations validées. Toutefois, on sait qu'actuellement GetYourGuide annule des réservations quelle que soit la notification reçue.

Ventrata signale les validations par réservation. L'appel de validation par billet de GetYourGuide n'est pas utilisé.

Ventrata examine chaque mise à jour d'une réservation GetYourGuide et n'envoie une notification que lorsque la mise à jour comprend une validation.

Les notifications suivent vos scans : elles partent 24 h/24, mais surtout en journée, à l'arrivée des visiteurs.

Créez une liste de lieux de prise en charge pour chacun de vos produits/options dans le GetYourGuide Supplier Portal. GetYourGuide ne peut pas actuellement les récupérer dans Ventrata : vous les gérez donc manuellement dans son portail.

Booking (POST /1/book/, GetYourGuide → Ventrata) – GetYourGuide envoie à Ventrata le lieu de prise en charge (l'hôtel du voyageur) avec la demande de confirmation de réservation, si cela s'applique à votre produit. À l'aide de l'API Google Maps Places, Ventrata l'associe au point de prise en charge le plus proche que vous proposez, et enregistre aussi le lieu exact dans le champ Hôtel (Hotel) de la réservation.

Les informations de prise en charge n'arrivent qu'avec l'appel Booking. GetYourGuide ne demande jamais vos points de prise en charge à Ventrata.

Mappage dans le portail GetYourGuide : lorsque vous configurez ou mappez un produit dans le portail GetYourGuide, réglez l'option Allow Add-ons sur No. Si vous la réglez sur Yes, GetYourGuide demande des données d'add-ons à l'API (Fetch Addons, GET /1/products/{productId}/addons/), ce que Ventrata refuse, ce qui entraîne des échecs de connexion.

Mappage dans le Ventrata Dashboard : les add-ons des produits mappés directement depuis le Ventrata Dashboard sont automatiquement désactivés lors de la configuration.