Get Mappings (über die Supplier Portal GraphQL API von GetYourGuide) – wenn Sie die Verbindung öffnen oder auf Zuordnung neu laden (Refresh Mapping) klicken, meldet sich Ventrata als der Operations-Benutzer, den Sie in Schritt 2 hinzugefügt haben, bei Ihrem Konto bei GetYourGuide an und liest alle Ihre Produkte und Optionen auf GetYourGuide mit ihrem aktuellen Status und ihren Connectivity-Einstellungen. GetYourGuide veröffentlicht keine Dokumentation zu dieser API; der Link zeigt das entsprechende Self-Service-Zuordnungskonzept in der OCTO API von Ventrata.

Update Mappings (über die Supplier Portal GraphQL API von GetYourGuide) – wenn Sie auf Verbindungszuordnung aktualisieren (Update Connection Mapping) klicken, öffnet Ventrata das entsprechende Produkt in Ihrem Konto bei GetYourGuide. Ventrata prüft grundlegende Einstellungen (etwa Ticketkategorien), entfernt bestehende Verfügbarkeiten, Preise und Werbeaktionen und schreibt die Zuordnung in die Connectivity-Einstellungen der Option. Außerdem werden Add-ons für die Option deaktiviert und Ihre Deals für dieses Produkt sofort synchronisiert (siehe Promotions Sync).

Product Details (GET /1/products/{productId}) – wenn für das erste Produkt, das Sie zuordnen, eine External Product ID eingegeben wird, fragt GetYourGuide bei Ventrata dessen Grunddaten ab, einschließlich Ihrer Ventrata API Supplier ID (= Verbindungs-ID/-Schlüssel).

Products List (GET /1/suppliers/{supplierId}/products/) – mit dieser ID ruft GetYourGuide die Liste der in der Verbindung verfügbaren Produkte mit ihren External Product IDs ab und zeigt sie in einer Auswahlliste an, um die Zuordnung weiterer Produkte zu erleichtern. Ventrata erstellt die Liste mit OCTO Get Products (GET /products), sodass sie nur Produkte enthält, die in der Verbindung aktiviert sind.

Pricing Categories (GET /1/products/{productId}/pricing-categories/) – GetYourGuide importiert die Einheiten Ihres Produkts als eigene Preiskategorien. Ventrata liest sie mit OCTO Get Product (GET /products/{productId}).

Availability Query (GET /1/get-availabilities/) – GetYourGuide prüft, ob es in den nächsten 365 Tagen mindestens 2 verfügbare Zeitfenster oder Tage gibt, ob die zurückgegebenen Preiskategorien (Einheiten) mit den auf GetYourGuide konfigurierten oder importierten übereinstimmen und ob die Preise gültig sind (zum Beispiel keine abweichende Währung).

Reservation (POST /1/reserve/) – GetYourGuide nimmt einige Testreservierungen (ausstehende Buchungen) vor, in der Regel für die minimal und maximal zulässige Teilnehmerzahl je Preiskategorie (Einheitentyp).

Reservation Cancellation (POST /1/cancel-reservation/) – GetYourGuide storniert diese Testreservierungen anschließend und gibt die Plätze wieder frei.

Zuordnungsaufrufe erfolgen nur, wenn jemand eine Verbindung öffnet oder bearbeitet. Sie kommen daher in kurzen Schüben, nicht nach Zeitplan.

Ventrata meldet sich bei Ihrem Konto bei GetYourGuide an (einschließlich der Zwei-Faktor-Anmeldung von GetYourGuide), jedes Mal wenn Ihre Zuordnungen gelesen oder gespeichert werden.

GetYourGuide ruft Product Details, Products List und Pricing Categories nur auf, während jemand im Supplier Portal von GetYourGuide zuordnet.

Availability Query (GET /1/get-availabilities/, GetYourGuide → Ventrata) – GetYourGuide fragt ein Produkt und einen Datumsbereich ab. Ventrata antwortet mit jedem verfügbaren Tag oder Zeitfenster, den verbleibenden freien Plätzen, dem Buchungsschluss und den Preisen, und GetYourGuide speichert dies im eigenen System zwischen (Cache). Im Hintergrund schlägt der Adapter Ihre Zuordnung nach und ruft OCTO Availability Check (POST /availability) auf. GetYourGuide synchronisiert in einer vordefinierten Häufigkeit neu, die von vielen Faktoren abhängen kann:

Notify Availability Update (POST /1/notify-availability-update, Ventrata → GetYourGuide) – wenn sich Ihre Verfügbarkeit durch neue Buchungen in Ventrata oder durch datums-/zeitspezifische Änderungen (keine Massenänderungen) ändert, sendet Ventrata GetYourGuide die aktualisierten freien Plätze (und Preise) für dieses Zeitfenster. Ventrata überträgt sofort für Zeitfenster in den nächsten 90 Tagen, in denen höchstens 10 Plätze übrig sind, einschließlich ausverkaufter Zeitfenster. Andere Änderungen erreichen GetYourGuide bei der nächsten geplanten Synchronisierung.

Reservation (POST /1/reserve/, GetYourGuide → Ventrata) – wenn ein Kunde Ihr Produkt auf GetYourGuide in den Warenkorb legt, prüft Ventrata erneut, ob genügend Kapazität vorhanden ist, und lehnt die Reservierung andernfalls ab. So kann GetYourGuide kein Zeitfenster überbuchen, auch wenn die zwischengespeicherte Verfügbarkeit leicht veraltet ist.

Availability Query: rund um die Uhr und recht gleichmäßig, mit leichten Spitzen tagsüber. Im Durchschnitt wird jedes zugeordnete Produkt alle paar Minuten geprüft.

Etwa die Hälfte der Anfragen betrifft Daten innerhalb des nächsten Monats. Der Rest reicht weiter, bis fast ein Jahr im Voraus.

Die meisten Anfragen betreffen einen einzelnen Tag; längere Anfragen umfassen meist etwa eine Woche.

Die angefragten Daten enthalten einen Zeitzonen-Offset, daher ist die Zeitzone Ihres Produkts wichtig.

Notify Availability Update: rund um die Uhr übertragen, wenige Augenblicke nach der auslösenden Änderung. Die Übertragungen erfolgen schubweise, je nach Buchungsaktivität und Ihren eigenen Änderungen.

Pricing Categories (GET /1/products/{productId}/pricing-categories/, GetYourGuide → Ventrata) – während der Zuordnung ruft GetYourGuide Details zu den Einheiten Ihres Produkts ab und übernimmt (importiert) sie als eigene Preiskategorien.

Availability Query (GET /1/get-availabilities/, GetYourGuide → Ventrata) – GetYourGuide ruft Ventrata regelmäßig auf, um den Verkaufspreis für jede Ticketkategorie neu zu synchronisieren, und speichert ihn zwischen, nach demselben Zeitplan wie die Verfügbarkeit. Die Preise stammen aus den Wiederverkäuferpreisen von GetYourGuide in Ventrata, über den OCTO Availability Check.

Notify Availability Update (POST /1/notify-availability-update, Ventrata → GetYourGuide) – wenn sich Ihre Verfügbarkeit durch neue Buchungen in Ventrata, Tarife oder datums-/zeitspezifische Änderungen (keine Massenänderungen) ändert, sendet Ventrata aktualisierte Verkaufspreise an GetYourGuide.

Booking (POST /1/book/, GetYourGuide → Ventrata) – jede Buchung enthält den von GetYourGuide verwendeten Verkaufspreis.

Booking Size Fares – Ventrata und GetYourGuide berechnen Staffelstrukturen mit mehreren Einheiten unterschiedlich, daher kann nur eine zugeordnete Einheit pro Produkt dynamische Staffelpreise verwenden. Weitere Tarife sind weiterhin zulässig und funktionieren, bleiben aber bei statischen Preisen. Sehen Sie sich ein Beispiel an, bei dem für die Einheit „Adult“ Staffelpreise aktiviert sind, während die Einheiten „Child“ und „Infant“ statisch bleiben:

Es gibt keinen separaten Preisaufruf: Preise werden mit jeder Verfügbarkeitsantwort und jeder Übertragung übermittelt.

GetYourGuide ruft Pricing Categories nur auf, während ein Produkt zugeordnet wird.

List Deals (GET /1/deals), Delete a deal (DELETE /1/deals/{dealId}) und Create a Deal (POST /1/deals), Ventrata → GetYourGuide – für Produkte, die Sie im Ventrata Dashboard (nicht im Portal von GetYourGuide) zuordnen, liest Ventrata Ihre Sonderangebote auf GetYourGuide und prüft, ob sie den öffentlichen Werbeaktionen entsprechen, die für Ihren Wiederverkäufer GetYourGuide zugelassen sind. Dies geschieht alle 60 Minuten. Bei Abweichungen löscht Ventrata alle Sonderangebote und legt sie passend zum Ventrata Dashboard neu an. GetYourGuide bietet keinen Aufruf zum Bearbeiten eines Deals, daher ist jede Änderung ein Löschen plus ein neuer Deal.

Wenn Sie eine Zuordnung im Ventrata Dashboard speichern, synchronisiert Ventrata die Deals für dieses Produkt außerdem sofort.

Derzeit unterstützt GetYourGuide nur einfache öffentliche Werbeaktionen, die für alle Einheiten mit anteiliger Konfiguration gelten. Andere Werbeaktionen werden nicht synchronisiert.

Die Deal-Prüfung läuft rund um die Uhr in stündlichen Zyklen sowie direkt nach Zuordnungsänderungen.

Löschen und Neuanlegen sind häufig, da jede Abweichung die Deals des Produkts neu aufbaut.

Beginnt am (Starts at)

Endet am (Ends at)

Days Before

Notice Days

Redeemable Day

Alle vier Aufrufe gehen rund um die Uhr ein, während Kunden einkaufen, mit Spitzen tagsüber.

Es gibt mehr Reservierungen als Buchungen. Das ist normal: GetYourGuide gibt fast jede Reservierung, die nicht zur Buchung wird, sofort wieder frei, anstatt sie ablaufen zu lassen.

Jede Buchungsänderung erscheint in Ventrata als neue Buchung plus eine stornierte Buchung unter derselben Referenz.

Wenn ein Buchungsaufruf fehlschlägt oder eine Zeitüberschreitung auftritt, wiederholt GetYourGuide ihn bis zu 10-mal im Abstand von 10 Minuten (siehe Buchungswiederholungen bei GetYourGuide). Eine Buchung kann daher gelegentlich etwas später eingehen, als der Kunde bezahlt hat.

Ticket Redemption by Booking Reference (POST /1/redeem-booking, Ventrata → GetYourGuide) – sobald eines der Tickets einer Buchung eingelöst wird (auch wenn die Buchung nur teilweise eingelöst ist), sendet Ventrata eine Einlösebenachrichtigung für die Buchung an GetYourGuide. Das kann helfen, Stornierungen und Erstattungen für eingelöste Buchungen zu verhindern. Allerdings ist bekannt, dass GetYourGuide Buchungen derzeit unabhängig von der erhaltenen Benachrichtigung storniert.

Ventrata meldet Einlösungen pro Buchung. Der Einlöseaufruf pro Ticket von GetYourGuide wird nicht verwendet.

Ventrata prüft jede Aktualisierung einer Buchung von GetYourGuide und sendet nur dann eine Benachrichtigung, wenn die Aktualisierung eine Einlösung enthält.

Die Benachrichtigungen folgen Ihren Scans: Sie werden rund um die Uhr gesendet, meist aber tagsüber, wenn Gäste ankommen.

Legen Sie im GetYourGuide Supplier Portal für jedes Ihrer Produkte/jede Option eine Liste von Abholorten an. GetYourGuide kann diese derzeit nicht aus Ventrata abrufen, daher verwalten Sie sie manuell im Portal von GetYourGuide.

Booking (POST /1/book/, GetYourGuide → Ventrata) – GetYourGuide sendet Ventrata mit der Buchungsbestätigungsanfrage den Abholort (das Hotel des Reisenden), sofern dies für Ihr Produkt zutrifft. Mithilfe der Google Maps Places API ordnet Ventrata ihn dem nächstgelegenen Abholpunkt zu, den Sie anbieten, und speichert außerdem den genauen Ort im Feld Hotel der Buchung.

Abholdetails werden nur mit dem Aufruf Booking übermittelt. GetYourGuide fragt Ventrata nie nach Ihren Abholpunkten.

Zuordnung im Portal von GetYourGuide: Wenn Sie ein Produkt im Portal von GetYourGuide einrichten oder zuordnen, setzen Sie die Option Allow Add-ons auf No. Bei Yes fordert GetYourGuide Add-on-Daten über die API an (Fetch Addons, GET /1/products/{productId}/addons/), was Ventrata ablehnt und zu Verbindungsfehlern führt.

Zuordnung im Ventrata Dashboard: Bei Produkten, die direkt im Ventrata Dashboard zugeordnet werden, sind Add-ons während der Einrichtung automatisch deaktiviert.