Exchange Code For Tokens (POST /v2/oauth2/authorizations) – Ventrata → Airbnb, einmalig, wenn Sie auf Mit Airbnb verbinden (Connect with Airbnb) und Allow klicken. Airbnb gewährt Ventrata Zugriff auf die Verwaltung von Kalender und Buchungen Ihrer Angebote auf Airbnb. Die Zugriffstoken von Airbnb sind kurzlebig, daher erneuert Ventrata diesen Zugriff automatisch im Hintergrund (Refresh Access Token, gleicher Pfad).

Get Activities (GET /v2/activities) und List all offerings (GET /v2/activities/{id}/offerings) – Ventrata → Airbnb, wenn Sie die Verbindungsseite öffnen. Ventrata liest Ihre Angebote auf Airbnb und zeigt sie links in der Zuordnungstabelle an.

Set Attributes (PUT /v2/activities/{id}/attributes) – Ventrata → Airbnb, wenn Sie auf Zuordnung aktualisieren (Update Mapping) klicken. Nach dem Lesen des Angebots sendet Ventrata die Gasttypen, die Ihre Option verkauft (Erwachsener, Kind, Kleinkind), deren Altersgrenzen aus Ihren Ventrata-Einheiten und das Mindestalter.

Set Activity Availability (PUT /v2/activities/{id}/availability) – Ventrata → Airbnb, bei Zuordnung aktualisieren (Update Mapping). Ventrata aktiviert die Verfügbarkeitssynchronisierung, wodurch Ventrata zur maßgeblichen Quelle für das Angebot wird und die Live-Prüfungen von Airbnb vor jeder Buchung aktiviert werden.

Set Offering (PUT /v2/activities/{id}/offerings/{id}) – Ventrata → Airbnb, bei Zuordnung aktualisieren (Update Mapping). Ventrata speichert die IDs Ihrer Ventrata-Verbindung, Ihres Produkts und Ihrer Option im Angebot auf Airbnb. Airbnb sendet diese IDs bei jeder Prüfung und Buchung zurück; so weiß Ventrata, welches Produkt ein Gast bucht.

Set Offering Availability (PUT …/offerings/{id}/availability) und Set Offering Pricing (PUT …/offerings/{id}/pricing) – Ventrata → Airbnb, bei Zuordnung aktualisieren (Update Mapping). Ventrata legt die angebotsweiten Gruppengrenzen, die Buchungsvorlaufzeit und den Buchungstyp fest (zum Beispiel eine gemeinsame öffentliche Buchung), sodass die von Ventrata pro Zeitfenster gesendete Kapazität und die Live-Prüfung von Ventrata bestimmen, was gebucht werden kann.

Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, am Ende von Zuordnung aktualisieren (Update Mapping). Ventrata legt Ihre Zeitfenster im Kalender von Airbnb an (siehe Availability Sync).

Zuordnungsaktualisierungen in der Warteschlange – Einige Zuordnungsaktualisierungen laufen als Hintergrundjob mit denselben Schritten. Der Job liest Ihr Produkt über die OCTO API von Ventrata mit Get Product (GET /products/{productId}).

Zuordnungsaufrufe erfolgen nur, wenn jemand eine Verbindung herstellt, eine Verbindungsseite öffnet oder auf Zuordnung aktualisieren (Update Mapping) klickt.

Zugriffserneuerungen und Zuordnungsaktualisierungen in der Warteschlange laufen rund um die Uhr im Hintergrund.

Get Instances (GET /v2/activities/{id}/instances) und Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, sobald sich die Verfügbarkeit in Ventrata ändert, zum Beispiel nach einer Buchung über einen beliebigen Kanal, einer Stornierung oder einer Änderung der Kapazität oder des Zeitplans. Ventrata liest die Zeitfenster, die Airbnb für die betroffenen Daten hat, vergleicht sie mit Ventrata und sendet nur die Unterschiede in einem Stapel: neu anzulegende Zeitfenster, Zeitfenster, deren Gästelimit (verbleibende Plätze) oder Preis sich geändert hat, und Zeitfenster, die entfernt werden, weil sie nicht mehr verfügbar sind.

Ventrata OCTO API – Um jede Aktualisierung zu ermitteln, liest der Adapter von Ventrata Ihr Produkt und Ihre aktuelle Verfügbarkeit über die eigene OCTO API von Ventrata: Get Product (GET /products/{productId}) und Availability Check (POST /availability).

Hintergrund-Resynchronisierung – Ventrata → Airbnb, rund um die Uhr. Ein geplanter Job geht die zugeordneten Angebote durch, vergleicht die Zeitfenster von Airbnb erneut mit Ventrata und korrigiert Abweichungen, wobei wiederum nur die Unterschiede gesendet werden. Einige Verfügbarkeitsaktualisierungen werden außerdem in eine Warteschlange gestellt und als Hintergrundjob gesendet.

Check Availability (GET /airbnb/endpoint/reservation) – Airbnb → Ventrata, live, bevor ein Gast zum Checkout übergeht. Airbnb sendet das Angebot, die bei der Zuordnung gespeicherten Produkt- und Options-IDs von Ventrata, die Startzeit und die Anzahl der Erwachsenen, Kinder und Kleinkinder. Ventrata ruft das Produkt mit Get Product (GET /products/{productId}) ab, prüft dieses Zeitfenster und diese Gasttypen in Echtzeit und antwortet mit Ja oder Nein. Airbnb erwartet eine Antwort innerhalb von 2 Sekunden. Lautet die Antwort Nein oder schlägt die Prüfung fehl bzw. dauert zu lange, kann der Gast nicht buchen, und Airbnb entfernt dieses Zeitfenster aus seinem Kalender.

Verfügbarkeitsübertragungen laufen rund um die Uhr, entsprechend den Buchungen und Änderungen in Ventrata. Sie decken Daten von heute bis etwa ein Jahr im Voraus ab, die meisten davon für die nächsten Wochen.

Die Hintergrund-Resynchronisierung läuft rund um die Uhr.

Check Availability erfolgt gleichmäßig rund um die Uhr, meist für Daten in den nächsten vier Wochen. Airbnb prüft viel häufiger, als Gäste buchen, daher führen die meisten Prüfungen nicht zu einer Buchung.

Set Offering Pricing (PUT /v2/activities/{id}/offerings/{id}/pricing) – Ventrata → Airbnb, bei Zuordnung aktualisieren (Update Mapping). Ventrata legt die Preiseinstellungen des Angebots fest, zum Beispiel dass es als gemeinsame öffentliche Buchung verkauft wird.

Set Attributes (PUT /v2/activities/{id}/attributes) – Ventrata → Airbnb, bei Zuordnung aktualisieren (Update Mapping). Ventrata sendet Ihre Gasttypen und Altersbereiche, damit Erwachsener, Kind und Kleinkind auf Airbnb Ihren Ventrata-Einheiten entsprechen.

Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, mit Verfügbarkeitsaktualisierungen. Muss der Preis eines Zeitfensters aktualisiert werden, sendet Ventrata den Preis für Erwachsene, Kinder und Kleinkinder für dieses Zeitfenster, sodass datums- und uhrzeitabhängige Preise in Ventrata Airbnb erreichen. Die Preise stammen aus der Preisgestaltung des Wiederverkäufers Airbnb in Ventrata.

Booking-Size-Tarife – Die Partnerstufenzahlen werden synchronisiert, wenn Sie auf Zuordnung aktualisieren (Update Mapping) klicken. Aktualisieren Sie die Produktzuordnung nach jeder Tarifänderung erneut und stellen Sie sicher, dass der Tarif für den Verkauf über die Direkte API (Direct API) aktiviert ist.

Preise werden mit den Verfügbarkeitsübertragungen übermittelt, rund um die Uhr. Die meisten Übertragungen ändern nur die verbleibenden Plätze; Preise werden mitgesendet, wenn der Preis eines Zeitfensters aktualisiert werden muss.

Angebotsweite Preiseinstellungen und Gasttypen werden nur bei Zuordnung aktualisieren (Update Mapping) gesendet.

Buchungen, Änderungen und Stornierungen gehen rund um die Uhr ein und werden jeweils sofort verarbeitet.

Jede neue Buchung erreicht Ventrata als Aufruf „Make Reservation“ und als Webhook. Ventrata ordnet beide über den Bestätigungscode von Airbnb einander zu.

Auf jede neue Buchung folgt eine Ticketnachricht.

Änderungsprüfungen (Update Reservation) sind selten.

Tickets – Ventrata → Airbnb, direkt nach jeder Buchung: der PDF-Ticketlink, der Wallet-Ticketlink und bei einigen Produkten QR-Code-Bilder, alles in den Nachrichten des Gastes auf Airbnb (siehe Bookings Sync). Gäste zeigen sie an Ihrem Eingang vor, und Sie scannen und lösen sie in Ventrata wie jedes Ventrata-Ticket ein.

Keine Einlösungsaktualisierungen – Ventrata sendet Airbnb keine Aktualisierung, wenn ein Ticket gescannt oder eingelöst wird oder wenn ein Gast nicht erscheint.

Wir sehen keine Aufrufe, die Einlösungen oder Nichterscheinen an Airbnb melden.