Testen der CheckIn App Funktionen
Hier ist eine Anleitung, wie du die festiware Checkin App testest.
Android App: https://play.google.com/store/apps/details?id=app.festiware.checkin
iOS App: https://apps.apple.com/de/app/festiware-checkin/id6443859629
Du willst ins Beta-Test Programm? Schreibe eine Mail an support@festiware.eu
Die CheckIn App kennt mehrere Modi, die du am unteren Rand wechselst: Check-in, Gutscheine, Catering und den Materialscan. Welche davon erscheinen, hängt an den Berechtigungen des angemeldeten App-Benutzers, siehe unten. Wie sich Gutscheine und Mahlzeiten unterscheiden und wann du was brauchst, steht in Essensbestellungen in festiware: Alle Möglichkeiten im Überblick.
Grundvoraussetzungen zum Test aller Funktionen
- Es existiert ein User für die CheckIn App
- Es existiert mindestens eine Ticketart im System
- Es existieren Gutscheinarten in eurem System
- Es existieren Mahlzeiten in eurem System
Zum Testen der Materialscan Funktion sollte Inventar existieren.
Achtung: Der App-Benutzer entscheidet, was die App überhaupt anzeigt. Die Modi am unteren Rand der App richten sich nach seinen Berechtigungen. Fehlt eine, fehlt der zugehörige Modus.
So legst du einen an: Benutzer öffnen, oben auf Aktionen, dann API-Benutzer erstellen. Dort wählst du die Berechtigungen aus. Für einen vollständigen Test nimmst du alle.
Diese Berechtigungen schalten die Modi frei:
- Check In und Quick Check In für den Check-in-Modus
- Catering für den Catering-Modus, also gebuchte Mahlzeiten
- Food Vouchers für den Gutschein-Modus
- Supply Overview, Supply Tracking und Supply Administration für den Materialscan
- dazu Teams Overview und Time Tracking
Bestehende Zugänge findest du unter Benutzer in der Ansicht App-User (Legacy API). Die Liste API Users zeigt dagegen die Zugänge für Automatisierungen und Schnittstellen, nicht die für die App.
Ausführlich erklärt ist das auch in diesen Webinaren:
Für eine Erklärung zu Catering und Gutscheinen schau dir folgendes Webinar an:
1. Vorbereitung
Person auswählen: Erstelle oder suche eine Person in deinem festiware System. Z.B. ein Teammitglied. Lege im Zweifel eine neue Person an.
Journey Check:
Die Person darf im Tab Journey weder einen Ticketcode noch einen NFC Tag haben.
Erstelle im Zweifel eine neue Person in deinem System.
2. Ticket und Gutscheine
Ticket Code erstellen:
Klick bei der Person die Aktion „Ticket Code erstellen“ und erstelle ein Ticket für die Person.
Im Journey sollte nun ein QR-Code unter Ticket Codes angezeigt werden.
Gültig von und Gültig bis der Ticketart müssen also den Zeitpunkt des Tests beinhalten. Diese Felder können alternativ auch einfach leer sein.
Essen bestellen:
Klick auf „Essen bestellen“ und bestell eine Mahlzeit für die Person, welche du zum Zeitpunkt des Tests einlösen kannst.
Ausgabe Von und Ausgabe Bis müssen also den Zeitpunkt des Tests beinhalten.
Gutscheine ausstellen:
Klick auf „Gutscheine ausstellen“ und stellt eine beliebige Handvoll Gutscheine aus.
3. NFC Check-In mit Chip
Vorbereitung NFC:
Schnapp dir ein altes Festivalbändchen mit Chip oder einen anderen NFC Tag als Aufkleber oder Chipkarte.
Achtung: Es kann sein, dass nicht alle Chiptypen auf allen Geräten oder Plattformen erkannt werden. Im Zweifel nutze MiFare Ultralight oder andere Chips oder teste mit einer anderen NFC-Leser App falls der Chip nicht auf Anhieb funktioniert.
Stellt sicher, dass du festiware CheckIn Version 2.7.5 oder höher installiert hast. Die Version siehst du im App Store
Aktiviere NFC auf deinem Handy. (Nur Android)
Logg dich mit dem Login Code in der App ein.
Wo du den Login-Code findest: Öffne den App-Benutzer unter Benutzer → App-User (Legacy API) und führe dort die Aktion QR-Code zum Login anzeigen aus. Den angezeigten Code scannst du beim ersten Start mit der App.
Fragt die App danach noch nach einem Passwort, wurde der Code ohne die Option Passwort zurücksetzen erzeugt. Dann steckt kein Passwort im Code. Erzeuge ihn in diesem Fall neu, diesmal mit aktivierter Option, und scanne den neuen Code. Achtung: Der alte Code wird dadurch ungültig. Sind weitere Geräte mit demselben Benutzer angemeldet, müssen sie den neuen Code ebenfalls scannen.
Ticket Scan:
Hier beschreiben wir den Weg, wie ein Chip beim CheckIn in der App aktiviert werden kann.
Nötige Systemeinstellungen: Unter Einstellungen → Systemeinstellungen muss der Check-in aktiviert sein. Damit Chips oder QR-Codes beim Check-in vergeben werden können, aktivierst du dort zusätzlich Check-in über App mit NFC-Tag. Die Option, nur bereits im System registrierte Tags zu akzeptieren, ist ein Sonderfall und bleibt im Normalbetrieb aus.
Außerdem brauchst du ein Endgerät, welches die NFC-Funktion aktiviert hat.
iPhone 11 oder höher, bzw. bei Android bitte individuell checken.

Geh auf den Menüpunkt „Ticket scannen“ und scanne den QR-Code der oben erstellten Person direkt vom Computerbildschirm.
Aktiviere danach den NFC Chip, indem du ihn an dein Handy hältst.
Löse das Ticket per Tap ein – das Ticket sollte kurz darauf als eingelöst markiert sein.
Prüfe in festiware, ob der NFC Tag registriert wurde.

4. Gutscheine und Catering Modus
Gutscheine:
Klicke auf „Gutscheine“.
Scanne den Vendor Tag mit dem gerade verbundenen Chip.
Mit dem Vendor Tag registriert sich die Person, die den Gutschein entgegennimmt. Z.B. der Händler oder die Bar-Chefin.
Nutze den „Neu starten“-Button, falls der Scanner gerade nicht scannt.
Wie du mit QR-Codes arbeitest erfährst du weiter unten.
Es sollten die zuvor ausgegebenen Gutscheine angezeigt werden – löse einen oder mehrere davon ein.
Catering:
Wechsle in den Catering Modus.
Scanne den NFC-Tag und löse das Essen ein.
Sollte kein Essen mehr erhältlich sein oder kein derzeit ausgegebenes und von der gescannten Person gebuchtes Essen existieren zeigt die App nichts an.
5. Alternative: QR-Tag Check-In
QR Code generieren:
Erzeuge einen QR Code z. B. über goqr.me (Beliebige Kombination, z.B. „MEINTESTQR123“).
In festiware:
Wähle bei der Person die Aktion „Person einchecken“.
Trage die QR-Code-Kombination in das Feld „NFC Tag“ ein. Du kannst auch einen USB-QR-Code Scanner dafür an deinen Computer anschließen.

Vergebe Essens- und Getränkemarken, falls noch nicht erfolgt.
In der App:
Stelle sicher, dass Version 2.7.5 oder höher installiert ist.
Ticket Scan: Entweder den Ticket Scan überspringen oder durchführen; im Ticket Scan dann den NFC Scan-Schritt auslassen.
Gutschein und Catering testen:
Wechsle nacheinander in „Gutscheine“ und „Catering“.
Führe die gleichen Aktionen wie oben durch, diesmal mit dem Button „QR-Code scannen“.
Das war’s! Viel Erfolg beim Testen.