Get Mappings (Ventrata → Viator, lorsque vous ouvrez la connexion dans le Dashboard) – Ventrata accède automatiquement à votre compte Viator et récupère la liste de tous les produits et options du compte, avec leur statut et leurs paramètres de connectivité. Ventrata peut le faire parce que vous l'avez invité comme système de réservation à l'étape 1.

Update Mappings (Ventrata → Viator, lorsque vous cliquez sur Mettre à jour le mappage de la connexion (Update Connection Mapping)) – Ventrata accède au produit correspondant dans votre compte Viator, vérifie les configurations de base comme les catégories de billets, supprime les disponibilités, prix et promotions (offres spéciales/deals) précédemment configurés, et met à jour le mappage dans les paramètres de connectivité selon votre sélection. Il connecte l'option Viator choisie à votre option Ventrata et applique le paramètre de synchronisation des prix du produit.

Mapping catalog (POST /v2/mappings/catalog) et Mapping connect (POST /v2/mappings/connect) (Ventrata → Viator, environ toutes les heures) – Ventrata lit vos produits et options Viator avec leur état de mappage (Mapped, Unmapped ou Paused) et envoie vos mappages à Viator. Il s'agit des API de mappage de produits de Viator.

Tour List (POST /tourlist) (Viator → Ventrata) – Viator récupère la liste des produits et options disponibles sur la connexion, avec leurs identifiants Ventrata. Viator les affiche dans l'onglet Product Connection de Viator Management Center : c'est la liste dans laquelle vous choisissez lorsque vous mappez dans Viator (méthode 2). Ventrata répond avec Get Products (GET /products) d'OCTO.

Pricing Categories (via Calendar, Viator → Ventrata) – en outre, Viator récupère les informations sur les unités (types de billets) de votre produit et leurs prix, et les met à jour en conséquence.

Viator relit votre liste de produits avec Tour List quelques fois par jour et par connexion.

La vérification des mappages par Ventrata s'exécute environ toutes les heures. Elle lit le catalogue de mappage de Viator environ toutes les 30 minutes.

Ventrata ne lit et n'écrit vos produits Viator depuis le Dashboard que lorsque vous ouvrez ou mettez à jour la connexion.

Calendar (POST /v2/availability/calendar) (Viator → Ventrata) – Viator demande une ou plusieurs options de produit sur une plage de dates. Ventrata répond avec chaque date ou heure de début réservable, son statut, la capacité restante par type de billet, l'heure limite de réservation et les prix. Viator s'en sert pour remplir le calendrier de votre page produit. Ventrata répond avec Availability Check (POST /availability) d'OCTO.

Availability Check (POST /v2/availability/check) (Viator → Ventrata) – lorsqu'un client choisit un produit, une date et une composition de voyageurs, Viator vérifie la capacité et le prix en temps réel pour ce choix précis, puis à nouveau au fil du processus de paiement. Ventrata répond avec Availability Check d'OCTO.

Event Notification (POST https://api.viator.com/v2/notification/events) (Ventrata → Viator, chaque fois que les disponibilités changent dans Ventrata, par exemple après une réservation, une annulation ou un changement de capacité ou de tarif) – Ventrata indique à Viator quelles options de produit et quelles dates ont changé, et comment : un créneau est complet ou rouvert (AVAILABILITY), sa capacité restante a changé (CAPACITY) ou son prix a changé (PRICING). Viator relit alors ces dates. Viator traite en priorité les mises à jour AVAILABILITY et PRICING.

Vérification à la réservation – lorsqu'un client commence à payer, l'appel Reserve de Viator amène Ventrata à revérifier la capacité avant de bloquer les places. Viator ne peut donc pas surréserver un créneau qui vient d'être complet.

Calendar : régulier 24 h/24, ce qui indique une synchronisation planifiée en arrière-plan plutôt que des recherches de clients en direct.

Availability Check : 24 h/24, plus intense aux heures d'achat de pointe, car il suit la navigation des clients.

Event Notification : Ventrata les envoie 24 h/24, au fur et à mesure des changements dans Ventrata.

Un petit nombre de produits plus anciens utilisent encore l'ancien appel Real-time Availability (v1.0) de Viator.

Nous n'avons pas pu mesurer jusqu'à quelle échéance Viator lit avec Calendar, car les dates figurent dans le corps de la requête.

Calendar et Availability Check (Viator → Ventrata) – chaque date ou heure de début est renvoyée avec un prix par type de billet (par exemple Adulte ou Enfant) dans votre devise. L'API de Viator prend en charge les prix par personne, les prix par personne par paliers et les prix par unité (par exemple par voiture, bateau ou groupe).

Tarification revendeur – les prix proviennent de la tarification du revendeur Viator dans Ventrata (publique, de gros/à la commission), dont hérite la connexion. L'API de Viator peut aussi transmettre un prix net par type de billet. Viator l'utilise pour les opérateurs ayant un accord de prix net.

Event Notification (PRICING, Ventrata → Viator) – lorsque le prix public d'un type de billet change, y compris en cas de nouvelles offres spéciales ou remises, Ventrata en informe Viator, et Viator relit le prix.

Reserve (Viator → Ventrata) – le blocage conserve le prix en plus des places, de sorte que le client paie le prix qui lui a été affiché.

Catégories de prix – Viator prend en charge infant, child, youth, adult et senior. Il utilise Traveler lorsqu'il n'y a pas de restriction d'âge. Les catégories doivent couvrir les âges de 0 à 99 ans, sans trou ni chevauchement.

Les prix sont renvoyés avec chaque Calendar et chaque Availability Check : Viator les obtient donc aussi souvent qu'il lit les disponibilités.

Calendar et Availability Check (Viator → Ventrata) – lorsqu'une promotion s'applique à une date, Ventrata renvoie le prix public remisé, ainsi que le prix public d'origine et l'ID de l'offre spéciale.

Special Offers (POST /v2/product/special-offers) (Viator → Ventrata) – Viator demande les détails de ces offres, comme leur nom, leur type et leurs dates de validité. Ventrata répond à partir de vos promotions Ventrata. Viator s'en sert pour afficher une étiquette d'offre spéciale sur les dates remisées. L'étiquette ne modifie pas le prix public conseillé.

Mappage depuis le Dashboard – lorsque vous mettez à jour un mappage, Ventrata supprime les offres spéciales/deals précédemment configurés sur ce produit Viator, pour que vos offres proviennent de Ventrata.

Viator appelle Special Offers 24 h/24, uniquement pour les fournisseurs dont les produits ont des promotions.

Ventrata n'envoie généralement pas d'appels Special Offers Notification. Viator récupère les offres via Calendar et Special Offers.

Chaque réservation commence par Reserve, puis Booking. Il y a plus de blocages que de réservations confirmées. C'est normal : les blocages des clients qui ne terminent pas leur paiement expirent tout simplement.

Les modifications et annulations arrivent tout au long de la journée.

Viator ne vous envoie un e-mail que lorsqu'une réservation, une modification ou une annulation via l'API échoue (procédure de secours de Viator). Les appels API réussis ne génèrent pas d'e-mail.

Redemption (POST /redemption) (Viator → Ventrata) – Viator demande le statut de validation d'une réservation confirmée et de chacun de ses voyageurs. Ventrata retrouve la réservation par sa référence avec List Bookings (GET /bookings) d'OCTO et indique si les billets ont été validés. Viator utilise la réponse pour décider si une annulation ou un remboursement doit être autorisé.

Viator vérifie le statut de validation tout au long de la journée, bien plus souvent qu'il n'envoie d'annulations.

Ventrata n'envoie pas de lui-même de mises à jour de validation à Viator.

Booking (Viator → Ventrata) – si l'option de prise en charge à l'hôtel est activée pour votre produit Viator, le client choisit son hôtel dans la liste déroulante de Viator, et Viator l'envoie dans le champ point de prise en charge de la réservation. Si vous recueillez plutôt les informations de prise en charge dans le champ des exigences particulières de Viator, elles arrivent dans ce champ.

Booking Amendment (Viator → Ventrata) – les informations d'hôtel modifiées arrivent sous forme de modification.

Les informations de prise en charge n'arrivent qu'avec les réservations et les modifications. L'API de Viator ne propose aucun appel pour lire vos points de prise en charge Ventrata, ni de champ distinct pour la dépose.

Booking (Viator → Ventrata) – les informations saisies par le client pendant le processus de réservation de Viator, comme les informations de vol et de navire de croisière, sont envoyées dans les champs questions et réponses de la réservation.

Contact du client – Viator ne partage jamais la véritable adresse e-mail du client. Il envoie le numéro de téléphone si le client en indique un.

Les questions sont configurées du côté de Viator. L'API de Viator ne propose aucun appel pour lire vos questions de réservation Ventrata.