Zum Hauptinhalt springen

TripWorks: Betreiber-Backend

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

TripWorks logo

 

TripWorks ist eine Buchungs- und Reservierungsplattform für Betreiber von Touren, Aktivitäten und Attraktionen, die vor allem in den USA genutzt wird, für Rundflüge und Bootstouren, Sightseeing und Stadtführungen, Abenteuer- und Outdoor-Aktivitäten, Attraktionen und Unterhaltungsstätten. Sie deckt Entdeckung, Buchung, Zahlungen, Planung, Check-in und Analysen ab, mit KI-Chat- und Telefonagenten, die rund um die Uhr Buchungen entgegennehmen, und mehr als 50 Vertriebsintegrationen.

 

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

 

Weitere Informationen zu TripWorks finden Sie unter tripworks.com.

 

📒 HINWEIS

Jeder API-Schlüssel verbindet Sie mit einem Betreiber. Wenn Sie mehr als einen Betreiber weiterverkaufen, der TripWorks nutzt, legen Sie in Ventrata für jeden einen eigenen Betreiber mit eigenem API-Schlüssel an.

‼️ WICHTIG

Über die Zuordnung erfährt Ventrata, für welches Produkt, welche Option und welche Einheiten in TripWorks die Verfügbarkeit abgefragt und gebucht werden soll. Sind mit dem Backend verbundene Produkte nicht korrekt zugeordnet, schlagen Buchungen fehl. Eine rote Markierung über die gesamte Produktzeile zeigt ein falsch zugeordnetes Produkt an.

📗 TIPP

Nehmen Sie nach der Zuordnung eine Testbuchung vor und bitten Sie Ihren Betreiber zu bestätigen, dass sie in TripWorks erscheint.

 

Hauptwebsite

Tags

Booking / Ticketing System

Verbindungsfunktionen

Availability Sync · Pricing Sync · Bookings Sync

Entwickelt von

Ventrata (über die TripWorks OCTO API)

 

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

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

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

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

 

Verbindung mit TripWorks 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.

  • Jeder API-Schlüssel verbindet Sie mit nur einem Betreiber.

  • 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 Betreiber fordert ihn für Sie bei TripWorks an. TripWorks stellt für jede Beziehung zwischen Wiederverkäufer und Betreiber einen eigenen Schlüssel aus. Bitten Sie darum, [email protected] in Kopie zu setzen, damit Ventrata bei Bedarf helfen kann.

 

  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) TripWorks aus und geben Sie den OCTO-API-Schlüssel (OCTO API Key) ein. Behalten Sie den Standard-Endpunkt bei, sofern TripWorks oder Ihr Betreiber nichts anderes angibt.

  3. Geben Sie beim Anlegen des Betreibers dessen Namen ein (zum Beispiel HeliNY).

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

 

 

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

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

📒 HINWEIS

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

 

Weisen Sie im Abschnitt „Operator & Backend“ des Produkts den Betreiber von TripWorks zu, aktivieren Sie „Backend verbunden“ (Backend Connected) und lassen Sie „Backend-Verfügbarkeit“ (Backend Availability) aktiviert, um die Live-Verfügbarkeit abzurufen.

 

Aktivieren Sie optional „Backend-Preisgestaltung“ (Backend Pricing), um die Preise aus TripWorks abzurufen. Bleibt die Option deaktiviert, verwendet das Produkt die in Ventrata festgelegten Preise, übermittelt Buchungen aber weiterhin an TripWorks.

 

Wiederholen Sie dies für jedes Produkt, das Sie weiterverkaufen.

 

Produkte zu TripWorks zuordnen

‼️ WICHTIG

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

  4. Klicken Sie auf Save Changes.

📒 HINWEIS

Produkte erscheinen unter ihrem Erlebnisnamen in TripWorks. Ordnen Sie jede Ventrata-Einheit (zum Beispiel Erwachsener, Kind) der passenden Einheit in TripWorks zu.

 

📗 TIPP

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

 

Verbindung mit TripWorks verwalten

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

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

 

Verbindungsfunktionen im Detail

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

 

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

Das funktioniert wie folgt:

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

Content Sync

❌

Ventrata importiert keine Produktinhalte aus TripWorks.

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

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

  • Mit „Backend-Verfügbarkeit“ (Backend Availability) fragt Ventrata die Live-Verfügbarkeit bei TripWorks ab, wenn ein Nutzer im Dashboard, im Checkout oder in anderen Vertriebskanälen Termine durchsucht.

 

Was das für Sie bedeutet: Kunden buchen auf Basis der Live-Verfügbarkeit des Betreibers in TripWorks. 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 TripWorks.

Das funktioniert wie folgt:

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

  • Mit „Backend-Preisgestaltung“ (Backend Pricing) ruft Ventrata die Preise zusammen mit der Verfügbarkeit aus TripWorks ab. Die Preise enthalten die Steuern und Gebühren des Betreibers, sodass der bei der Verfügbarkeit angezeigte Preis dem Preis bei der Bestätigung entspricht. Ob es sich um Verkaufs- oder Nettopreise handelt, ist nicht angegeben.

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

TripWorks 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 TripWorks übermittelt.

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

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

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

Die Verfügbarkeit wird in TripWorks reserviert, wenn ein Produkt in den Warenkorb gelegt wird, und nach der Zahlung zusammen mit den Kontaktdaten des Kunden bestätigt. Buchungsänderungen (Datum, Uhrzeit, Mengen) und Stornierungen, die in Ventrata vorgenommen werden, werden automatisch an TripWorks gesendet.

 

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

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

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

Extras Sync

❌

Extras und Zusatzleistungen werden nicht in TripWorks gebucht.

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

Redemption Sync

❌

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

Einlösungen und andere Statusänderungen in TripWorks 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 TripWorks nicht verfügbar.

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

Gift Card Sync

❌

Ventrata-Geschenkkarten werden nicht an TripWorks übermittelt.

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

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Verbindung mit TripWorks

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

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

  • Voucher/Tickets: TripWorks gibt einen QR-Code für die Buchung und für jedes Ticket zurück, und Ventrata stellt diese Ihrem Kunden aus. Der QR-Code verweist auf das Kundenportal des Betreibers in TripWorks und wird vom Betreiber bei der Ankunft gescannt.

 

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

Fehler beim Speichern der Backend-Konfiguration des Betreibers.

Der OCTO API Key ist wahrscheinlich falsch oder noch nicht aktiv. Klären Sie dies mit Ihrem Betreiber ab. Besteht das Problem weiterhin, wenden Sie sich an [email protected].

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

Die Dropdown-Liste zeigt nur die Produkte, Optionen und Einheiten, die der Betreiber in TripWorks für Sie freigegeben hat. Bitten Sie Ihren Betreiber, die Zuteilung auf seiner Seite zu prüfen.

 

Nützliche Ressourcen

 

 

Partnerinformationen

TripWorks, Inc.

1 High Street Ct.

Morristown, NJ 07960, United States

 

Ventrata-Partner-ID: 01a159ec-f15a-73fd-96c5-917ef887269b

Hat dies deine Frage beantwortet?