Onebox ist ein Ticketvertriebssystem aus Barcelona für Live-Events und Freizeit, das von Veranstaltern, Veranstaltungsorten, Festivals, Theatern, Museen, Stadien und Freizeitparks für Verkauf, dynamische Preisgestaltung, Saalpläne, Kapazität und Zutrittskontrolle genutzt wird. Zu den Kunden zählen Atlético de Madrid und das Teatro Apolo, das Unternehmen meldet mehr als 65 Millionen verkaufte Tickets, und sein Vertriebsnetz reicht bis zu Ticketing-Anbietern, Reisebüros, Hotels und Einkaufszentren in ganz Spanien.
Wenn Sie Onebox mit Ventrata verbinden, können Sie Produkte von Betreibern weiterverkaufen, die Onebox als Buchungssystem nutzen. Ventrata liest deren Live-Verfügbarkeit und Preise aus Onebox, und jede Buchung, die Sie entgegennehmen, wird direkt im Konto des Betreibers bei Onebox angelegt.
Weitere Informationen zu Onebox finden Sie unter oneboxtds.com.
📒 HINWEIS
Diese Verbindung ist demnächst verfügbar. Sie befindet sich in der Entwicklung. Wenn Sie sie nutzen möchten, wenden Sie sich an unseren technischen Support oder Ihren Ventrata Customer Success Manager.
‼️ WICHTIG
Über die Zuordnung weiß Ventrata, für welches Produkt die Verfügbarkeit bei Onebox angefragt werden soll. Ist ein mit dem Backend verbundenes Produkt nicht korrekt zugeordnet, schlagen seine Buchungen fehl. Eine rote Markierung über der gesamten Produktzeile bedeutet, dass das Produkt nicht korrekt zugeordnet ist.
📒 HINWEIS
Legen Sie die Produkte von Onebox in Ventrata neu an, genau passend zur Konfiguration in Onebox.
📗 TIPP
Beim Anlegen des Betreibers sind nur die mit einem Sternchen (*) markierten Felder Pflichtfelder.
Hauptwebsite | |
Tags | Booking / Ticketing System |
Verbindungsfunktionen | Availability Sync · Pricing Sync · Bookings Sync |
Entwickelt von | Ventrata (über die Onebox Distribution API) |
Mit dieser Betreiber-Verbindung (auch Backend genannt) können Sie Produkte von Betreibern weiterverkaufen, die Onebox als primäres Buchungssystem nutzen. Jede Buchung wird direkt in Onebox angelegt. Zu den Funktionen dieser Verbindung gehören:
Availability Sync – die Live-Verfügbarkeit stammt aus dem Konto des Betreibers bei Onebox.
Pricing Sync – die Preise stammen aus Onebox, oder Sie legen die Preise in Ventrata fest.
Bookings Sync – Buchungen werden von Ventrata an Onebox übermittelt, und Onebox stellt die Tickets oder Voucher aus.
Die externe API von Onebox, 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 Onebox 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 die Channel ID und das Client Secret für den Betreiber. Siehe die folgenden Schritte.
Legen Sie die Produkte von Onebox in Ventrata neu an, genau passend zur Konfiguration in Onebox.
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: Handelsvereinbarung unterzeichnen und Zugangsdaten anfordern
Schließen Sie eine Handelsvereinbarung mit dem Betreiber ab, dessen Produkte Sie über Onebox weiterverkaufen möchten.
Wenden Sie sich an Onebox und fordern Sie die unten genannten Zugangsdaten an.
Channel ID
Client Secret
Schritt 2: Betreiber in Ventrata konfigurieren
Wenden Sie sich an Onebox und fordern Sie die Channel ID und das Client Secret an.
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.
Wählen Sie im Abschnitt Backend-Partner (Backend Partner) Onebox aus und geben Sie die Channel ID und das Client Secret ein.
Press Update Operator.
Schritt 3: Jedes Produkt verbinden
Ö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.
Aktivieren Sie Backend verbunden (Backend Connected). Aktivieren Sie Backend-Verfügbarkeit (Backend Availability), um die Verfügbarkeit aus Onebox zu verwenden, und Backend-Preisgestaltung (Backend Pricing), um die Preise aus Onebox zu verwenden.
Press Update Product.
📒 HINWEIS
Onebox sendet nur Nettopreise. Ist Backend-Preisgestaltung (Backend Pricing) aktiviert, erfasst Ventrata den Nettopreis als Ihren Einkaufspreis und berechnet den Verkaufspreis anhand des Kostenanteils, der beim Betreiber im Ventrata Dashboard hinterlegt ist.
Aktivieren Sie Backend verbunden und lassen Sie Backend-Verfügbarkeit aktiviert.
Aktivieren Sie Backend-Preisgestaltung, wenn Sie die Preise vom Backend-Partner übernehmen möchten.
Produkte zu Onebox zuordnen
‼️ WICHTIG
Über die Zuordnung erfährt Ventrata, für welches Produkt, welche Option und welche Einheiten in Onebox 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.
Gehen Sie im Ventrata Dashboard zu Produkte → Produkte (Products → Products) und öffnen Sie das Produkt.
Öffnen Sie den Tab Zuordnungen (Mappings). Er wird angezeigt, sobald das Produkt auf Backend verbunden (Backend Connected) gesetzt ist.
Wählen Sie für jede Ventrata-Option und -Einheit in den Dropdown-Menüs, die Ventrata aus Onebox lädt, das passende Produkt, die passende Option und die passenden Einheiten in Onebox aus. Lassen Sie kein Feld leer.
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 Onebox angekommen ist.
Verbindung mit Onebox verwalten
Aktualisieren Sie die Zuordnung, wenn der Betreiber Produkte, Optionen oder Einheiten in Onebox ändert.
Ersetzen Sie den Schlüssel beim Betreiber, wenn Onebox 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 Onebox übermittelt.
Verbindungsfunktionen im Detail
Dieser Abschnitt richtet sich an alle, die genau wissen möchten, wie die Verbindung mit Onebox funktioniert. Die Richtung ist hier umgekehrt wie bei einer Wiederverkäufer-Verbindung: Ventrata ruft Onebox auf, und zwar über die Onebox Distribution 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 Onebox Verfügbarkeit und Preise ab, sobald jemand ein mit dem Backend verbundenes Produkt aufruft, und legt jede Buchung im Konto des Betreibers bei Onebox an. Onebox meldet keine Änderungen an Ventrata zurück.
Die Zeitangaben sind für Onebox 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 Onebox zu. Das funktioniert wie folgt:
Was das für Sie bedeutet: Wenn etwas im Dropdown-Menü fehlt, hat der Betreiber es Ihnen in Onebox nicht freigegeben. Bitten Sie ihn darum. |
Content Sync | ❌ |
Ventrata importiert keine Produktinhalte aus Onebox. Ventrata importiert keine Produktinhalte aus Onebox. 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 Onebox. Das funktioniert wie folgt:
Typischerweise bei Onebox:
Was das für Sie bedeutet: Kunden buchen auf Basis der Live-Verfügbarkeit des Betreibers in Onebox. 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 Onebox. Das funktioniert wie folgt:
Onebox sendet nur Nettopreise. Ist Backend-Preisgestaltung (Backend Pricing) aktiviert, erfasst Ventrata den Nettopreis als Ihren Einkaufspreis und berechnet den Verkaufspreis anhand des Kostenanteils, der beim Betreiber im Ventrata Dashboard hinterlegt ist. |
Promotions Sync | ❌ |
Werbeaktionen werden nicht an Onebox übermittelt. Werbeaktionen werden nicht an Onebox ü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 Onebox angelegt. Das funktioniert wie folgt:
Übermittelt Buchungen von Ventrata an Onebox. Buchungsänderungen und Stornierungen von Ventrata an Onebox werden nicht unterstützt.
‼️ WICHTIG – Buchungen werden nur in eine Richtung synchronisiert, von Ventrata zu Onebox. Wenn der Betreiber eine Buchung in Onebox ä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 Onebox übermittelt. Angaben zu Abholung und Absetzen werden nicht an Onebox ü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 Onebox übermittelt. Antworten auf Ihre Buchungsfragen werden nicht an Onebox übermittelt. Teilen Sie sie dem Betreiber auf anderem Weg mit, wenn er sie benötigt. |
Extras Sync | ❌ |
Extras und Zusatzleistungen werden nicht in Onebox gebucht. Extras und Zusatzleistungen werden nicht in Onebox gebucht. Gebucht werden nur das Hauptprodukt, die Option und die Einheiten. |
Redemption Sync | ❌ |
Einlösungen und andere Statusänderungen in Onebox werden nach der Bestätigung einer Buchung nicht an Ventrata zurückgemeldet. Einlösungen und andere Statusänderungen in Onebox 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 Onebox nicht verfügbar. Das Scannen von Pässen bei Laufkunden ist mit Onebox nicht verfügbar. |
Gift Card Sync | ❌ |
Ventrata-Geschenkkarten werden nicht an Onebox übermittelt. Ventrata-Geschenkkarten werden nicht an Onebox übermittelt. Zahlungen mit Geschenkkarten verbleiben in Ventrata. |
✅ unterstützt · ❌ nicht unterstützt
Gut zu wissen: Grenzen und Details der Verbindung mit Onebox
Gut zu wissen: Grenzen und Details der Verbindung mit Onebox
Live-Verfügbarkeit: Die Verfügbarkeit wird aus Onebox abgerufen, während Kunden das Angebot durchsuchen.
Buchungen in eine Richtung: Änderungen, die der Betreiber in Onebox vornimmt, erreichen Ventrata nicht.
Individuelle API: Die API von Onebox ist keine OCTO API, daher können einige Funktionen im Vergleich zu OCTO-Backends eingeschränkt sein.
Onebox ist ein zentrales Ticketvertriebssystem (TDS), das über ein einziges API-Gateway Zugriff auf Live-Event-Inventar, Preise und Saalpläne mit Platzzuweisung mehrerer Veranstaltungsorte bietet.
FAQ
Beim Speichern der Backend-Konfiguration des Betreibers erhalte ich eine Fehlermeldung.
Beim Speichern der Backend-Konfiguration des Betreibers erhalte ich eine Fehlermeldung.
Die Channel ID und das Client Secret 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).
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.
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 Onebox 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.
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 Onebox noch verfügbar ist. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.
Nützliche Ressourcen
📚 Mehr über Ventrata-Verbindungen
Partnerinformationen
ONEBOX IBERICA, S.L.
Via Augusta 21 - 23
08006 Barcelona, Spanien
Ventrata-Partner-ID: 4b72f238-0436-4b6a-ae39-5849d1f7740c