Exchange Code For Tokens (POST /v2/oauth2/authorizations) – Ventrata → Airbnb, une seule fois, lorsque vous cliquez sur Connect with Airbnb puis sur Allow. Airbnb donne à Ventrata l'accès à la gestion du calendrier et des réservations de vos annonces Airbnb. Les jetons d'accès d'Airbnb ont une durée de vie courte : Ventrata renouvelle donc cet accès automatiquement en arrière-plan (Refresh Access Token, même chemin).

Get Activities (GET /v2/activities) et List all offerings (GET /v2/activities/{id}/offerings) – Ventrata → Airbnb, lorsque vous ouvrez la page de la connexion. Ventrata lit vos annonces Airbnb et les affiche à gauche du tableau de mappage.

Set Attributes (PUT /v2/activities/{id}/attributes) – Ventrata → Airbnb, lorsque vous cliquez sur Mettre à jour le mappage (Update Mapping). Après avoir lu l'annonce, Ventrata envoie les types de voyageurs que votre option vend (Adulte, Enfant, Bébé), leurs limites d'âge issues de vos unités Ventrata, et l'âge minimum.

Set Activity Availability (PUT /v2/activities/{id}/availability) – Ventrata → Airbnb, lors de Mettre à jour le mappage (Update Mapping). Ventrata active la synchronisation des disponibilités, ce qui fait de Ventrata la source de référence de l'annonce et active les vérifications en temps réel d'Airbnb avant chaque réservation.

Set Offering (PUT /v2/activities/{id}/offerings/{id}) – Ventrata → Airbnb, lors de Mettre à jour le mappage (Update Mapping). Ventrata enregistre les ID de votre connexion, de votre produit et de votre option Ventrata sur l'offre Airbnb. Airbnb renvoie ces ID à chaque vérification et réservation : c'est ainsi que Ventrata sait quel produit un voyageur réserve.

Set Offering Availability (PUT …/offerings/{id}/availability) et Set Offering Pricing (PUT …/offerings/{id}/pricing) – Ventrata → Airbnb, lors de Mettre à jour le mappage (Update Mapping). Ventrata définit les limites de groupe valables pour toute l'annonce, le délai de réservation et le type de réservation (par exemple, une réservation publique partagée) : ce sont donc la capacité envoyée par Ventrata pour chaque créneau et la vérification en temps réel de Ventrata qui déterminent ce qui peut être réservé.

Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, à la fin de Mettre à jour le mappage (Update Mapping). Ventrata crée vos créneaux horaires dans le calendrier d'Airbnb (voir Availability Sync).

Mises à jour de mappage en file d'attente – certaines mises à jour de mappage s'exécutent comme une tâche en arrière-plan, avec les mêmes étapes. La tâche lit votre produit via l'API OCTO de Ventrata avec Get Product (GET /products/{productId}).

Les appels de mappage n'ont lieu que lorsque quelqu'un se connecte, ouvre une page de connexion ou clique sur Mettre à jour le mappage (Update Mapping).

Les renouvellements d'accès et les mises à jour de mappage en file d'attente s'exécutent en arrière-plan 24 h/24.

Get Instances (GET /v2/activities/{id}/instances) et Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, dès que les disponibilités changent dans Ventrata, par exemple après une réservation sur n'importe quel canal, une annulation, ou une modification de la capacité ou du planning. Ventrata lit les créneaux qu'Airbnb a pour les dates concernées, les compare avec Ventrata et n'envoie que les différences en un seul lot : les nouveaux créneaux à créer, les créneaux dont la limite de voyageurs (places restantes) ou le prix a changé, et les créneaux à supprimer parce qu'ils ne sont plus disponibles.

API OCTO de Ventrata – pour déterminer chaque mise à jour, l'adaptateur de Ventrata lit votre produit et vos disponibilités en temps réel via la propre API OCTO de Ventrata : Get Product (GET /products/{productId}) et Availability Check (POST /availability).

Resynchronisation en arrière-plan – Ventrata → Airbnb, 24 h/24. Une tâche planifiée parcourt les annonces mappées, compare à nouveau les créneaux d'Airbnb avec Ventrata et corrige ceux qui ont divergé, là encore en n'envoyant que les différences. Certaines mises à jour des disponibilités sont aussi mises en file d'attente et envoyées sous forme de tâche en arrière-plan.

Check Availability (GET /airbnb/endpoint/reservation) – Airbnb → Ventrata, en temps réel, avant qu'un voyageur ne passe au paiement. Airbnb envoie l'annonce, les ID de produit et d'option Ventrata enregistrés lors du mappage, l'heure de début et le nombre d'adultes, d'enfants et de bébés. Ventrata recherche le produit avec Get Product (GET /products/{productId}), vérifie ce créneau et ces types de voyageurs en temps réel, et répond oui ou non. Airbnb attend une réponse dans les 2 secondes. Si la réponse est non, ou si la vérification échoue ou prend trop de temps, le voyageur ne peut pas réserver, et Airbnb retire ce créneau de son calendrier.

Les envois de disponibilités s'exécutent 24 h/24, au rythme des réservations et des modifications effectuées dans Ventrata. Ils couvrent les dates d'aujourd'hui jusqu'à environ un an à l'avance, la plupart portant sur les prochaines semaines.

La resynchronisation en arrière-plan s'exécute 24 h/24.

Les appels Check Availability arrivent de manière régulière 24 h/24, surtout pour des dates des quatre prochaines semaines. Airbnb vérifie beaucoup plus souvent que les voyageurs ne réservent : la plupart des vérifications n'aboutissent donc pas à une réservation.

Set Offering Pricing (PUT /v2/activities/{id}/offerings/{id}/pricing) – Ventrata → Airbnb, lors de Mettre à jour le mappage (Update Mapping). Ventrata définit les paramètres de tarification de l'annonce, par exemple le fait qu'elle soit vendue comme réservation publique partagée.

Set Attributes (PUT /v2/activities/{id}/attributes) – Ventrata → Airbnb, lors de Mettre à jour le mappage (Update Mapping). Ventrata envoie vos types de voyageurs et vos tranches d'âge, afin que les catégories Adulte, Enfant et Bébé d'Airbnb correspondent à vos unités Ventrata.

Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, avec les mises à jour des disponibilités. Lorsque le prix d'un créneau doit être mis à jour, Ventrata envoie le prix adulte, enfant et bébé de ce créneau, afin que les prix propres à une date et à un horaire dans Ventrata parviennent à Airbnb. Les prix proviennent de la tarification du revendeur Airbnb dans Ventrata.

Tarifs Booking Size – les paliers partenaires sont synchronisés lorsque vous cliquez sur Mettre à jour le mappage (Update Mapping). Après chaque modification de tarif, mettez à nouveau à jour le mappage du produit, et assurez-vous que le tarif est ouvert à la vente via l'API directe.

Les prix sont transmis avec les envois de disponibilités, 24 h/24. La plupart des envois ne modifient que les places restantes ; les prix sont inclus lorsque le prix d'un créneau doit être mis à jour.

Les paramètres de tarification valables pour toute l'annonce et les types de voyageurs ne sont envoyés que lors de Mettre à jour le mappage (Update Mapping).

Les réservations, modifications et annulations arrivent 24 h/24, et chacune est traitée dès qu'elle se produit.

Chaque nouvelle réservation parvient à Ventrata sous forme d'appel Make Reservation et de webhook. Ventrata les associe grâce au code de confirmation Airbnb.

Un message contenant les billets suit chaque nouvelle réservation.

Les vérifications de modification (Update Reservation) sont rares.

Billets – Ventrata → Airbnb, juste après chaque réservation : le lien vers le billet PDF, le lien vers le billet wallet et, pour certains produits, des images de QR codes, le tout dans la messagerie Airbnb du voyageur (voir Bookings Sync). Les voyageurs les présentent à votre entrée, et vous les scannez et les validez dans Ventrata comme n'importe quel billet Ventrata.

Aucune mise à jour de validation – Ventrata n'envoie pas de mise à jour à Airbnb lorsqu'un billet est scanné ou validé, ni lorsqu'un voyageur ne se présente pas.

Nous ne constatons aucun appel qui signale les validations ou les non-présentations à Airbnb.