Zum Hauptinhalt springen

Zaui: Betreiber-Backend

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

Zaui logo

 

Zaui ist eine Reservierungsplattform aus Vancouver für Tour-, Aktivitäts-, Transport- und Vermietungsbetreiber, die seit 1999 besteht und für sitzplatz- und zeitbasiertes Inventar ausgelegt ist. Eine besondere Stärke sind transportlastige Betriebe wie Shuttles, Fernbusse, Flughafen- und Kreuzfahrthafentransfers und Bootsdienste, neben Sightseeing- und Mehrtagestouren, mit Channel-Management, dynamischer Preisgestaltung und mobilem Check-in über ein einziges Dashboard.

 

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

 

Weitere Informationen zu Zaui finden Sie unter zaui.com.

 

📒 HINWEIS

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

 

Hauptwebsite

Tags

Booking / Ticketing System

Verbindungsfunktionen

Availability Sync · Pricing Sync · Bookings Sync

Entwickelt von

Ventrata (über die Zaui OCTO API)

 

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

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

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

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

 

Verbindung mit Zaui 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 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 Ihren Betreiber nach dem OCTO API Key. Betreiber können die Verbindung (den Kanal) in Zaui unter Resellers > Channel Partners einrichten und dort den Schlüssel erhalten, indem sie Ventrata auswählen.

 

  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) Zaui aus und geben Sie den OCTO API Key ein. Belassen Sie den Endpunkt beim Standardwert https://api.zaui.io/octo, sofern der Betreiber oder Zaui nichts anderes angibt.

  3. Belassen Sie im Feld „OCTO-Endpunkt“ (OCTO Endpoint) den vorausgefüllten Wert für Zaui, sofern der Betreiber oder Zaui nichts anderes vorgibt.

  4. Klicken Sie auf Betreiber aktualisieren (Update Operator).

 

 

Wählen Sie im Abschnitt „Backend-Partner“ (Backend Partner) Zaui 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 Zaui nichts anderes vorgibt, belassen Sie im Feld „OCTO-Endpunkt“ (OCTO Endpoint) den vorausgefüllten Standardwert für Zaui.

 

📒 HINWEIS – Jeder OCTO API Key verbindet Sie mit einem Betreiber. Richten Sie jeden Betreiber, der Zaui 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 Zaui zu verwenden, und Backend-Preisgestaltung (Backend Pricing), um die Preise aus Zaui zu verwenden.

  3. Klicken Sie auf Produkt aktualisieren (Update Product).

📒 HINWEIS

Zaui sendet sowohl Verkaufs- als auch Nettopreise. Ist Backend-Preisgestaltung (Backend Pricing) aktiviert, erfasst Ventrata den Verkaufspreis als Ihren Verkaufspreis und den Nettopreis als Ihren Einkaufspreis, unabhängig vom beim Betreiber hinterlegten Kostenanteil.

 

Aktivieren Sie „Backend-Verfügbarkeit“, um die Verfügbarkeit aus Zaui abzurufen, und „Backend-Preisgestaltung“, um die Preise abzurufen.

 

Ohne diese Optionen verwendet das Produkt die in Ventrata festgelegte Verfügbarkeit und die dort festgelegten Preise, Buchungen werden aber weiterhin an Zaui übermittelt.

 

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

 

Produkte zu Zaui zuordnen

‼️ WICHTIG

Über die Zuordnung erfährt Ventrata, für welches Produkt, welche Option und welche Einheiten in Zaui 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 Zaui lädt, das passende Produkt, die passende Option und die passenden Einheiten in Zaui aus. Lassen Sie kein Feld leer.

  4. Klicken Sie auf 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 Zaui ü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 Zaui angekommen ist.

 

Verbindung mit Zaui verwalten

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

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

 

Verbindungsfunktionen im Detail

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

 

Die Zeitangaben sind für Zaui 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 Zaui zu.

Das funktioniert wie folgt:

  • Get Products (GET /products) – Ventrata liest die Produkte, Optionen und Einheiten des Betreibers in Zaui, 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 Zaui nicht freigegeben. Bitten Sie ihn darum.

Content Sync

❌

Ventrata importiert keine Produktinhalte aus Zaui.

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

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 Zaui live die angezeigten Daten ab.

  • Bei aktivierter Backend-Verfügbarkeit stellt Ventrata eine Live-Anfrage an Zaui, wenn ein Nutzer mit dem Verfügbarkeitskalender interagiert (Dashboard, Web Checkout, Terminal usw.). Die Anfragen beziehen sich in der Regel auf einen Zeitraum von 7 Tagen oder einen bestimmten Tag. Bis der Nutzer mit dem Kalender interagiert, zeigt dieser möglicherweise zwischengespeicherte, nicht aktuelle Daten aus der vorherigen Anfrage.

 

Typischerweise bei Zaui:

  • 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 Zaui. 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 Zaui.

Das funktioniert wie folgt:

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

  • Bei aktivierter Backend-Preisgestaltung ruft Ventrata in derselben Live-Verfügbarkeitsanfrage sowohl Verkaufs- als auch Nettopreise (Großhandelspreise) aus Zaui 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 beim Betreiber hinterlegten Kostenanteil.

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

Zaui sendet sowohl Verkaufs- als auch Nettopreise. Ist Backend-Preisgestaltung (Backend Pricing) aktiviert, erfasst Ventrata den Verkaufspreis als Ihren Verkaufspreis und den Nettopreis als Ihren Einkaufspreis, unabhängig vom beim Betreiber hinterlegten Kostenanteil.

Promotions Sync

❌

Werbeaktionen werden nicht an Zaui übermittelt.

Werbeaktionen werden nicht an Zaui ü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 Zaui 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 Zaui.

  2. Bestätigen: Booking Confirmation (POST /bookings/{uuid}/confirm) – Nach der Zahlung bestätigt Ventrata die Buchung in Zaui mit den Kontaktdaten des Kunden, und das von Zaui 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 Zaui gesendet.

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

Reservierung, wenn ein Produkt in den Warenkorb gelegt wird. Bestätigung nach der Zahlung, wobei die Kontaktdaten des Kunden gesendet werden; der Voucher bzw. das Ticket von Zaui wird in Ventrata übernommen (außer PDF_FILE, das Ventrata nicht unterstützt). In Ventrata vorgenommene Änderungen und Stornierungen werden an Zaui gesendet.

 

‼️ WICHTIG – Buchungen werden nur in eine Richtung synchronisiert, von Ventrata zu Zaui. Wenn der Betreiber eine Buchung in Zaui ä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 Zaui übermittelt.

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

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

Extras Sync

❌

Extras und Zusatzleistungen werden nicht in Zaui gebucht.

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

Redemption Sync

❌

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

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

Nicht unterstützt. Der Buchungsstatus aus Zaui, etwa „Redeemed“, wird nach der Bestätigung nicht an Ventrata zurückgemeldet.

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

Ventrata-Geschenkkarten werden nicht an Zaui übermittelt.

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

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Verbindung mit Zaui

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

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

 

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 Zaui 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 Zaui noch verfügbar ist. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

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 den Support.

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

Für den beim Produkt ausgewählten Betreiber ist höchstwahrscheinlich kein Backend konfiguriert. Prüfen Sie die Backend-Konfiguration und versuchen Sie es erneut. Besteht das Problem weiterhin, wenden Sie sich an den Support.

 

Nützliche Ressourcen

 

 

Partnerinformationen

Zaui Software Ltd.

Suite 423 - 119 Pender Street West

Vancouver, BC V6B 1S5, Kanada

 

Ventrata-Partner-ID: 09fc078e-fea1-4519-92d4-5eef643ca954

Hat dies deine Frage beantwortet?