Zum Hauptinhalt springen

Smartvisit: Betreiber-Backend

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

Smartvisit logo

 

Smartvisit ist eine Plattform für Destinationserlebnisse, die Einrichtung, Preisgestaltung, Verkauf und Einlösung von Pässen für Tourismusbetreiber, Unterkunftsanbieter, Destinationsmarketingorganisationen und Treueprogramme übernimmt, mit Teams in den USA, Australien, Europa und der Golfregion. Ihre App bündelt Attraktionen, Touren, Gastronomie und Shopping in gebrandeten digitalen Pässen mit ticketlosem Eintritt und Audio-Rundgängen zum Selbsterkunden, die von Besuchern am Reiseziel in Echtzeit eingelöst werden.

 

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

 

Weitere Informationen zu Smartvisit finden Sie unter smartvisit.com.

 

📒 HINWEIS

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

 

📗 TIPP

Sie können Produkte oder Destinationen zusätzlich zu den Einstellungen beim Wiederverkäufer auch auf Verbindungsebene zulassen oder ausschließen. Das ist hilfreich, wenn Sie mehrere Verbindungen mit Smartvisit haben, die mit demselben Wiederverkäufer verknüpft sind.

📗 TIPP

Smartvisit kann auf alle Produkte zugreifen, die auf der Verbindung aktiviert sind. Sie können dem Partner auch die Produkt- und Options-IDs von der Verbindungsseite geben, um festzulegen, was zugeordnet werden soll.

 

Hauptwebsite

Tags

Custom / Proprietary Operator System

Verbindungsfunktionen

Availability Sync · Bookings Sync

Entwickelt von

Ventrata (über die Smartvisit OCTO API)

 

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

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

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

 

Verbindung mit Smartvisit 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-Schlüssel (auf der Verbindung in Ventrata angezeigt) für den Betreiber. Siehe die folgenden Schritte.

  • Eine Handelsvereinbarung mit Smartvisit, damit der Partner Ihre Produkte verkaufen kann.

  • Smartvisit ist in Ventrata als Wiederverkäufer mit konfigurierten Verkaufs- und Großhandels-/Provisionspreisen angelegt.

  • 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: Smartvisit als Wiederverkäufer anlegen

Legen Sie Smartvisit in Ventrata als Wiederverkäufer mit korrekt konfigurierten Verkaufs- und Großhandels-/Provisionspreisen an. Die Verbindung übernimmt die Konfiguration des Wiederverkäufers, etwa Preise, zugelassene Destinationen und Produkte.

 

Schritt 2: Betreiber in Ventrata konfigurieren

Ventrata generiert ihn beim Erstellen der Verbindung; Sie senden ihn per E-Mail an Ihren Ansprechpartner bei Smartvisit, damit Ihre Produkte zugeordnet werden können.

 

  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) Smartvisit aus und geben Sie den OCTO-API-Schlüssel (auf der Verbindung in Ventrata angezeigt) ein.

  3. Press Update Operator.

 

 

📒 HINWEIS – Jeder OCTO-API-Schlüssel (auf der Verbindung in Ventrata angezeigt) verbindet Sie mit einem Betreiber. Richten Sie jeden Betreiber, der Smartvisit nutzt, separat ein.

 

Schritt 3: 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 Smartvisit zu verwenden.

  3. Press Update Product.

 

Produkte zu Smartvisit zuordnen

‼️ WICHTIG

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

  4. Press 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 Smartvisit angekommen ist.

 

Verbindung mit Smartvisit verwalten

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

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

 

Verbindungsfunktionen im Detail

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

 

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

Das funktioniert wie folgt:

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

Content Sync

❌

Ventrata importiert keine Produktinhalte aus Smartvisit.

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

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

  • Synchronisiert Verfügbarkeit und Preise Ihrer Produkte bei Smartvisit in Echtzeit mit Ventrata.

 

Typischerweise bei Smartvisit:

  • 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 Smartvisit. So können Sie keinen Zeitslot überverkaufen, den der Betreiber bereits anderweitig verkauft hat.

Pricing Sync

❌

Ventrata liest keine Preise aus Smartvisit.

Ventrata liest keine Preise aus Smartvisit. Die Produkte verwenden die Preise, die Sie in Ventrata festgelegt haben, und Buchungen werden weiterhin an Smartvisit übermittelt.

Promotions Sync

❌

Werbeaktionen werden nicht an Smartvisit übermittelt.

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

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

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

Übernimmt Buchungen, Änderungen und Stornierungen von Smartvisit in Ventrata.

 

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

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

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

Extras Sync

❌

Extras und Zusatzleistungen werden nicht in Smartvisit gebucht.

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

Redemption Sync

❌

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

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

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

Gift Card Sync

❌

Ventrata-Geschenkkarten werden nicht an Smartvisit übermittelt.

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

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Verbindung mit Smartvisit

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

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

  • Smartvisit erstellt digitale Stadt- und Destinationspässe (Attraktionen, Touren, Gastronomie, Shopping) als App-basierte Produkte mit ticketloser Einlösung und standortbezogenen Audio-Rundgängen.

  • Arbeitet mit Destinationsmarketingorganisationen, Hotels und Treueprogrammen zusammen.

 

FAQ

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

Höchstwahrscheinlich ist der OCTO-API-Schlüssel (auf der Verbindung in Ventrata angezeigt) 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 Smartvisit 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 Smartvisit noch verfügbar ist. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

 

Nützliche Ressourcen

 

 

Partnerinformationen

Smartvisit

Suite 202, 99 Alexander Street

Crows Nest, New South Wales 2065, Australien

 

Ventrata-Partner-ID: bb75947b-a65b-4f1b-af5b-d0a2f55b51b4

Hat dies deine Frage beantwortet?