Zum Hauptinhalt springen

Bókun: Betreiber-Backend

Verbinden Sie Bókun mit Ventrata, um Produkte von Betreibern, die Bókun nutzen, mit Live-Verfügbarkeit, Preisen und Buchungen weiterzuverkaufen.

Bókun logo

 

Bókun ist die Reservierungs- und Vertriebsplattform von Tripadvisor für Betreiber von Touren, Attraktionen, Aktivitäten, Vermietungen und Bodentransporten und wird von Tausenden Unternehmen weltweit genutzt. Ihr Marktplatz umfasst mehr als 2.600 OTAs und Wiederverkäufer, und durch die gemeinsame Eigentümerschaft mit Viator ist Bókun häufig das Backend von Betreibern, deren Nachfrage größtenteils über Tripadvisor kommt.

 

Wenn Sie Bókun mit Ventrata verbinden, können Sie Produkte von Betreibern weiterverkaufen, die Bókun als Buchungssystem nutzen. Ventrata liest deren Live-Verfügbarkeit und Preise aus Bókun, und jede Buchung, die Sie entgegennehmen, wird direkt im Konto des Betreibers bei Bókun angelegt.

 

Weitere Informationen zu Bókun finden Sie unter bokun.io.

 

📒 HINWEIS

Möchten Sie stattdessen Ihre Produkte über Bókun weiterverkaufen lassen? Siehe Bókun: Reseller Connection.

 

📒 HINWEIS

Diese Verbindung ist demnächst verfügbar. Sie befindet sich in der Entwicklung, der Start ist für November–Dezember 2026 geplant. Wenn Sie sie nutzen möchten, wenden Sie sich an unseren technischen Support oder Ihren Ventrata Customer Success Manager.

 

Hauptwebsite

Tags

Booking / Ticketing System

Verbindungsfunktionen

Availability Sync · Pricing Sync · Bookings Sync

Entwickelt von

Ventrata (über die Bókun OCTO API)

 

Mit dieser Betreiber-Verbindung (auch Backend genannt) können Sie Produkte von Betreibern weiterverkaufen, die Bókun als primäres Buchungssystem nutzen. Jede Buchung wird direkt in Bókun angelegt. Zu den Funktionen dieser Verbindung gehören:

  • Availability Sync – die Live-Verfügbarkeit stammt aus dem Konto des Betreibers bei Bókun.

  • Pricing Sync – die Preise stammen aus Bókun, oder Sie legen die Preise in Ventrata fest.

  • Bookings Sync – Buchungen, Änderungen und Stornierungen werden von Ventrata an Bókun übermittelt, und Bókun stellt die Tickets oder Voucher aus.

 

Verbindung mit Bókun erstellen

🔐 Erforderliche Rollenberechtigungen: See Operators, Modify Operators, See Products, Modify Products

Bevor Sie beginnen:

  • Sie benötigen eine Handelsvereinbarung mit dem Betreiber über dessen Tarife und Konditionen.

  • Sie benötigen den OCTO API Key für den Betreiber. Siehe die folgenden Schritte.

  • Das Unternehmen, dessen Produkte Sie weiterverkaufen möchten, ist in Ventrata als Betreiber angelegt.

  • Die Produkte des Betreibers sind in Ventrata angelegt. Die Verbindung synchronisiert Verfügbarkeit, Preise und Buchungen, erstellt aber keine Produkte.

  • Sie müssen die Produkte des Betreibers in Ventrata neu anlegen. Siehe Produkte erstellen. Die Verbindung synchronisiert Verfügbarkeit, Preise und Buchungen, legt aber keine Produkte in Ventrata an.

 

Schritt 1: Betreiber in Ventrata konfigurieren

Fragen Sie den Betreiber, der Bókun nutzt. Er erstellt ihn in Bókun: Settings → Connectivity → API keys → Create an API key → Save → OCTO für diesen API-Schlüssel aktivieren.

 

  1. Gehen Sie im Ventrata Dashboard zu Produkte → Betreiber (Products → Operators) und öffnen Sie den Betreiber. Falls er noch nicht existiert, legen Sie ihn zuerst als Betreiber an.

  2. Wählen Sie im Abschnitt Backend-Partner (Backend Partner) Bókun aus und geben Sie den OCTO API Key ein. Belassen Sie den Endpunkt beim Standardwert https://api.bokun.io/octo/v1, sofern der Betreiber oder Bókun nichts anderes angibt.

  3. Wählen Sie Bókun im Abschnitt „Backend-Partner“ (Backend Partner) des Betreibers aus.

  4. Geben Sie den OCTO API Key ein. Belassen Sie den OCTO-Endpunkt beim vorausgefüllten Standardwert, sofern der Betreiber nichts anderes angibt.

  5. Click Update Operator.

  6. Press Update Operator.

 

 

Wählen Sie im Feld „Backend-Partner“ (Backend Partner) Bókun aus der Liste der verfügbaren Verbindungen aus und geben Sie den OCTO API Key ein, den Sie von Ihrem Betreiber erhalten haben.

 

📒 HINWEIS – Jeder OCTO API Key verbindet Sie mit einem Betreiber. Richten Sie jeden Betreiber, der Bókun nutzt, separat ein.

 

Schritt 2: Jedes Produkt verbinden

  1. Öffnen Sie das Produkt des Betreibers unter Produkte → Produkte (Products → Products) und bearbeiten Sie es. Prüfen Sie, ob Betreiber (Operator) auf diesen Betreiber gesetzt ist.

  2. Aktivieren Sie Backend verbunden (Backend Connected). Aktivieren Sie Backend-Verfügbarkeit (Backend Availability), um die Verfügbarkeit aus Bókun zu verwenden, und Backend-Preisgestaltung (Backend Pricing), um die Preise aus Bókun zu verwenden.

  3. Press Update Product.

📒 HINWEIS

Bókun sendet nur Verkaufspreise. Ist Backend-Preisgestaltung (Backend Pricing) aktiviert, erfasst Ventrata den Verkaufspreis und berechnet Ihren Nettopreis (Einkaufspreis) anhand des Kostenanteils, der beim Betreiber im Ventrata Dashboard hinterlegt ist.

 

Legen Sie als Betreiber des Produkts den Betreiber mit dem Backend Bókun fest, aktivieren Sie „Backend verbunden“ (Backend Connected) und dann „Backend-Verfügbarkeit“ und/oder „Backend-Preisgestaltung“. Ohne diese Optionen verwendet das Produkt die in Ventrata festgelegte Verfügbarkeit bzw. Preise, Buchungen werden aber weiterhin an Bókun übermittelt.

 

Aktivieren Sie für dieses Produkt „Backend verbunden“ (Backend Connected), um die API-Verbindung (Backend) zu nutzen. Um die Verfügbarkeit aus Bókun abzurufen, aktivieren Sie „Backend-Verfügbarkeit“ (Backend Availability); um die Preise abzurufen, aktivieren Sie „Backend-Preisgestaltung“ (Backend Pricing). Wenn Sie Backend-Verfügbarkeit und/oder Backend-Preisgestaltung nicht aktivieren, verwendet das Produkt die in Ventrata konfigurierte Verfügbarkeit und/oder Preise, Buchungen werden aber weiterhin an Bókun übermittelt. Klicken Sie zum Speichern auf „Produkt aktualisieren“ (Update Product).

 

Produkte zu Bókun zuordnen

‼️ WICHTIG

Über die Zuordnung erfährt Ventrata, für welches Produkt, welche Option und welche Einheiten in Bókun die Verfügbarkeit geprüft und gebucht werden soll. Ist ein mit dem Backend verbundenes Produkt nicht korrekt zugeordnet, schlagen seine Buchungen fehl. Eine rote Markierung über die gesamte Produktzeile zeigt ein falsch zugeordnetes Produkt an.

 

  1. Gehen Sie im Ventrata Dashboard zu Produkte → Produkte (Products → Products) und öffnen Sie das Produkt.

  2. Öffnen Sie den Tab Zuordnungen (Mappings). Er wird angezeigt, sobald das Produkt auf Backend verbunden (Backend Connected) gesetzt ist.

  3. Wählen Sie für jede Ventrata-Option und -Einheit in den Dropdown-Menüs, die Ventrata aus Bókun lädt, das passende Produkt, die passende Option und die passenden Einheiten in Bókun aus. Lassen Sie kein Feld leer.

  4. Press Save Changes.

 

Auf der Produktseite wird jetzt der Tab „Zuordnungen“ (Mappings) angezeigt. Öffnen Sie diesen Tab und ordnen Sie Ihr Ventrata-Produkt, Ihre Option(en) und Einheiten zu, indem Sie die entsprechenden Produkte, Optionen und Einheiten in den Dropdown-Listen auswählen, die aus Bókun übermittelt werden. Achten Sie darauf, dass kein Feld leer (nicht zugeordnet) bleibt, und klicken Sie auf „Änderungen speichern“ (Save Changes).

 

📗 TIPP

Nehmen Sie nach der Zuordnung eine Testbuchung vor und bitten Sie den Betreiber zu bestätigen, dass sie in seinem Konto bei Bókun angekommen ist.

 

Verbindung mit Bókun verwalten

  • Aktualisieren Sie die Zuordnung, wenn der Betreiber Produkte, Optionen oder Einheiten in Bókun ändert.

  • Ersetzen Sie den Schlüssel beim Betreiber, wenn Bókun oder der Betreiber einen neuen ausstellt.

  • Deaktivieren Sie Backend-Verfügbarkeit oder Backend-Preisgestaltung bei einem Produkt, um stattdessen die eigene Verfügbarkeit oder die eigenen Preise von Ventrata zu verwenden. Buchungen werden weiterhin an Bókun übermittelt.

 

Verbindungsfunktionen im Detail

Dieser Abschnitt richtet sich an alle, die genau wissen möchten, wie die Verbindung mit Bókun funktioniert. Die Richtung ist hier umgekehrt wie bei einer Wiederverkäufer-Verbindung: Ventrata ruft Bókun auf, und zwar über die Bókun OCTO API. Für jede Funktion wird erklärt, welche Aufrufe Ventrata wann ausführt und was das für Sie bedeutet.

 

Kurz gesagt: Ventrata fragt bei Bókun Verfügbarkeit und Preise ab, sobald jemand ein mit dem Backend verbundenes Produkt aufruft, und legt jede Buchung im Konto des Betreibers bei Bókun an. Bókun meldet keine Änderungen an Ventrata zurück.

 

Die Zeitangaben sind für Bókun typisch, gerundet und können sich ändern.

 

Product Mapping

✅

Sie ordnen jedes Ventrata-Produkt, jede Option und jede Einheit im Ventrata Dashboard dem Produkt des Betreibers in Bókun zu.

Das funktioniert wie folgt:

  • Get Products (GET /products) – Ventrata liest die Produkte, Optionen und Einheiten des Betreibers in Bókun, um die Dropdown-Menüs auf dem Tab Zuordnungen (Mappings) zu füllen.

 

Was das für Sie bedeutet: Wenn etwas im Dropdown-Menü fehlt, hat der Betreiber es Ihnen in Bókun nicht freigegeben. Bitten Sie ihn darum.

Content Sync

❌

Ventrata importiert keine Produktinhalte aus Bókun.

Ventrata importiert keine Produktinhalte aus Bókun. Sie legen die Produkte selbst in Ventrata an und beschreiben sie.

Availability Sync

✅

Bei aktivierter Backend-Verfügbarkeit prüft Ventrata die Live-Verfügbarkeit des Betreibers in Bókun.

Das funktioniert wie folgt:

  • Availability Check (POST /availability) – Wenn jemand den Verfügbarkeitskalender in Ventrata nutzt, zum Beispiel im Dashboard, in Ihrem Web Checkout oder an einem Terminal, fragt Ventrata bei Bókun live die angezeigten Daten ab.

  • Bei aktivierter Backend-Verfügbarkeit stellt Ventrata eine Live-OCTO-Verfügbarkeitsanfrage an Bókun, wenn ein Nutzer mit dem Kalender interagiert (Dashboard, Web Checkout, Terminal usw.), in der Regel für Zeiträume von 7 Tagen oder für einen bestimmten Tag. Bevor der Nutzer interagiert, zeigt der Kalender möglicherweise zwischengespeicherte (nicht aktuelle) Daten aus der vorherigen Anfrage.

 

Typischerweise bei Bókun:

  • Die Anfragen umfassen jeweils 7 Tage, von heute bis etwa ein Jahr im Voraus, während Nutzer den Kalender durchsuchen und Ventrata ihn lädt.

 

Was das für Sie bedeutet: Kunden buchen auf Basis der Live-Verfügbarkeit des Betreibers in Bókun. So können Sie keinen Zeitslot überverkaufen, den der Betreiber bereits anderweitig verkauft hat.

Pricing Sync

✅

Bei aktivierter Backend-Preisgestaltung übernimmt Ventrata die Preise aus Bókun.

Das funktioniert wie folgt:

  • Availability Check mit der Capability octo/pricing – Ventrata fragt bei jeder Verfügbarkeitsanfrage auch die Preise bei Bókun ab.

  • Bei aktivierter Backend-Preisgestaltung ruft Ventrata mit der Verfügbarkeitsprüfung sowohl Verkaufs- als auch Nettopreise (Großhandelspreise) von Bókun ab. Die Preise werden dem Nutzer angezeigt und in Ventrata als per API generierte Tarife zwischengespeichert bzw. gespeichert. Nettopreise werden als Einkaufspreise erfasst, unabhängig vom Kostenanteil beim Betreiber.

  • Bei deaktivierter Backend-Preisgestaltung verwendet das Produkt die Preise, die Sie in Ventrata festgelegt haben, und Buchungen werden weiterhin an Bókun übermittelt.

Bókun sendet nur Verkaufspreise. Ist Backend-Preisgestaltung (Backend Pricing) aktiviert, erfasst Ventrata den Verkaufspreis und berechnet Ihren Nettopreis (Einkaufspreis) anhand des Kostenanteils, der beim Betreiber im Ventrata Dashboard hinterlegt ist.

Promotions Sync

❌

Werbeaktionen werden nicht an Bókun übermittelt.

Werbeaktionen werden nicht an Bókun übermittelt. Ihre Ventrata-Werbeaktionen gelten weiterhin für den Preis, den Ihr Kunde in Ventrata bezahlt.

Bookings Sync

✅

Buchungen, die in Ventrata für ein mit dem Backend verbundenes Produkt vorgenommen werden, werden im Konto des Betreibers bei Bókun angelegt.

Das funktioniert wie folgt:

  1. Reservieren: Booking Reservation (POST /bookings) – Wenn das Produkt in Ventrata in den Warenkorb gelegt wird, reserviert Ventrata die Plätze in Bókun.

  2. Bestätigen: Booking Confirmation (POST /bookings/{uuid}/confirm) – Nach der Zahlung bestätigt Ventrata die Buchung in Bókun mit den Kontaktdaten des Kunden, und das von Bókun zurückgegebene Ticket oder der Voucher wird zum Ventrata-Ticket bzw. -Voucher.

  3. Ändern: Booking Update (PATCH /bookings/{uuid}) – In Ventrata vorgenommene Änderungen werden an Bókun gesendet.

  4. Stornieren: Booking Cancellation (POST /bookings/{uuid}/cancel) – In Ventrata vorgenommene Stornierungen werden an Bókun gesendet.

Buchungen, Änderungen und Stornierungen für mit dem Backend verbundene Produkte werden automatisch an Bókun gesendet: Reservierung, wenn das Produkt in den Warenkorb gelegt wird, Bestätigung nach der Zahlung (mit den Kontaktdaten des Kunden), Aktualisierung bei einer Buchungsänderung und Stornierung, wenn eine Buchung storniert wird. Der Voucher bzw. das Ticket von Bókun wird in Ventrata übernommen, außer PDF_FILE, das Ventrata nicht unterstützt.

 

‼️ WICHTIG – Buchungen werden nur in eine Richtung synchronisiert, von Ventrata zu Bókun. Wenn der Betreiber eine Buchung in Bókun ändert oder storniert, wird Ventrata nicht benachrichtigt. Bitten Sie den Betreiber, Sie über alle Änderungen zu informieren.

Pickups/Dropoff Sync

❌

Angaben zu Abholung und Absetzen werden nicht an Bókun übermittelt.

Angaben zu Abholung und Absetzen werden nicht an Bókun übermittelt. Teilen Sie sie dem Betreiber auf anderem Weg mit, wenn ein Produkt sie benötigt.

Custom Questions Sync

❌

Antworten auf Ihre Buchungsfragen werden nicht an Bókun übermittelt.

Antworten auf Ihre Buchungsfragen werden nicht an Bókun übermittelt. Teilen Sie sie dem Betreiber auf anderem Weg mit, wenn er sie benötigt.

Extras Sync

❌

Extras und Zusatzleistungen werden nicht in Bókun gebucht.

Extras und Zusatzleistungen werden nicht in Bókun gebucht. Gebucht werden nur das Hauptprodukt, die Option und die Einheiten.

Redemption Sync

❌

Einlösungen und andere Statusänderungen in Bókun werden nach der Bestätigung einer Buchung nicht an Ventrata zurückgemeldet.

Einlösungen und andere Statusänderungen in Bókun werden nach der Bestätigung einer Buchung nicht an Ventrata zurückgemeldet.

Nicht unterstützt. Der Buchungsstatus aus Bókun (zum Beispiel „Redeemed“) wird nach der Bestätigung nicht an Ventrata zurückgemeldet.

Pass Walkup Scanning Sync

❌

Das Scannen von Pässen bei Laufkunden ist mit Bókun nicht verfügbar.

Das Scannen von Pässen bei Laufkunden ist mit Bókun nicht verfügbar.

Gift Card Sync

❌

Ventrata-Geschenkkarten werden nicht an Bókun übermittelt.

Ventrata-Geschenkkarten werden nicht an Bókun übermittelt. Zahlungen mit Geschenkkarten verbleiben in Ventrata.

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Verbindung mit Bókun

  • Live-Verfügbarkeit: Die Verfügbarkeit wird aus Bókun abgerufen, während Kunden das Angebot durchsuchen.

  • Buchungen in eine Richtung: Änderungen, die der Betreiber in Bókun vornimmt, erreichen Ventrata nicht.

  • Bókun, ein Unternehmen von Tripadvisor, ist ein Buchungs-, Inventar- und Channel-Management-System für Touren, Aktivitäten und Attraktionen.

 

FAQ

Beim Speichern der Backend-Konfiguration des Betreibers erhalte ich eine Fehlermeldung.

Höchstwahrscheinlich sind der OCTO API Key oder der Endpunkt falsch. Klären Sie dies mit Ihrem Betreiber ab. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

In den Produkteinstellungen gibt es kein Kontrollkästchen „Backend verbunden“ (Backend Connected).

Für den beim Produkt festgelegten Betreiber ist höchstwahrscheinlich kein Backend konfiguriert. Prüfen Sie die Einstellungen unter „Backend-Partner“ (Backend Partner) beim Betreiber und versuchen Sie es erneut. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

Das Produkt, die Option oder die Einheit, die ich zuordnen möchte, ist nicht im Dropdown-Menü enthalten.

Die Dropdown-Menüs zeigen, was der Betreiber Ihnen in Bókun freigegeben hat. Fragen Sie beim Betreiber nach. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

Buchungen für ein mit dem Backend verbundenes Produkt schlagen fehl.

Prüfen Sie zuerst die Zuordnung des Produkts: Jede Option und jede Einheit muss zugeordnet sein. Prüfen Sie dann, ob der Zeitslot in Bókun noch verfügbar ist. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

Fehler beim Aktualisieren des Betreibers zum Speichern der Backend-Konfiguration.

Wahrscheinlich ist der OCTO API Key oder der OCTO-Endpunkt falsch. Klären Sie diese Angaben mit Ihrem Betreiber ab. Besteht das Problem weiterhin, wenden Sie sich an den Ventrata-Support.

Das Produkt, die Option oder die Einheit, die ich zuordnen möchte, ist nicht im Dropdown-Menü enthalten.

Die Dropdown-Liste wird aus Bókun abgerufen und basiert auf den Produkten, Optionen und Einheiten, die der Betreiber Ihnen freigegeben hat. Klären Sie diese Angaben mit Ihrem Betreiber ab. Besteht das Problem weiterhin, wenden Sie sich an den Ventrata-Support.

 

Nützliche Ressourcen

 

 

Partnerinformationen

Tripadvisor LLC dba Bókun

400 1st Avenue

Needham, MA 02494, USA

 

Ventrata-Partner-ID: 18d71b21-57e4-4811-8818-a7be06311725

Hat dies deine Frage beantwortet?