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

Civitatis lit la liste complète de vos produits environ une fois par jour.

Il relit chaque produit environ toutes les 30 minutes.

Capability octo/content – lorsque Civitatis 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 à Civitatis lors de sa prochaine actualisation des produits.

Civitatis demande octo/content.

Availability Check (POST /availability) – Civitatis 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 Civitatis 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 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 : Civitatis 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 : Civitatis vérifie vos produits tout au long de la journée, en commençant généralement 44 jours à l'avance et en couvrant une seule journée 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 4 heures.

Availability Calendar : Civitatis vérifie chaque produit environ toutes les 12 heures.

Availability Batch : Civitatis vérifie vos produits 24 h/24, en commençant généralement le jour même 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 à quelques minutes d'intervalle.

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 – Civitatis 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 à Civitatis, tous deux issus de la tarification du revendeur dans Ventrata (prix public et prix de gros/commission).

Prix de groupe – lorsque Civitatis 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.

Civitatis ne demande octo/pricing que pour une partie de ses consultations de disponibilités : toutes les fiches n'utilisent donc pas forcément vos prix Ventrata.

Civitatis envoie le nombre de personnes par type d'unité, de sorte que les prix de groupe sont calculés pour la réservation réelle.

Civitatis ne définit pas de durée de blocage : c'est donc la durée de blocage par défaut qui s'applique.

Une réservation Civitatis 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.

Civitatis vérifie aussi les réservations qu'il a effectuées, avec Get Booking (GET /bookings/{uuid}) environ toutes les 9 heures, par exemple pour rapprocher ses données.

Capability octo/pickups – Civitatis voit quelles options proposent une prise en charge et leurs points de prise en charge, et envoie avec la réservation le point de prise en charge ou l'hôtel du client.

Si un hôtel ne correspond à aucun de vos points de prise en charge, Ventrata l'enregistre avec la réservation pour que vous puissiez organiser la prise en charge.

Civitatis envoie les informations de prise en charge avec ses réservations.

Capability octo/questions – Civitatis lit les questions définies sur vos produits et envoie les réponses du client avec la réservation ; vous les retrouvez dans Ventrata.

Civitatis n'envoie généralement pas les réponses aux questions de réservation. Si vous en dépendez, par exemple pour les noms ou les régimes alimentaires, vérifiez auprès de Civitatis comment il les recueille.