Einrichtung
Auf dieser Seite wird erläutert, wie Sie die Sport & Event | Tixx Connect Schnittstelle einfach und schnell einrichten.
Tixx Einrichtung
Die wichtigsten Einrichtungsparameter für die Schnittstelle finden Sie direkt im Rollencenter unter "Einrichtung" -> "Tixx Einrichtung".
Inforegister der Ticketing Einrichtung
Alle relevanten Einstellungen sind übersichtlich in mehreren Registern gruppiert.
Tip
Für jedes einzelne Feld stehen Ihnen sogenannte Tooltips zur Verfügung, d.h. Sie können direkt den Mauszeiger auf ein Feld stellen, damit Ihnen das System weiterführende Informationen dazu anzeigt.
1. Register Allgemein
Geben Sie hier die Basis URL sowie die zu verwendende Version der Tixx APIs an. Diese Daten werden verwendet, um sich bei Tixx authentifizieren und mit den APIs kommunizieren zu können. Des Weiteren lässt sich an dieser Stelle die Schnittstelle aktivieren und deaktivieren.
2. Register Lizenzierung
Hier finden Sie Informationen zu Ihrer Lizenz.
3. Register Authentifizierung
Hier müssen ihre persönlichen Tixx-Backoffice Zugangsdaten eingegeben werden, damit Sie sich bei Tixx authentifizieren und die gewünschten Tixx Dienste abonnieren können. Die Daten hierfür erhalten Sie von ihrem Tixx Ansprechpartner.
4. Register Benachrichtigung
Angabe der für die Kommunikation notwendigen APIs von Tixx. Diese Daten werden bei der Einrichtung in der Regel automatisch erstellt und müssen in der Regel nicht abgeändert werden.
5. Register Import von Tixx
Hier finden Sie die zentralen Einrichtungen zur Steuerung der Verarbeitung der importierten Daten. Sie können beispielsweise steuern, mit welchen Nummernserien Daten in BC angelegt werden sollen, ob Daten automatisch verarbeitet werden, usw. Weitere Informationen finden Sie bei jedem Feld über den hinerlegten Tooltipp.
Registrierung
Neben den oben beschriebenen Einrichtungsparametern ist die Registrierung und Aktivierung der Tixx Dienste das zentrale Einrichtungselement der Schnittstelle. Den Aufruf der Dienstregistrierungsmaske finden Sie im Aktionsmenü der Schnittstelleneinrichtung unter "Registrierungen" -> "Abonnierte Dienste".
Hier kann definiert werden welche Daten von Tixx protokolliert (und später abgerufen) werden sollen.
| Dienst | Beschreibung |
|---|---|
| CUSTOMERGROUP | Kundengruppen |
| CUSTOMER_ADRESS | Kundenadressdaten |
| CUSTOMER_COMMUNICATION | Kundenkommunikation |
| CUSTOMER | Kundendaten |
| CUSTOMER_FINANCIAL_DATA_IBAN_ACCOUNT | Bankkonten |
| CUSTOMER_FINANCIAL_DATA_IBAN_ACCOUNT_SEPA_MANDATE | SEPA Mandate |
| CUSTOMER_GROUPREFERENCE | Referenz auf die Kundengruppe |
| ORDER_TICKET | Tickets innerhalb eines Auftrags |
| ORDER | Kundenaufträge |
Mit Ausnahme der Dienste "ORDER_TICKET" und "ORDER" kann jeweils gewählt werden, ob nur neue oder aktualisierte Datensätze protokolliert werden sollen, oder auch gelöschte Datensätze protokolliert werden müssen.
"CUSTOMERGROUP" und "CUSTOMER_GROUPREFERENCE" werden noch nicht unterstützt. Diese Funktionalität wird gegebenenfalls in zukünftigen Versionen nachgeliefert, sofern hierzu Bedarf signalisiert wird.
Tip
Über den Button "Tixx Dienste einfügen" lassen sich alle Dienste initial befüllen. Im Anschluss daran kann gewählt werden, welche Dienste aktiviert werden sollen. Hierbei werden die Felder "Ereignisart" und "API Version" bereits automatisch vorbelegt.
Damit die Schnittstelle grundsätzlich funktionsfähig ist, müssen die Felder "Ereignisart", "API Version" und "URL für Benachrichtigung" mit den richtigen Parametern eingerichtet werden. Im Feld "URL für Benachrichtigung" geben Sie eine HTML Adresse an, an die Tixx Benachrichtigungen verschicken kann. Hier tragen Sie bitte Ihre Azure Ressourcenadresse ein, die Sie von uns erhalten, wenn Sie dieses Produkt inkl. der Azure Ressourcen verwenden.
Sind alle Daten eingetragen, können Sie den jeweiligen Dienst über den Aktionsmenüaufruf "Dienst bei Tixx registrieren" abonnieren. Bei erfolgreicher Kommunikation wird das Feld "Ereignis UUID" automatisch von Tixx gefüllt und die Dienste werden als aktiviert und registriert angezeigt.
Tip
Beispieleinrichtung:
Tixx Veranstaltung Mapping
In der Maske Tixx Veranstaltungen Mapping kann jeder Tixx Veranstaltung ein passender Business Central Dimensionswert zugeordnet werden. Für jede Veranstaltung kann 0 oder 1 Dimensionswert zugeordnet werden.
Der hier zugeordnete Dimensionswert wird dann bei der Erstellung der Rechnungs- oder Gutschriftspositionen berücksichtigt.
Tip
Sie können die Schnittstelle so einrichten, dass der Veranstaltungsdimensionswert zugeordnet sein muss, bevor in Business Central finanzbuchhalterische Belege erstellt und gebucht werden dürfen. Auf diese Weise können Sie vermeiden, dass Ihnen später in Ihrer ggf. stattfindenden Dimensionsauswertung wichtige Daten fehlen.
Tixx Filialen Einrichtung
In Tixx geführte Filialen können in Business Central weitere Vorgabeparameter für die Belegerstellung erhalten; diese Parameter werden dann beim Erstellen der Belege der jeweiligen Filiale berücksichtigt. So lässt sich pro Filiale z.B. einstellen, welcher Rechnungsdebitor verwendet werden soll, welche Zahlungsform verwendet wird, usw.
Über Zuständigkeitseinheiten können noch weitere Dimensionen (neben dem Event Mapping) als Vorgabedimensionen hinterlegt werden.