Get Mappings (Ventrata → Viator, wenn Sie die Verbindung im Dashboard öffnen) – Ventrata greift automatisch auf Ihr Konto bei Viator zu und ruft die Liste aller Produkte und Optionen im Konto ab, einschließlich Status und Connectivity-Einstellungen. Ventrata kann das, weil Sie Ventrata in Schritt 1 als Ihr Reservierungssystem eingeladen haben.

Update Mappings (Ventrata → Viator, wenn Sie auf Verbindungszuordnung aktualisieren (Update Connection Mapping) klicken) – Ventrata greift auf das entsprechende Produkt in Ihrem Konto bei Viator zu, prüft grundlegende Konfigurationen wie Ticketkategorien, entfernt zuvor konfigurierte Verfügbarkeiten, Preise und Werbeaktionen (Sonderangebote/Deals) und aktualisiert die Zuordnung in den Connectivity-Einstellungen gemäß Ihrer Auswahl. Dabei wird die gewählte Option auf Viator mit Ihrer Ventrata-Option verbunden und die Pricing-sync-Einstellung des Produkts angewendet.

Mapping catalog (POST /v2/mappings/catalog) und Mapping connect (POST /v2/mappings/connect) (Ventrata → Viator, etwa stündlich) – Ventrata liest Ihre Produkte und Optionen auf Viator mit ihrem Zuordnungsstatus (Mapped, Unmapped oder Paused) und sendet Ihre Zuordnungen an Viator. Dies sind die Produktzuordnungs-APIs von Viator.

Tour List (POST /tourlist) (Viator → Ventrata) – Viator ruft die Liste der in der Verbindung verfügbaren Produkte und Optionen mit ihren Ventrata-Kennungen ab. Viator zeigt sie auf dem Tab „Product Connection“ im Viator Management Center an; aus dieser Liste wählen Sie, wenn Sie in Viator zuordnen (Methode 2). Ventrata antwortet mit OCTO Get Products (GET /products).

Pricing Categories (über Calendar, Viator → Ventrata) – zusätzlich ruft Viator Details zu den Einheiten (Tickettypen) Ihres Produkts und deren Preisen ab und aktualisiert sie entsprechend.

Viator liest Ihre Produktliste mit Tour List einige Male pro Tag und Verbindung erneut ein.

Die Zuordnungsprüfung von Ventrata läuft etwa stündlich. Sie liest den Zuordnungskatalog von Viator etwa alle 30 Minuten.

Ventrata liest und schreibt Ihre Produkte auf Viator aus dem Dashboard nur dann, wenn Sie die Verbindung öffnen oder aktualisieren.

Calendar (POST /v2/availability/calendar) (Viator → Ventrata) – Viator fragt eine oder mehrere Produktoptionen für einen Datumsbereich ab. Ventrata antwortet mit jedem buchbaren Datum bzw. jeder Startzeit, dem Status, der verbleibenden Kapazität pro Tickettyp, dem Buchungsschluss und den Preisen. Viator befüllt damit den Kalender auf Ihrer Produktseite. Ventrata antwortet mit OCTO Availability Check (POST /availability).

Availability Check (POST /v2/availability/check) (Viator → Ventrata) – wenn ein Kunde ein Produkt, ein Datum und eine Zusammensetzung der Reisenden wählt, prüft Viator die Live-Kapazität und den Preis für genau diese Auswahl, und erneut, während der Kunde den Checkout durchläuft. Ventrata antwortet mit OCTO Availability Check.

Event Notification (POST https://api.viator.com/v2/notification/events) (Ventrata → Viator, immer wenn sich die Verfügbarkeit in Ventrata ändert, zum Beispiel nach einer Buchung, einer Stornierung oder einer Kapazitäts- oder Tarifänderung) – Ventrata teilt Viator mit, welche Produktoptionen und Daten sich wie geändert haben: ein Zeitfenster ist ausverkauft oder wieder verfügbar (AVAILABILITY), die verbleibende Kapazität hat sich geändert (CAPACITY) oder der Preis hat sich geändert (PRICING). Viator liest diese Daten dann erneut ein. Viator verarbeitet AVAILABILITY- und PRICING-Aktualisierungen vorrangig.

Prüfung bei der Buchung – wenn ein Kunde mit der Zahlung beginnt, veranlasst der Aufruf Reserve von Viator, dass Ventrata die Kapazität erneut prüft, bevor die Plätze reserviert werden. So kann Viator kein Zeitfenster überbuchen, das gerade ausverkauft ist.

Calendar: gleichmäßig rund um die Uhr, was eher auf eine geplante Hintergrundsynchronisierung als auf Live-Suchen von Kunden hindeutet.

Availability Check: rund um die Uhr, verstärkt zu den Haupteinkaufszeiten, da sich die Aufrufe nach dem Suchverhalten der Kunden richten.

Event Notification: Ventrata sendet diese rund um die Uhr, sobald Änderungen in Ventrata erfolgen.

Einige wenige ältere Produkte verwenden noch den veralteten Aufruf Real-time Availability (v1.0) von Viator.

Wie weit Viator mit Calendar im Voraus liest, konnten wir nicht messen, da die Daten im Request-Body übertragen werden.

Calendar und Availability Check (Viator → Ventrata) – jedes Datum bzw. jede Startzeit wird mit einem Preis pro Tickettyp (zum Beispiel Adult oder Child) in Ihrer Währung zurückgegeben. Die API von Viator unterstützt Preise pro Person, gestaffelte Preise pro Person und Einheitspreise (zum Beispiel pro Auto, Boot oder Gruppe).

Wiederverkäuferpreise – die Preise stammen aus den Preisen des Wiederverkäufers Viator in Ventrata (Verkaufspreis, Großhandel/Provision), die die Verbindung übernimmt. Die API von Viator kann zusätzlich einen Nettopreis pro Tickettyp übertragen. Viator nutzt ihn für Betreiber mit einer Nettopreisvereinbarung.

Event Notification (PRICING, Ventrata → Viator) – wenn sich der Verkaufspreis eines Tickettyps ändert, einschließlich neuer Sonderangebote oder Rabatte, informiert Ventrata Viator, und Viator liest den Preis erneut ein.

Reserve (Viator → Ventrata) – die Reservierung sichert neben den Plätzen auch den Preis, sodass der Kunde den angezeigten Preis zahlt.

Preiskategorien – Viator unterstützt Infant, Child, Youth, Adult und Senior. Ohne Altersbeschränkung wird Traveler verwendet. Die Kategorien müssen das Alter von 0 bis 99 ohne Lücken oder Überschneidungen abdecken.

Preise werden mit jedem Calendar- und Availability-Check-Aufruf zurückgegeben, sodass Viator sie so oft erhält, wie die Verfügbarkeit gelesen wird.

Calendar und Availability Check (Viator → Ventrata) – wenn für ein Datum eine Werbeaktion gilt, gibt Ventrata den rabattierten Verkaufspreis zusammen mit dem ursprünglichen Verkaufspreis und der ID des Sonderangebots zurück.

Special Offers (POST /v2/product/special-offers) (Viator → Ventrata) – Viator fragt die Details dieser Angebote ab, etwa Name, Art und Gültigkeitszeitraum. Ventrata antwortet auf Basis Ihrer Ventrata-Werbeaktionen. Viator zeigt damit an rabattierten Daten ein Sonderangebots-Label an. Das Label ändert den empfohlenen Verkaufspreis nicht.

Zuordnung aus dem Dashboard – wenn Sie eine Zuordnung aktualisieren, entfernt Ventrata zuvor für dieses Produkt auf Viator eingerichtete Sonderangebote/Deals, sodass Ihre Angebote aus Ventrata stammen.

Viator ruft Special Offers rund um die Uhr auf, nur für Anbieter, deren Produkte Werbeaktionen haben.

Ventrata sendet normalerweise keine Special Offers Notification-Aufrufe. Viator erhält Angebote über Calendar und Special Offers.

Jede Buchung beginnt mit Reserve, dann folgt Booking. Es gibt mehr Reservierungen als bestätigte Buchungen. Das ist normal: Reservierungen von Kunden, die die Zahlung nicht abschließen, laufen einfach ab.

Änderungen und Stornierungen gehen über den Tag verteilt ein.

Viator sendet Ihnen nur dann eine E-Mail, wenn eine API-Buchung, -Änderung oder -Stornierung fehlschlägt (Fallback von Viator). Erfolgreiche API-Aufrufe lösen keine E-Mail aus.

Redemption (POST /redemption) (Viator → Ventrata) – Viator fragt den Einlösestatus einer bestätigten Buchung und jedes Reisenden darin ab. Ventrata findet die Buchung über ihre Referenz mit OCTO List Bookings (GET /bookings) und antwortet, ob die Tickets eingelöst wurden. Viator entscheidet anhand der Antwort, ob eine Stornierung oder Erstattung zulässig ist.

Viator prüft den Einlösestatus über den Tag verteilt, deutlich häufiger als Stornierungen gesendet werden.

Ventrata sendet von sich aus keine Einlöseaktualisierungen an Viator.

Booking (Viator → Ventrata) – wenn das Feld für die Hotelabholung für Ihr Produkt auf Viator aktiviert ist, wählt der Kunde sein Hotel aus der Auswahlliste von Viator, und Viator sendet es im Abholpunkt-Feld der Buchung. Wenn Sie Abholdetails stattdessen im Feld für besondere Anforderungen von Viator erfassen, kommen sie dort an.

Booking Amendment (Viator → Ventrata) – geänderte Hoteldaten gehen als Änderung ein.

Abholdetails werden nur mit Buchungen und Änderungen übermittelt. Die API von Viator bietet keinen Aufruf, um Ihre Ventrata-Abholpunkte zu lesen, und kein separates Feld für das Absetzen.

Booking (Viator → Ventrata) – Informationen, die der Kunde während des Buchungsprozesses von Viator eingibt, etwa Flug- und Kreuzfahrtschiffdaten, werden in den Frage- und Antwortfeldern der Buchung gesendet.

Kundenkontakt – Viator gibt niemals die echte E-Mail-Adresse des Kunden weiter. Die Telefonnummer wird gesendet, sofern der Kunde eine angibt.

Fragen werden auf Seiten von Viator eingerichtet. Die API von Viator bietet keinen Aufruf, um Ihre Ventrata-Buchungsfragen zu lesen.