Zum Hauptinhalt springen

Dex: Betreiber-Backend

Verbinden Sie Dex mit Ventrata, um Produkte von Dex-Betreibern mit Live-Verfügbarkeit und Buchungen weiterzuverkaufen. Erzählerische Audioguides an bedeutenden Wahrzeichen und in Museen.

Dex logo

 

Dex ist die Audioguide-App von Headout mit filmischen, erzählerischen Touren und eigens komponierten Soundtracks, bei denen Reisende an Sehenswürdigkeiten wie dem Louvre, dem Eiffelturm, dem British Museum, der Freiheitsstatue, der Sagrada Família und Angkor Wat ihren Erzähler wählen. Der integrierte KI-Guide beantwortet Fragen und erkennt Kunstwerke direkt vor Ort, in sieben Sprachen und offline, sodass Attraktionen neben dem Eintritt einen Dex-Guide anbieten können.

 

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

 

Weitere Informationen zu Dex finden Sie unter dex.headout.com.

 

‼️ WICHTIG

Eine E-Mail-Adresse ist erforderlich. Headout stellt dem Kunden den Dex-Audioguide per E-Mail zu. Für jedes Dex-Produkt in Ventrata muss E-Mail als Pflichtkontaktfeld festgelegt sein, sonst erhält der Kunde seinen Guide nicht.

📒 HINWEIS

Wenn Headout Ihre eigenen Produkte weiterverkaufen soll, lesen Sie stattdessen den Artikel zur Wiederverkäufer-Verbindung mit Headout.

 

Hauptwebsite

Tags

Custom / Proprietary Operator System

Verbindungsfunktionen

Availability Sync · Bookings Sync

Entwickelt von

Ventrata (über die Dex OCTO API)

 

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

  • Availability Sync – die Live-Verfügbarkeit stammt aus dem Dex-Konto des Betreibers.

  • Bookings Sync – Buchungen, Änderungen und Stornierungen werden von Ventrata an Dex übertragen, und Dex stellt die Tickets oder Voucher aus.

 

Dex-Verbindung 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.

  • Sie haben eine Handelsvereinbarung mit Headout, um Dex-Audioguides anzubieten. Falls nicht, wenden Sie sich an Ihren Account Manager bei Headout.

  • 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

Ihr Ansprechpartner bei Headout gibt Ihnen den OCTO API Key.

 

  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 Bereich Backend-Partner (Backend Partner) Dex aus und geben Sie den OCTO API Key ein.

  3. Lassen Sie das Feld OCTO-Endpunkt (OCTO Endpoint) auf dem vorausgefüllten Standardwert, sofern Headout nichts anderes mitteilt. Der Artikel nennt den Wert nicht.

  4. Press Update Operator.

 

 

 

📒 HINWEIS – Jeder OCTO API Key verbindet Sie mit einem Betreiber. Richten Sie jeden Dex-Betreiber 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 Dex zu verwenden.

  3. Press Update Product.

 

Legen Sie die Dex-Produkte in Ventrata mit Preisen gemäß Ihrer Vereinbarung mit Headout an. Die Verbindung überträgt Buchungen, legt aber keine Produkte an und synchronisiert keine Preise automatisch.

 

Aktivieren Sie Backend verbunden (Backend Connected). Backend-Verfügbarkeit (Backend Availability) ist optional: Dex-Audioguides haben in der Regel unbegrenzte Verfügbarkeit, daher können Sie die Option aktivieren oder deaktivieren.

 

Lassen Sie Backend-Preisgestaltung (Backend Pricing) deaktiviert, da Preise über die API nicht unterstützt werden.

 

Legen Sie in den Kontaktfeld-Einstellungen des Produkts E-Mail als Pflichtfeld fest und klicken Sie dann auf Update Product.

 

 

Produkte Dex zuordnen

‼️ WICHTIG

Die Zuordnung teilt Ventrata mit, für welches Dex-Produkt, welche Option und welche Einheiten 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 kennzeichnet ein falsch zugeordnetes Produkt.

 

  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 das passende Dex-Produkt, die Option und die Einheiten aus den Dropdown-Menüs aus, die Ventrata aus Dex lädt. Lassen Sie kein Feld leer.

  4. Press Save Changes.

 

 

 

📗 TIPP

Führen Sie nach der Zuordnung eine Testbuchung durch und bitten Sie den Betreiber zu bestätigen, dass sie in seinem Dex-Konto angekommen ist.

 

Dex-Verbindung verwalten

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

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

  • Deaktivieren Sie Backend-Verfügbarkeit oder Backend-Preisgestaltung (Backend Availability, Backend Pricing) bei einem Produkt, um stattdessen die eigene Verfügbarkeit oder die eigenen Preise von Ventrata zu verwenden. Buchungen werden weiterhin an Dex übertragen.

 

Verbindungsfunktionen im Detail

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

 

Kurz gesagt: Ventrata fragt die Verfügbarkeit bei Dex ab, sobald jemand ein mit dem Backend verbundenes Produkt aufruft, und legt jede Buchung im Dex-Konto des Betreibers an. Dex sendet keine Änderungen an Ventrata zurück.

 

Die Zeitangaben sind typische, gerundete Werte für Dex und können sich ändern.

 

Product Mapping

✅

Sie ordnen jedes Ventrata-Produkt, jede Option und jede Einheit im Ventrata Dashboard dem Dex-Produkt des Betreibers zu.

Das funktioniert wie folgt:

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

 

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

Content Sync

❌

Ventrata importiert keine Produktinhalte aus Dex.

Ventrata importiert keine Produktinhalte aus Dex. 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 Dex.

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 Dex live nach den angezeigten Daten.

  • Wenn Backend-Verfügbarkeit (Backend Availability) aktiviert ist, ruft Ventrata die Verfügbarkeit aus Dex von Headout ab. Dex-Audioguides haben in der Regel unbegrenzte Verfügbarkeit, daher können Sie die Option aktivieren oder deaktivieren.

 

Was das für Sie bedeutet: Kunden buchen auf Basis der Live-Verfügbarkeit des Betreibers in Dex, sodass Sie kein Zeitfenster überverkaufen können, das der Betreiber bereits anderweitig verkauft hat.

Pricing Sync

❌

Ventrata liest keine Preise aus Dex.

Ventrata liest keine Preise aus Dex. Die Produkte verwenden die Preise, die Sie in Ventrata festlegen, und Buchungen werden weiterhin an Dex übertragen.

Promotions Sync

❌

Werbeaktionen werden nicht an Dex übermittelt.

Werbeaktionen werden nicht an Dex übermittelt. Ihre Ventrata-Werbeaktionen gelten weiterhin für den Preis, den Ihr Kunde in Ventrata zahlt.

Bookings Sync

✅

Buchungen, die in Ventrata für ein mit dem Backend verbundenes Produkt getätigt werden, werden im Dex-Konto des Betreibers 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 Dex.

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

  3. Ändern: Booking Update (PATCH /bookings/{uuid}) – in Ventrata vorgenommene Änderungen werden an Dex gesendet.

  4. Stornieren: Booking Cancellation (POST /bookings/{uuid}/cancel) – in Ventrata vorgenommene Stornierungen werden an Dex gesendet.

Buchungen, Buchungsänderungen und Stornierungen, die in Ventrata für das mit dem Backend verbundene Produkt vorgenommen werden, werden an Dex von Headout gesendet, einschließlich der E-Mail-Adresse des Kunden.

 

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

Pickups/Dropoff Sync

❌

Abhol- und Absetzdetails werden nicht an Dex übermittelt.

Abhol- und Absetzdetails werden nicht an Dex ü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 Dex übermittelt.

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

Extras Sync

❌

Extras und Zusatzleistungen werden nicht in Dex gebucht.

Extras und Zusatzleistungen werden nicht in Dex gebucht, sondern nur das Hauptprodukt, die Option und die Einheiten.

Redemption Sync

❌

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

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

Nicht unterstützt. Der Einlösestatus wird nicht an Ventrata zurückgemeldet.

Pass Walkup Scanning Sync

❌

Das Scannen von Pässen ohne Buchung (Walk-up) ist mit Dex nicht verfügbar.

Das Scannen von Pässen ohne Buchung (Walk-up) ist mit Dex nicht verfügbar.

Gift Card Sync

❌

Ventrata-Geschenkkarten werden nicht an Dex übermittelt.

Ventrata-Geschenkkarten werden nicht an Dex übermittelt. Zahlungen mit Geschenkkarten verbleiben in Ventrata.

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Dex-Verbindung

  • Live-Verfügbarkeit: Die Verfügbarkeit kommt aus Dex, während Kunden das Angebot durchsuchen.

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

  • Zustellung des Guides: Headout sendet den Dex-Audioguide per E-Mail direkt an den Kunden. E-Mail muss beim Produkt ein Pflichtkontaktfeld sein.

  • Der Guide wird von Headout bereitgestellt und ausgeliefert.

  • Betreiber können Dex-Audioguides als eigenständiges Produkt, als Teil eines Pakets oder als Upsell bzw. Cross-Sell anbieten.

 

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 Dex freigegeben hat. Fragen Sie den Betreiber. Wenn das Problem weiterhin besteht, 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 das Zeitfenster in Dex noch verfügbar ist. Wenn das Problem weiterhin besteht, wenden Sie sich an unseren technischen Support.

Fehler beim Anlegen des Betreibers.

Wahrscheinlich ist der OCTO API Key falsch. Prüfen Sie ihn noch einmal mit Ihrem Ansprechpartner bei Headout. Wenn das Problem weiterhin besteht, wenden Sie sich an den Support.

Der Kunde hat den Audioguide nicht erhalten.

Prüfen Sie, ob E-Mail beim Produkt ein Pflichtkontaktfeld ist und die Buchung eine gültige E-Mail-Adresse enthält. Ist das der Fall, wenden Sie sich mit der Buchungsreferenz an Ihren Ansprechpartner bei Headout.

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

Die Dropdown-Liste wird aus Dex von Headout geladen, basierend auf den Produkten, die Headout Ihnen freigegeben hat. Prüfen Sie dies noch einmal mit Ihrem Ansprechpartner bei Headout. Wenn das Problem weiterhin besteht, wenden Sie sich an den Support.

 

Nützliche Ressourcen

 

 

Partnerinformationen

Headout Inc.

82 Nassau Street, #60351

New York, NY 10038, USA

 

Ventrata-Partner-ID: 01a0d78e-2b7c-7d13-b753-d831c9ff6b78

Hat dies deine Frage beantwortet?