Outbox ist eine in Montréal ansässige Cloud-Ticketing-Plattform für Live-Events und Veranstaltungsorte, die als White-Label-Lösung mit digitalen Tickets und Wallet, Steh- und Sitzplätzen mit Platzwahl, 3D-Saalplänen, Kontingent- und Vertriebssteuerung sowie einer vollständigen API in mehreren Sprachen und Währungen angeboten wird. Das Unternehmen meldet mehr als 500 Millionen verkaufte Tickets für Kunden wie Bell Centre, Cirque du Soleil, Osheaga, The O2 sowie Veranstaltungsorte in Kanada, den USA, Großbritannien und Mexiko.
Wenn Sie Outbox mit Ventrata verbinden, können Sie Produkte von Betreibern weiterverkaufen, die Outbox als Buchungssystem nutzen. Ventrata liest deren Live-Verfügbarkeit und Preise aus Outbox, und jede Buchung, die Sie entgegennehmen, wird direkt im Konto des Betreibers bei Outbox angelegt.
Weitere Informationen zu Outbox finden Sie unter outbox.com.
‼️ WICHTIG
Die für diese Verbindung verwendete externe API von Outbox ist eine individuelle XML-RPC-API, die nicht dem OCTO-API-Standard folgt, was bestimmte Funktionen und Möglichkeiten einschränken kann.
‼️ WICHTIG
Da Outbox Sitzplätze mit Zeitfenster verkauft, verwenden Sie immer Backend-Verfügbarkeit (Backend Availability). Ohne diese Einstellung können Buchungen für Zeitfenster getätigt werden, die in Outbox nicht existieren oder ausverkauft sind, und schlagen dann fehl.
📗 TIPP
Führen Sie nach der Zuordnung eine Testbuchung durch und bitten Sie den Betreiber zu bestätigen, dass sie mit dem richtigen Zeitfenster und den richtigen Ticketarten in Outbox angekommen ist.
Hauptwebsite | |
Tags | Booking / Ticketing System |
Verbindungsfunktionen | Availability Sync · Pricing Sync · Bookings Sync |
Entwickelt von | Ventrata (über Outbox Partner Sell API) |
Mit dieser Betreiber-Verbindung (auch Backend genannt) können Sie Produkte von Betreibern weiterverkaufen, die Outbox als primäres Buchungssystem nutzen. Jede Buchung wird direkt in Outbox angelegt. Zu den Funktionen dieser Verbindung gehören:
Availability Sync – die Live-Verfügbarkeit stammt aus dem Konto des Betreibers bei Outbox.
Pricing Sync – die Preise stammen aus Outbox, oder Sie legen die Preise in Ventrata fest.
Bookings Sync – Buchungen werden von Ventrata an Outbox übermittelt, und Outbox stellt die Tickets oder Voucher aus.
Die externe API von Outbox, 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 Outbox 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-Schlüssel und die API-URL des Betreibers. Siehe die folgenden Schritte.
Achten Sie darauf, Produktionszugangsdaten zu erhalten: Staging und Produktion verwenden unterschiedliche URLs und Schlüssel, und das Produktionskontingent wird getrennt vom Staging eingerichtet.
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 beantragt bei seinem Account Manager von Outbox einen neuen API-Kanal für Sie; dieser richtet auch die Onsales und das Kontingent ein, die Sie verkaufen dürfen. Outbox stellt die Zugangsdaten aus.
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 Bereich Backend-Partner (Backend Partner) Outbox aus und geben Sie API-Schlüssel und API-URL ein.
Geben Sie den API-Schlüssel ein: Er identifiziert Sie als Vertriebskanal (Wiederverkäufer) im System des Betreibers, das auf Outbox basiert, und legt fest, welche Onsales (Produkte) und welche Währung Ihnen zur Verfügung stehen. Jeder Wiederverkäufer benötigt einen eigenen Schlüssel; Schlüssel dürfen nicht zwischen Unternehmen geteilt werden.
Geben Sie die API-URL ein: die Adresse der API des Betreibers (Outbox), in der Regel auf der Ticketing-Domain des Betreibers und mit /extapi/ am Ende (zum Beispiel https://tickets.onetimessquare.com/extapi/). Sie muss mit https:// beginnen.
Klicken Sie auf Betreiber aktualisieren (Update Operator).
Schritt 2: 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 Outbox zu verwenden, und Backend-Preisgestaltung (Backend Pricing), um die Preise aus Outbox zu verwenden.
Klicken Sie auf Produkt aktualisieren (Update Product).
📒 HINWEIS
Outbox 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 Backend verbunden (Backend Connected), dann Backend-Verfügbarkeit (Backend Availability), um Zeitfenster und Verfügbarkeit abzurufen, und Backend-Preisgestaltung (Backend Pricing), um Preise abzurufen.
Produkte zu Outbox zuordnen
‼️ WICHTIG
Über die Zuordnung erfährt Ventrata, für welches Produkt, welche Option und welche Einheiten in Outbox 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 Outbox lädt, das passende Produkt, die passende Option und die passenden Einheiten in Outbox aus. Lassen Sie kein Feld leer.
Klicken Sie auf 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 Outbox angekommen ist.
Verbindung mit Outbox verwalten
Aktualisieren Sie die Zuordnung, wenn der Betreiber Produkte, Optionen oder Einheiten in Outbox ändert.
Ersetzen Sie den Schlüssel beim Betreiber, wenn Outbox 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 Outbox übermittelt.
Verbindungsfunktionen im Detail
Dieser Abschnitt richtet sich an alle, die genau wissen möchten, wie die Verbindung mit Outbox funktioniert. Hier ist die Richtung umgekehrt zu einer Wiederverkäufer-Verbindung: Ventrata ruft Outbox auf, über die Partner Sell API von Outbox. Für jede Funktion wird erklärt, welche Aufrufe Ventrata ausführt, wann diese erfolgen und was das für Sie bedeutet.
Kurz gesagt: Ventrata fragt bei Outbox Verfügbarkeit und Preise ab, sobald jemand ein mit dem Backend verbundenes Produkt aufruft, und legt jede Buchung im Konto des Betreibers bei Outbox an. Outbox meldet keine Änderungen an Ventrata zurück.
Die Zeitangaben sind für Outbox 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 Outbox zu. Das funktioniert wie folgt:
Was das für Sie bedeutet: Wenn etwas im Dropdown-Menü fehlt, hat der Betreiber es Ihnen in Outbox nicht freigegeben. Bitten Sie ihn darum. |
Content Sync | ❌ |
Ventrata importiert keine Produktinhalte aus Outbox. Ventrata importiert keine Produktinhalte aus Outbox. 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 Outbox. Das funktioniert wie folgt:
Was das für Sie bedeutet: Kunden buchen auf Basis der Live-Verfügbarkeit des Betreibers in Outbox. 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 Outbox. Das funktioniert wie folgt:
Outbox 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 Outbox übermittelt. Werbeaktionen werden nicht an Outbox ü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 Outbox angelegt. Das funktioniert wie folgt:
Reservieren: Sobald ein Produkt in den Warenkorb gelegt wird, werden die Plätze in Outbox für die von Outbox zurückgegebene Reservierungsdauer gesperrt; jede Bestellung bei Outbox umfasst ein einzelnes Zeitfenster. Bestätigen: nach der Zahlung, mit den Kontaktdaten des Kunden; Vorname, Nachname, E-Mail und Land sind Pflicht, Telefon und Postleitzahl werden übermittelt, sofern vorhanden, und die Kundensprache wird anhand des Gebietsschemas auf Französisch oder Englisch gesetzt. Die Bestellnummer von Outbox wird als Anbieterreferenz (Supplier Reference) gespeichert. Tickets: Für jeden Platz wird ein Barcode als QR-Code auf jedem Ventrata-Ticket ausgegeben, dazu ein PDF mit allen Tickets der Bestellung; die QR-Werte entsprechen dem PDF von Outbox. Aktualisieren: Outbox kann eine bestehende Bestellung nicht per API ändern, daher werden beim Aktualisieren einer bestätigten Buchung nur die Tickets neu ausgestellt; um Datum, Zeitfenster oder Ticketanzahl zu ändern, stornieren Sie und buchen Sie neu. Stornieren: Das Stornieren einer bestätigten Buchung storniert die Bestellung bei Outbox; das Stornieren einer unbestätigten (reservierten) Buchung gibt die gesperrten Plätze frei.
‼️ WICHTIG – Buchungen werden nur in eine Richtung synchronisiert, von Ventrata zu Outbox. Wenn der Betreiber eine Buchung in Outbox ä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 Outbox übermittelt. Angaben zu Abholung und Absetzen werden nicht an Outbox ü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 Outbox übermittelt. Antworten auf Ihre Buchungsfragen werden nicht an Outbox übermittelt. Teilen Sie sie dem Betreiber auf anderem Weg mit, wenn er sie benötigt. |
Extras Sync | ❌ |
Extras und Zusatzleistungen werden nicht in Outbox gebucht. Extras und Zusatzleistungen werden nicht in Outbox gebucht. Gebucht werden nur das Hauptprodukt, die Option und die Einheiten. |
Redemption Sync | ❌ |
Einlösungen und andere Statusänderungen in Outbox werden nach der Bestätigung einer Buchung nicht an Ventrata zurückgemeldet. Einlösungen und andere Statusänderungen in Outbox werden nach der Bestätigung einer Buchung nicht an Ventrata zurückgemeldet. Nicht unterstützt. Der Buchungsstatus aus Outbox (zum Beispiel ein gescanntes Ticket) wird nicht an Ventrata zurückgemeldet. |
Pass Walkup Scanning Sync | ❌ |
Das Scannen von Pässen bei Laufkunden ist mit Outbox nicht verfügbar. Das Scannen von Pässen bei Laufkunden ist mit Outbox nicht verfügbar. |
Gift Card Sync | ❌ |
Ventrata-Geschenkkarten werden nicht an Outbox übermittelt. Ventrata-Geschenkkarten werden nicht an Outbox übermittelt. Zahlungen mit Geschenkkarten verbleiben in Ventrata. |
✅ unterstützt · ❌ nicht unterstützt
Gut zu wissen: Grenzen und Details der Verbindung mit Outbox
Gut zu wissen: Grenzen und Details der Verbindung mit Outbox
Live-Verfügbarkeit: Die Verfügbarkeit wird aus Outbox abgerufen, während Kunden das Angebot durchsuchen.
Buchungen in eine Richtung: Änderungen, die der Betreiber in Outbox vornimmt, erreichen Ventrata nicht.
Individuelle API: Die API von Outbox ist keine OCTO API, daher können einige Funktionen im Vergleich zu OCTO-Backends eingeschränkt sein.
Tickets: QR-Codes und PDF-Tickets von Outbox werden an Ihre Kunden ausgegeben.
FAQ
Beim Speichern der Backend-Konfiguration des Betreibers erhalte ich eine Fehlermeldung.
Beim Speichern der Backend-Konfiguration des Betreibers erhalte ich eine Fehlermeldung.
Der API-Schlüssel und die API-URL bzw. der Endpunkt sind höchstwahrscheinlich falsch. Prüfen Sie sie mit Ihrem Betreiber. Wenn das Problem weiterhin besteht, 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 Outbox 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 Outbox noch verfügbar ist. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.
Fehler beim Aktualisieren des Betreibers zum Speichern der Backend-Konfiguration.
Fehler beim Aktualisieren des Betreibers zum Speichern der Backend-Konfiguration.
Der API-Schlüssel oder die API-URL ist wahrscheinlich falsch, oder es wurden Testzugangsdaten mit einer Produktions-URL verwendet (oder umgekehrt). Prüfen Sie dies noch einmal mit Ihrem Betreiber. Wenn das Problem weiterhin besteht, wenden Sie sich an den Support.
Das Produkt, die Option oder die Einheit, die ich zuordnen möchte, ist nicht im Dropdown-Menü, oder das Dropdown-Menü ist leer.
Das Produkt, die Option oder die Einheit, die ich zuordnen möchte, ist nicht im Dropdown-Menü, oder das Dropdown-Menü ist leer.
Das Dropdown-Menü wird anhand der Onsales, die Ihrem API-Schlüssel zugewiesen sind, aus Outbox geladen. Bitten Sie Ihren Betreiber, bei Outbox zu bestätigen, dass das Kontingent für Ihren API-Kanal in der verwendeten Umgebung eingerichtet ist (Staging und Produktion werden getrennt konfiguriert). Wenn das Problem weiterhin besteht, wenden Sie sich an den Support.
Produkte, Optionen oder Einheiten werden in den Zuordnungs-Dropdowns als „Undefined“ angezeigt.
Produkte, Optionen oder Einheiten werden in den Zuordnungs-Dropdowns als „Undefined“ angezeigt.
Die Namen stammen aus der Onsale-Einrichtung des Betreibers in Outbox. Bitten Sie Ihren Betreiber, in Outbox Titel und Beschreibungen der Preistypen hinzuzufügen.
Die Buchungsbestätigung schlägt mit „Country code is required“ fehl.
Die Buchungsbestätigung schlägt mit „Country code is required“ fehl.
Outbox verlangt für jede Bestellung ein Land. Stellen Sie sicher, dass der Checkout, das Buchungsformular oder die Wiederverkäufer-Verbindung, über die dieses Produkt verkauft wird, das Land des Kunden erfasst, und versuchen Sie es erneut.
Die Preise weichen von den Erwartungen des Betreibers ab.
Die Preise weichen von den Erwartungen des Betreibers ab.
Outbox gibt Preise inklusive Steuern zurück, die die Servicegebühren für Ihren Kanal enthalten. Klären Sie die Preistabellen und Servicegebühren für Ihren API-Kanal mit Ihrem Betreiber ab.
Für ein Datum werden keine Zeitfenster angezeigt.
Für ein Datum werden keine Zeitfenster angezeigt.
Der Betreiber hat für dieses Datum in Outbox kein Event oder keine Plätze freigegeben. Fragen Sie bei Ihrem Betreiber nach.
Nützliche Ressourcen
📚 Mehr über Ventrata-Verbindungen
Partnerinformationen
Outbox Technology Inc.
3575 Boulevard Saint-Laurent, Suite 705
Montreal, QC H2X 2T7, Kanada
Ventrata-Partner-ID: 01a06240-f33b-7362-b04f-35ed782cee0e