Clubfridge und Vereinsflieger

Vereinsflieger und Clubfridge: Tipps zur Datenintegration

Luftsportvereine, die Vereinsflieger benutzen, können Mitglieds- und Abrechnungsdaten direkt zwischen Clubfridge und Vereinsflieger austauschen. Damit das gut funktioniert, müsst Ihr ein paar Punkte beachten:

Clubfridge und Vereinsflieger konfigurieren

Zunächst müsst Ihr die Verbindung zwischen Clubfridge und Vereinsflieger herstellen. Das geht in Clubfridge im Menüpunkt „Vereinsdaten“. Das sieht dann so aus:

Clubfridge - Vereinsflieger Integration

Ihr gebt dort Benutzername und Passwort auf der Vereinsflieger-Seite ein, Eure Club-ID (in Vereinsflieger: „Administration > Verein“) und Euern AppKey (in Vereinsflieger: „Administration > Verein > Einstellungen > REST Interface“). Wenn Ihr keinen AppKey eingebt, gilt noch (und nur bis Ende 2026) der generische AppKey für Clubfridge. Vereinsflieger stellt das aber um auf Vereins-spezifische Keys. Eine Mitgliedschaft in einer speziellen Vereinsfliegergruppe für Admins ist nicht mehr erforderlich.

Clubfridge speichert diese sensiblen Daten verschlüsselt. Nur wenn der Clubfridge-Server selbst kompromittiert würde, wären diese Daten für einen Angreifer sichtbar.

Im Feld RFID-Schlüsselnummer könnt Ihr auswählen, ob Clubfridge von alleine erkennen soll, in welchem Schlüsselfeld von Vereinsflieger Ihr die RFID-Codes ablegt. Oder Ihr sagt es Clubfridge direkt, in welchem der Vereinsflieger Schlüsselfelder Ihr Eure RFID Keys aufbewahrt. Standardmäßig kann Clubfridge drei Schlüsselfelder unterscheiden. Leider scheint es keinen Weg zu geben, die Schlüsseldefinition eines Vereins aus Vereinsflieger abzufragen. Solltet Ihr mehr als die drei unterstützten Schllüsselfelder verwenden, versucht die RFID Keys in einem der ersten drei unterzubringen.

Best Practise legt für die Synchronisation mit Clubfridge in Vereinsflieger einen extra User an, der nur die Mitglieds- und Artikeldaten lesen (bei Artikeln auch schreiben) darf. Nutzt diesen Benutzer für die Verbindung der beiden Systeme! Verwendet Eure persönlichen Zugangsdaten bestenfalls mal zum Testen.

Mitgliederdaten synchronisieren

Wenn Ihr die Anbindung eingerichtet habt, könnt Ihr in der Mitgliederliste oben rechts auf den „Vereinsflieger“ Button klicken. Clubfridge baut dann mit Euern Zugangsdaten eine Verbindung zu Vereinsflieger auf und lädt / aktualisiert alle aktiven Mitglieder, die einen RFID Schlüssel haben (Mitglieder ohne einen solchen Schlüssel überspringt Clubfridge).

Wo sind denn die Passwörter? Aus naheliegenden Sicherheitsgründen kann man die Passwörter von Mitgliedern natürlich nicht von Vereinsflieger laden. D.h. nach einer Synchronisation stehen zwar die Namen, RFID Codes etc. von Mitgliedern zur Verfügung – aber eben keine Vereinsflieger-Passwörter.

Aber wie sollen die Mitglieder sich denn nun einloggen bei clubfridge (z.B. für den digitalen Bierdeckel oder einen Blick auf ihren Verbrauch)? Ganz einfach: über den Magic Link im Login-Fenster! Mail-Adresse eingeben und in die Mailbox schauen.

Abrechnungen Synchronisieren

Clubfridge kann Eure Abrechnungen direkt als Artikelverkäufe an Vereinsflieger schicken. Dazu muss Clubfridge wissen, welcher Artikel verwendet werden muss. Clubfridge bekommt das heraus, indem es in der Vereinsflieger Artikelliste (in Vereinsflieger: Administration > Artikel) einen Artikel sucht, der „Clubfridge“ im Namen hat (z.B. „Clubfridge Getränke“). Der erste so gefundene Artikel ist der Artikel, auf den Clubfridge sämtliche Abrechnungen leitet.

Wenn Ihr in Clubfridge eine Abrechnung erstellt habt (z.B. für den letzten Monat), könnt Ihr im Menüpunkt „Abrechnung“ diese Abrechnung über den „VF“ Button an Vereinsflieger senden. Pro Mitglied schickt Clubfridge dann eine Buchung (mit dem oben gefundenen Vereinsflieger Artikel) und der entsprechenden Abrechnungs-Summe (d.h. der Artikelpreis, den Ihr in Vereinsflieger hinterlegt habt, spielt gar keine Rolle, denn er wird überschrieben durch die tatsächliche Abrechnungssumme).