Zum Hauptinhalt springen

Xola: Betreiber-Backend

Verbinden Sie Xola mit Ventrata, um Produkte von Betreibern, die Xola nutzen, mit Live-Verfügbarkeit, Preisen und Sofortbuchungen weiterzuverkaufen. Stark bei Abenteuererlebnissen.

Xola logo

 

Xola ist eine Reservierungs- und E-Commerce-Plattform für Tour-, Aktivitäts- und Attraktionsbetreiber, die Online-Checkout, Kassensystem, Kioske, digitale Haftungsverzichtserklärungen, Personal- und Ausrüstungsplanung, Wartelisten und Bewertungen umfasst, wobei Xolabot die Rückgewinnung abgebrochener Warenkörbe und das Follow-up-Marketing übernimmt. Die Betreiber kommen vor allem aus Abenteuer- und Erlebniskategorien wie Hubschraubertouren, Ziplines, Escape Rooms, Wassersport, Bootstouren und Angelcharter.

 

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

 

Weitere Informationen zu Xola finden Sie unter xola.com.

 

Hauptwebsite

Tags

Booking / Ticketing System

Verbindungsfunktionen

Availability Sync · Pricing Sync · Bookings Sync

Entwickelt von

Ventrata (über die Xola OCTO API)

 

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

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

  • Pricing Sync – Verkaufs- und Nettopreise stammen aus Xola, oder Sie legen die Preise in Ventrata fest.

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

 

Verbindung mit Xola 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 müssen als Distribution Channel im App Store von Xola gelistet sein. Siehe Schritt 1.

  • 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: Im App Store von Xola gelistet werden

Senden Sie eine E-Mail an [email protected] und [email protected] mit den Namen der Betreiber, die Xola nutzen und mit denen Sie sich verbinden möchten, sowie Ihrem Logo, Ihrem Firmennamen und einer Kontaktperson für Ihren App-Eintrag. Rechnen Sie mit einigen Tagen, bis Xola Ihre Anfrage geprüft und genehmigt hat.

 

Schritt 2: OCTO API Key des Betreibers erhalten

Sobald Sie gelistet sind, bitten Sie den Betreiber, Ihre App in Xola zu installieren, die Erlebnisse auszuwählen, die er mit Ihnen teilen möchte, und den OCTO API Key auf sicherem Weg mit Ihnen zu teilen.

 

Schritt 3: Betreiber in Ventrata konfigurieren

  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) Xola aus und geben Sie den OCTO API Key ein. Belassen Sie den OCTO-Endpunkt (OCTO Endpoint) beim Standardwert https://octo.xola.com/latest, sofern der Betreiber oder Xola nichts anderes angibt.

  3. Press Update Operator.

 

 

Wählen Sie im Abschnitt „Backend-Partner“ (Backend Partner) Xola aus der Liste der verfügbaren Verbindungen aus und geben Sie den OCTO API Key ein, den Sie von Ihrem Betreiber erhalten haben. Sofern der Betreiber oder Xola nichts anderes vorgibt, belassen Sie im Feld „OCTO-Endpunkt“ (OCTO Endpoint) den vorausgefüllten Standardwert für Xola.

 

📒 HINWEIS – Jeder API-Schlüssel verbindet Sie mit einem Betreiber. Richten Sie jeden Betreiber, der Xola nutzt, separat ein.

 

Schritt 4: 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 Xola zu verwenden, und Backend-Preisgestaltung (Backend Pricing), um die Preise aus Xola zu verwenden.

  3. Press Update Product.

📒 HINWEIS

Xola 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.

 

Aktivieren Sie für dieses Produkt „Backend verbunden“ (Backend Connected), um die API-Verbindung (Backend) zu nutzen. Um die Verfügbarkeit aus Xola 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 Xola übermittelt. Klicken Sie zum Speichern auf „Produkt aktualisieren“ (Update Product).

 

Produkte zu Xola zuordnen

‼️ WICHTIG

Über die Zuordnung erfährt Ventrata, für welches Produkt, welche Option und welche Einheiten in Xola 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 das passende Erlebnis, die passende Option und die passenden Einheiten von Xola aus den Dropdown-Listen aus, die Ventrata aus Xola lädt. 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 Xola ü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 Xola angekommen ist.

 

Verbindung mit Xola verwalten

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

  • Ersetzen Sie den Schlüssel beim Betreiber, wenn Xola 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 Xola übermittelt.

 

Verbindungsfunktionen im Detail

Dieser Abschnitt richtet sich an alle, die genau wissen möchten, wie die Verbindung mit Xola funktioniert. Die Richtung ist hier umgekehrt wie bei einer Wiederverkäufer-Verbindung: Ventrata ruft Xola auf, und zwar über die OCTO API von Xola. 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 Xola Verfügbarkeit und Preise ab, sobald jemand ein mit dem Backend verbundenes Produkt aufruft, und legt jede Buchung im Konto des Betreibers bei Xola an. Xola meldet keine Änderungen an Ventrata zurück.

 

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

 

Product Mapping

✅

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

Das funktioniert wie folgt:

  • Get Products (GET /products) – Ventrata liest die Erlebnisse, die der Betreiber in Xola mit Ihnen geteilt hat, mit ihren Optionen und Einheiten, um die Dropdown-Listen auf dem Tab Zuordnungen (Mappings) zu füllen.

  • Capabilities (GET /capabilities) – Ventrata prüft, welche OCTO-Capabilities (Funktionen) das Konto des Betreibers bei Xola unterstützt.

 

Typischerweise bei Xola:

  • Ventrata liest die Produkte und Capabilities des Betreibers alle paar Stunden erneut aus Xola, sodass neue Erlebnisse, die der Betreiber mit Ihnen teilt, ohne Ihr Zutun in den Dropdown-Listen erscheinen.

 

Was das für Sie bedeutet: Fehlt ein Erlebnis, eine Option oder eine Einheit in der Dropdown-Liste, hat der Betreiber es in Xola noch nicht mit Ihnen geteilt. Bitten Sie ihn, es zu Ihrer App hinzuzufügen.

Availability Sync

✅

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

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 Xola live die angezeigten Daten ab. Xola antwortet mit jedem Zeitslot, seinem Status und der verbleibenden Kapazität.

  • Bevor jemand mit dem Kalender interagiert, kann dieser das Ergebnis der letzten Abfrage dieser Daten anzeigen (zwischengespeichert).

 

Typischerweise bei Xola:

  • Die Anfragen umfassen in der Regel einen einzelnen Tag oder einige Tage, ab heute bis etwa 6 Monate im Voraus, während Nutzer suchen.

 

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

Ventrata fragt bei Xola die Verfügbarkeit für Zeiträume von 7 Tagen oder für einen einzelnen Tag ab.

Pricing Sync

✅

Bei aktivierter Backend-Preisgestaltung übernimmt Ventrata sowohl Verkaufs- als auch Nettopreise aus Xola.

Das funktioniert wie folgt:

  • Availability Check mit der Capability octo/pricing – Ventrata fragt bei jeder Verfügbarkeitsanfrage die Preise bei Xola ab. Die Preise werden dem Nutzer angezeigt und in Ventrata als per API generierte Tarife gespeichert.

  • Nettopreise (Großhandelspreise) von Xola werden als Einkaufspreis erfasst, unabhängig vom Kostenanteil, den Sie beim Betreiber hinterlegt haben.

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

Xola 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.

Bookings Sync

✅

Buchungen, Änderungen und Stornierungen, die in Ventrata für ein mit dem Backend verbundenes Produkt vorgenommen werden, werden automatisch an Xola gesendet.

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 Xola.

  2. Bestätigen: Booking Confirmation (POST /bookings/{uuid}/confirm) – nach der Zahlung bestätigt Ventrata die Buchung in Xola mit den Kontaktdaten des Kunden. Das Ticket oder der Voucher, den Xola zurückgibt, wird zum Ventrata-Ticket bzw. -Voucher, außer PDF_FILE, das Ventrata nicht unterstützt.

  3. Ändern: Booking Update (PATCH /bookings/{uuid}) – wenn eine Buchung in Ventrata geändert wird, wird die Änderung an Xola gesendet.

  4. Stornieren: Booking Cancellation (POST /bookings/{uuid}/cancel) – wenn eine Buchung in Ventrata storniert wird, wird sie auch in Xola storniert.

 

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

Content Sync

❌

Ventrata importiert keine Produktinhalte aus Xola.

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

Promotions Sync

❌

Werbeaktionen werden nicht an Xola übermittelt.

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

Pickups/Dropoff Sync

❌

Angaben zu Abholung und Absetzen werden nicht an Xola übermittelt.

Angaben zu Abholung und Absetzen werden nicht an Xola ü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 Xola übermittelt.

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

Extras Sync

❌

Extras und Zusatzleistungen werden nicht in Xola gebucht.

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

Redemption Sync

❌

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

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

Pass Walkup Scanning Sync

❌

Das Scannen von Pässen bei Laufkunden ist mit Xola nicht verfügbar.

Das Scannen von Pässen bei Laufkunden ist mit Xola nicht verfügbar.

Gift Card Sync

❌

Ventrata-Geschenkkarten werden nicht an Xola übermittelt.

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

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Verbindung mit Xola

  • Ein Betreiber pro Schlüssel: Jeder Betreiber, der Xola nutzt, gibt Ihnen einen eigenen OCTO API Key.

  • Nur geteilte Erlebnisse: Sie können nur die Erlebnisse zuordnen und verkaufen, die der Betreiber in Xola mit Ihrer App geteilt hat.

  • Live-Verfügbarkeit: Die Verfügbarkeit stammt aus Xola, während Nutzer suchen, sodass keine Verfügbarkeit manuell synchron gehalten werden muss.

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

 

FAQ

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

Der OCTO API Key oder der OCTO-Endpunkt ist höchstwahrscheinlich falsch. Klären Sie die Angaben 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-Listen zeigen, was der Betreiber in Xola mit Ihnen geteilt hat. Bitten Sie den Betreiber, es freizugeben. 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 Xola noch verfügbar ist. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

 

Nützliche Ressourcen

 

 

Partnerinformationen

Xola, Inc.

Hewes Building, 995 Market St

San Francisco, CA 94103, USA

 

Ventrata-Partner-ID: 360a0ae4-5437-4c21-9dfa-68c0e8e22c8a

Hat dies deine Frage beantwortet?