Get Products (GET /products) – lorsque Vistra Travel configure votre connexion, puis chaque fois qu'il actualise ses fiches, il lit chaque produit activé sur la connexion, avec ses options et ses unités (types de billets comme Adulte ou Enfant).

Get Product (GET /products/{productId}) – Vistra Travel 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 Vistra Travel – Vistra Travel associe chaque option et unité Ventrata à ses propres fiches et types de billets. Votre gestionnaire de compte chez Vistra Travel s'en charge pour vous, ou vous le faites dans le portail de Vistra Travel s'il en propose un. Il vous suffit de partager la clé API de la connexion.

Vistra Travel lit votre liste complète de produits environ toutes les 11 heures.

Il relit chaque produit environ toutes les 20 minutes.

Capability octo/content – lorsque Vistra Travel 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 prestations incluses et les images.

Les modifications de contenu dans Ventrata parviennent à Vistra Travel lors de sa prochaine actualisation des produits.

Vistra Travel demande octo/content.

Availability Check (POST /availability) – Vistra Travel 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 Vistra Travel a besoin pour réserver ce créneau.

Availability Calendar (POST /availability/calendar) – renvoie un résumé par jour plutôt que chaque créneau, généralement pour indiquer les dates ouvertes dans un sélecteur de dates.

Availability Calendar Batch (POST /availability/calendar/batch) : le calendrier de nombreux produits en une seule requête, 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 : Vistra Travel 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 sont légèrement obsolètes.

Availability Check : Vistra Travel vérifie vos produits tout au long de la journée, généralement à partir de J+12 et sur 19 jours par requête, regarde jusqu'à environ un an à l'avance et revérifie le même produit et les mêmes dates environ toutes les 5 heures.

Availability Calendar : Vistra Travel vérifie vos produits tout au long de la journée, généralement à partir d'aujourd'hui et sur 8 jours par requête, regarde jusqu'à environ un an à l'avance et revérifie le même produit et les mêmes dates environ toutes les heures.

Availability Calendar Batch : Vistra Travel vérifie vos produits tout au long de la journée, généralement à partir d'aujourd'hui et sur 8 jours par requête, regarde jusqu'à environ un an à l'avance et revérifie le même produit et les mêmes dates environ toutes les 20 minutes.

Les consultations sont réparties sur la journée sans pic marqué, ce qui suggère un mélange de synchronisations planifiées et de recherches de clients en temps réel.

Capability octo/pricing – Vistra Travel demande les prix en ajoutant octo/pricing à l'en-tête Octo-Capabilities de ses requêtes. Sans cela, 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 public payé par le client et le prix net que vous facturez à Vistra Travel, tous deux issus de la tarification du revendeur dans Ventrata (prix public et prix de gros/commission).

Prix de groupe – lorsque Vistra Travel envoie aussi le nombre de personnes réservant pour chaque type d'unité, Ventrata calcule le prix exact pour ce groupe. C'est important pour les tarifs selon la taille de la réservation (Booking Size) et les autres tarifs 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.

Vistra Travel demande octo/pricing pour toutes ses consultations de disponibilités : il vend donc à vos prix Ventrata.

Vistra Travel n'envoie pas le nombre de personnes par type d'unité : les prix sont donc renvoyés par personne, et les tarifs de groupe, comme les tarifs selon la taille de la réservation (Booking Size), peuvent ne pas s'afficher correctement sur Vistra Travel.

Vistra Travel bloque les places pendant environ 30 minutes pendant que le client paie (expirationMinutes).

Une réservation Vistra Travel typique concerne environ 2 personnes.

Il est normal de voir plus de blocages que de réservations confirmées : les blocages des clients qui ne terminent pas leur paiement expirent simplement.

Vistra Travel vérifie aussi les réservations qu'il a effectuées, avec List Bookings (GET /bookings) à quelques minutes d'intervalle et Get Booking (GET /bookings/{uuid}) environ toutes les 13 heures, par exemple pour rapprocher ses données.