Zum Hauptinhalt springen

Clorian: Betreiber-Backend

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

Clorian logo

 

Clorian ist eine Ticketing-Plattform aus Barcelona für Museen, Monumente und Kultureinrichtungen, die Online- und Vor-Ort-Verkauf, Kapazitäten für Zeitfenstertickets und Zutrittskontrolle für Stätten wie die Sagrada Família, La Pedrera und die Mezquita-Catedral de Córdoba abwickelt. Nach eigenen Angaben werden über ihre Einrichtungen mehr als 28 Millionen Tickets pro Jahr verkauft, mit einem Netz von mehr als 14.000 Wiederverkäufern.

 

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

 

Weitere Informationen zu Clorian finden Sie unter clorian.com.

 

📒 HINWEIS

Wenn für Ihr Produktangebot beide Zahlungsmethoden erforderlich sind (Deferred Payment und Pre-payment), legen Sie in Ventrata zwei separate Betreiber an, damit die Zahlungen korrekt abgewickelt werden.

‼️ WICHTIG

Über die Zuordnung weiß Ventrata, für welches Produkt von Clorian die Verfügbarkeit angefragt werden soll. Sind mit dem Backend verbundene Produkte nicht korrekt zugeordnet, schlagen Buchungen des Produkts fehl. Eine rote Markierung über der gesamten Produktzeile bedeutet, dass das Produkt nicht korrekt zugeordnet ist.

 

Hauptwebsite

Tags

Booking / Ticketing System

Verbindungsfunktionen

Availability Sync · Pricing Sync · Bookings Sync

Entwickelt von

Ventrata (über Clorian B2B API)

 

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

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

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

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

 

Die externe API von Clorian, die für diese Verbindung verwendet wird, ist eine individuelle API, die nicht dem OCTO API-Standard entspricht. Dadurch können bestimmte Funktionen und Möglichkeiten eingeschränkt sein.

 

Verbindung mit Clorian 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 API Key, den Benutzernamen und das Passwort für den Betreiber. Siehe die folgenden Schritte.

  • Eine Handelsvereinbarung mit dem Betreiber, dessen Produkte Sie über Clorian weiterverkaufen möchten.

  • Die Produkte von Clorian, in Ventrata neu angelegt und genau passend zur Konfiguration in Clorian.

  • 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: Zugangsdaten für Clorian erhalten

Wenden Sie sich an Clorian und fordern Sie Ihren API Key sowie Ihren Benutzernamen und Ihr Passwort für Clorian an.

 

  • API Key

  • Username

  • Password

 

Schritt 2: Betreiber in Ventrata konfigurieren

Wenden Sie sich an Clorian und fordern Sie Ihren API Key sowie Ihren Benutzernamen und Ihr Passwort für Clorian an.

 

  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) Clorian aus und geben Sie den API Key, den Benutzernamen und das Passwort ein.

  3. Wählen Sie im Feld Backend-Partner Clorian aus.

  4. Geben Sie den API Key, den Benutzernamen und das Passwort ein, die Sie von Clorian erhalten haben (Pflichtangaben).

  5. Optional: Wählen Sie die Zahlungsart für Ihre Produkte: Deferred Payment (Standard bei Clorian, spätere Rechnungsstellung) oder Pre-payment (Anzahlung).

  6. Klicken Sie auf Create Operator.

  7. Press Update Operator.

 

 

 

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

  3. Press Update Product.

📒 HINWEIS

Clorian 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 beim Produkt Backend verbunden und lassen Sie Backend-Verfügbarkeit aktiviert.

 

Aktivieren Sie Backend-Preisgestaltung, wenn Sie die Preise von Clorian übernehmen möchten.

 

Click Update Product.

 

 

Produkte zu Clorian zuordnen

‼️ WICHTIG

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

 

Verbindung mit Clorian verwalten

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

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

 

Verbindungsfunktionen im Detail

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

 

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

Das funktioniert wie folgt:

  • Produkte – Ventrata liest die Produkte, Optionen und Einheiten des Betreibers in Clorian, um die Dropdown-Menüs auf dem Tab Zuordnungen (Mappings) zu füllen.

  • Beobachtete Pfade: GET /v2/clients, GET /v2/products/{n}.

 

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

Content Sync

❌

Ventrata importiert keine Produktinhalte aus Clorian.

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

Das funktioniert wie folgt:

  • Verfügbarkeit – Wenn jemand den Verfügbarkeitskalender in Ventrata nutzt, zum Beispiel im Dashboard, in Ihrem Web Checkout oder an einem Terminal, fragt Ventrata bei Clorian live die angezeigten Daten ab.

  • Live-Verfügbarkeit, synchronisiert aus Clorian.

  • Beobachtete Pfade: GET /v2/products/{n}, GET /v2/products/{n}/events.

 

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

Das funktioniert wie folgt:

  • Statische Preise, synchronisiert aus Clorian, ohne Aktionspreise. Werden übernommen, wenn beim Produkt Backend-Preisgestaltung aktiviert ist.

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

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

Promotions Sync

❌

Werbeaktionen werden nicht an Clorian übermittelt.

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

Nicht unterstützt: Produkte mit Werbeaktionen, einschließlich Werbeaktionen über die API.

Bookings Sync

✅

Buchungen, die in Ventrata für ein mit dem Backend verbundenes Produkt vorgenommen werden, werden im Konto des Betreibers bei Clorian angelegt.

Das funktioniert wie folgt:

  1. Reservieren und bestätigen: Wenn das Produkt in den Warenkorb gelegt wird, prüft Ventrata die Buchung bei Clorian. Nach der Zahlung legt Ventrata die Buchung mit den Kundendaten im Konto des Betreibers bei Clorian an.

  2. Tickets: Die Referenz oder die Tickets, die Clorian zurückgibt, werden in der Ventrata-Buchung gespeichert.

  3. Beobachtete Aufrufe: Confirm Booking, Create Booking.

Buchungen und Stornierungen werden von Ventrata an Clorian übermittelt. Buchungsänderungen von Ventrata an Clorian werden nicht unterstützt.

 

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

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

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

Extras Sync

❌

Extras und Zusatzleistungen werden nicht in Clorian gebucht.

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

Redemption Sync

❌

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

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

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

Gift Card Sync

❌

Ventrata-Geschenkkarten werden nicht an Clorian übermittelt.

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

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Verbindung mit Clorian

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

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

  • Individuelle API: Die API von Clorian ist keine OCTO API, daher können einige Funktionen im Vergleich zu OCTO-Backends eingeschränkt sein.

  • Clorian ist eine Ticketing-Plattform für bedeutende Kulturstätten und Veranstaltungsorte, die jährlich über 32 Millionen Tickets abwickelt und über ein Netz von mehr als 14.000 Vertriebspartnern verfügt.

  • Zahlungsart je Betreiber: Deferred Payment (Standard bei Clorian) oder Pre-payment (Anzahlung).

 

FAQ

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

Der API Key, der Benutzername und das Passwort oder der Endpunkt sind 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-Menüs zeigen, was der Betreiber Ihnen in Clorian 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 Clorian noch verfügbar ist. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

 

Nützliche Ressourcen

 

 

Partnerinformationen

Tiqueteo Spain, S.L.

Carrer de Veneçuela, 103, 1, Sant Martí

08019 Barcelona, Spanien

 

Ventrata-Partner-ID: b4dc43c9-5155-4d6c-8861-a73a83fce30d

Hat dies deine Frage beantwortet?