Allgemeines
Falcana bietet eine Schnittstelle zur Eventbuchungs-Plattform Regiondo, welche Daten zwischen Regiondo und falcana abgleicht. Der Abgleich wird ausschließlich von Regiondo zu falcana durchgeführt. Eine Aktualisierung der Daten in Regiondo bei Änderungen in falcana ist nicht vorgesehen.
Webhooks
In Regiondo können Webhooks hinterlegt werden, welche beim Anlegen oder Ändern von Daten diese automatisch an falcana übertragen:
Kunden: Wenn sich Daten eines Kunden ändern, werden diese an falcana übertragen und hier ebenfalls aktualisiert.
Buchungen: Kauft ein Kunde ein Ticket in Regiondo, so wird diese Buchung an falcana übertragen und dem entsprechenden Event zugeordnet. Existiert das Event in falcana noch nicht, so wird dieses bei der ersten Buchung angelegt. Ansonsten werden Events durch das Abfragen der Angebote aus Regiondo angelegt.
Abgleich der Daten
Es gibt zwei Wege, wie die Daten von Regiondo zu falcana abgeglichen werden:
Automatischer Abgleich
Es werden 1x täglich (nachts) alle in Regiondo angelegten Angebote abgefragt und als Events in falcana angelegt, beziehungsweise aktualisiert.
- Angebote, die in Regiondo bestehen, aber in falcana noch nicht als Event angelegt wurden, werden in falcana angelegt.
- Angebote, welche durch die Schnittstelle bereits früher in falcana als Event angelegt wurden, werden gegebenenfalls aktualisiert. Durch falcana kann konfiguriert werden, ob beim Abgleich alle Angebote in falcana übernommen werden oder nur jene, wo bereits Ticket-Buchungen vorhanden sind.
Manueller Abgleich
Bei aktivierter Regiondo-Schnittstelle befindet sich unter „Meine Startseite“ ein Button „Regiondo Angebote abfragen“. Dieser führt sofort den Datenabgleich zwischen Regiondo und falcana aus.
Ist bei der Einrichtung gewünscht, dass nur Angebote mit einem bestimmten Status abgeglichen werden, so ist die Funktionalität für den manuellen und automatischen Abgleich deaktiviert. Die Events werden hierbei ausschließlich über die definierten Webhooks bei der Erstellung oder Änderung eines Angebotes in Regiondo erstellt.
Logik der Datenanlage
Events sind in Regiondo als Angebote angelegt. Dabei ist es möglich, zu einem Angebot in Regiondo mehrere unterschiedliche Termine anzugeben, an denen das Event angeboten wird.
Wichtig: falcana erstellt pro Termin des Angebots ein separates Event.
Die Schnittstelle kann angepasst werden, sodass z.B. pro Kunde ein eigenes Event angelegt wird. Für Details dazu wenden Sie sich bitte an das falcana-Team.
In falcana ist bei Event-Individualfeld anzulegen, in welchem automatisch die zugehörige Regiondo-ID eingetragen wird. Das Individualfeld ist durch falcana bei der Schnittstellen-Einrichtung anzulegen, da im Hintergrund ein Parameter gesetzt wird, welcher das Feld eindeutig identifiziert:
Übertragene Daten
Im folgenden Wird beschrieben, welche Daten von Regiondo in falcana übernommen werden.
Adressen
Wird ein Ticket-Kauf von Regiondo übermittelt, so werden folgende Regiondo-Kundendaten in falcana als Adresse angelegt beziehungsweise aktualisiert:
| Bezeichnung falcana | Bezeichnung Regiondo | Details |
| Vertriebsgruppe | – | Die Vertriebsgruppe wird für Regiondo fix gesetzt und wird beim Einrichten der Schnittstelle fixiert. |
| Name 1 | Last name (lastname) | Nachname |
| Name 2 | First name (firstname) | Vorname |
| Main Email (email) | E-Mail-Adresse | |
| Tel. | Phone Number (telephone) | Telefonnummer |
Wird ein Ticket über Regiondo von einem Kunden gekauft, welche bereits in falcana angelegt ist, so wird in falcana kein neuer Kontakt angelegt. Es wird hierbei geprüft, ob Vorname, Nachname und E-Mail-Adresse ident sind.
Events
Wird ein Angebot aus Regiondo in falcana als Event durch den Datenabgleich übernommen, so werden folgende Daten in falcana gesetzt:
| Bezeichnung falcana | Bezeichnung Regiondo | Details |
| Eventname | Title of the offer (name) | – |
| Start-Datum | Booking Date (date_start) | Ausgewähltes Datum des Regiondo-Kalenders. |
| Beschreibung | Short Description (short_description) | Kurzbeschreibung der Buchung. |
| Veranstaltungsort | Street address (zipcode, location_address) | In dieses Feld wird die Postleitzahl und Adresse eingetragen, der Veranstaltungsort ist eine individuell Angabe. |
| Regiondo-ID | – | Ist in falcana das Event-Individualfeld mit dem hinterlegten Parameter. Dies ist ein Spezialfeld und wird bei der Einrichtung der Regiondo-Schnittstelle von falcana erstellt. Diese ID verknüpft das Event in falcana mit der Buchung in Regiondo. |
Event-Teilnehmer
Wird ein Ticket-Kauf aus Regiondo in falcana als Event-Teilnehmer übernommen, so werden folgende Daten in falcana gesetzt:
| Bezeichnung falcana | Bezeichnung Regiondo | Details |
| gebucht am | Booking date (created_at) | Datum an dem das Event gebucht wurde. |
| Anzahl gekaufter Tickets | Quantity (qty) | |
| Gesamtbetrag | Total (total) | Gesamtbetrag der Buchung. |
| Regiondo-Bestellnummer | Booking number (order_number) | |
| Anzahl der stornierten Tickets | Cancelled Quantity (qty_cancelled) | Nur intern, wird nicht angezeigt. |
| Zahlungsstatus | Payment status (payment_status) | Nur intern, wird nicht angezeigt. |
| Ticket Codes | Ticket codes (ticket_codes) | Nur intern, wird nicht angezeigt. |
Rechnung in falcana erstellen
In falcana kann auf Wunsch zu den gebuchten Tickets eine zugehörige Rechnung erstellt werden. Dies ist bei der Einrichtung der Schnittstelle festzulegen. Hierfür wird bei der Schnittstellen-Einrichtung durch falcana ein spezielles Individualfeld für die Ticket-ID angelegt:
Wird ein Ticket von Regiondo übermittelt, so wird daraus eine Rechnung generiert. Hierfür ist es notwendig, einen eigenen Mandanten (= eigener Rechnungsnummernkreis) einzurichten. Der Mandant in falcana muss gleichlautend wie jener in Regiondo („Distribution Channel Partner“) benannt werden. Die erzeugte Auftragsmappe für die Rechnung wird zum betroffenen Event verknüpft.
Wichtig: Es handelt sich hier um Rechnungsduplikate, die ausschließlich für eine interne Verwendung in falcana angelegt werden (zum Beispiel um Auswertungen und Berichte zu ermöglichen).
Einrichten der Verbindung
Für die Verbindung müssen Public Key und Private Key in Regiondo erstellt und vom Regiondo Support für die Live-Version freigeschaltet werden.
Die Keys werden anschließend in falcana verschlüsselt hinterlegt, um die Kommunikation zwischen den Systemen zu ermöglichen.
Restriktionen
- Es ist durch Regiondo nicht möglich, die Rechnungsnummer in falcana zu übernehmen. Hierbei wird von falcana automatisch eine Rechnungsnummer vergeben.
- Das Feld „Unternehmen“ bei der Anschrift aus Regiondo kann nicht über die Schnittstelle übertragen werden.