TSE-Stick, Location-Server und Kassenregistrierung einrichten.
Die TSE-Anbindung mit Location-Server verbindet die simplebis-cashbox mit einem lokalen Server am Standort. Der TSE-USB-Stick steckt physisch im Location-Server. Die Cashbox schreibt Belegstarts, Belegupdates und Belegabschlüsse über diesen Server auf den registrierten TSE-Stick.
Damit der Ablauf funktioniert, müssen drei Dinge zusammenpassen: Im Manager ist ein Standort mit Location-Server und Kassenprofil konfiguriert, der TSE-Stick ist in der Cashbox-App am Location-Server gemountet und eingerichtet, und jede Kasse, die TSE schreiben soll, ist einmalig als Client auf dem TSE-Stick registriert.
Die Einstellungen befinden sich im simplebis-manager im Menüpunkt Standorte. Dort den passenden Standort öffnen.
Allgemeine Einstellungen: Der Schalter TSE Deaktivierung für Kassen diesen Standorts erzwingen deaktiviert die TSE-Ausgabe für Kassen dieses Standorts, auch wenn Kassenprofile grundsätzlich TSE aktiv haben.Kasse > Kassenprofile verwalten: Im Kassenprofil wird der Server zugeordnet und mit Bon-Daten in TSE-Log schreiben festgelegt, ob Bons dieses Profils TSE-relevant geschrieben werden.Server: Hier werden Location-Server registriert, angezeigt und geöffnet. In den Serverdetails erscheinen Status, lokale IP, WLAN, TSE-Bereitschaft und die vom Heartbeat gemeldeten TSE-Informationen.Kasse: In den Kassendetails werden unter anderem TSE Client-ID und TSE Client-Serial angezeigt. Bei Hauptkassen werden zusätzlich TSE- und TCP-Server-Informationen dargestellt.Im Kassenprofil steht außerdem die Aktion Verfahrensdokumentation-PDF zur Verfügung. Diese PDF fasst die profilbezogene Kassen-, TSE- und Location-Server-Konfiguration zusammen.
Der QR-Code für die Einrichtung des Location-Servers wird im Manager über den Menüpunkt Standorte geöffnet. Dort den Standort auswählen, den Bereich Server öffnen und Server registrieren verwenden. Der Manager zeigt dann einen QR-Code und einen kurzen Installationscode an. Nach erfolgreicher Einrichtung wechselt die Anzeige auf Gerät eingerichtet; anschließend erscheint der Location-Server in der Serverliste des Standorts.
In der simplebis-cashbox App wird der Location-Server über Bluetooth gesucht. Die App sucht nach einem Location-Server in der Nähe, verbindet sich per BLE und prüft per Ping, ob das Gerät bereits eingerichtet ist. Ist noch kein Netzwerk verbunden, wird zuerst das WLAN ausgewählt und das WLAN-Passwort eingegeben. Danach wird der im Manager angezeigte QR-Code gescannt. Der QR-Code enthält den Registrierungs-Token für den Standort; nach dem Scan schreibt die Cashbox-App die Einrichtung auf den Location-Server und öffnet die Serververwaltung.
Der TSE-Stick wird in den Location-Server gesteckt und anschließend in der Cashbox-App über die Serververwaltung eingerichtet. In der Cashbox-App den verbundenen Location-Server öffnen und TSE verwalten auswählen.
Die Seite TSE USB-Sticks listet gefundene Swissbit-USB-Sticks. Ist ein Stick noch nicht gemountet, wird Stick mounten angezeigt. Nach dem Mounten führt TSE-Status prüfen zur Statusseite. Dort werden unter anderem Seriennummer, Zertifikatsende, Firmware-Typ, gestartete Transaktionen und der Initialisierungsstatus angezeigt.
Ist der Stick noch nicht initialisiert, zeigt die Statusseite, dass die TSE zuerst eingerichtet werden muss. Die Aktion Einrichten führt die Vorbereitung aus, richtet den TSE-Stick mit den Server-Defaultwerten ein, setzt die TSE-Zeit und speichert die TSE-Konfiguration am Location-Server. Danach sollte ein Selbsttest ausgeführt werden. Für Selbsttest, Client-Liste und offene Transaktionen fragt die Cashbox-App die TSE-Admin-PIN ab.
Der Stick sollte im laufenden Betrieb im Location-Server stecken bleiben. Vor dem Entfernen ist in der Cashbox-App die Aktion Auswerfen zu verwenden, damit der Stick sauber ausgehängt wird.
Die TSE-Schreibung wird im Manager im Kassenprofil gesteuert. Dazu im Menüpunkt Standorte den Standort öffnen, Kasse > Kassenprofile verwalten wählen und das Profil bearbeiten. Der Schalter Bon-Daten in TSE-Log schreiben aktiviert oder deaktiviert die TSE-Schreibung für Bons dieses Profils. Zusätzlich sollte im Feld Server der passende Location-Server des Standorts ausgewählt sein.
Wenn die TSE für einen ganzen Standort vorübergehend deaktiviert werden muss, erfolgt das nicht im Kassenprofil, sondern im Standort selbst über Allgemeine Einstellungen und den Schalter TSE Deaktivierung für Kassen diesen Standorts erzwingen. Diese Standort-Einstellung verhindert, dass die Cashbox beim Initialisieren TSE-Clientdaten erhält.
Eine neue Kasse muss einmalig auf dem TSE-Stick registriert werden, bevor sie über den Location-Server TSE schreiben kann. Dieser Schritt läuft in der Cashbox-App über die Serververwaltung.
Ablauf in der Cashbox-App:
TSE verwalten wählen.TSE-Status prüfen öffnen.Clients / Kassen öffnen und die TSE-Admin-PIN eingeben.Kasse registrieren wählen und die gewünschte Kasse auswählen.TSE Client-ID sowie die TSE Client-Serial an der Kasse.Ist eine Client-ID bereits vergeben oder wurde die Zielkasse bereits registriert, bricht die Vorbereitung mit einer Fehlermeldung ab. Die Dispenser-Registrierung ist ein eigener Sonderfall und für die normale Kassenregistrierung nicht relevant.
Beim Start und beim Schreiben von Bons prüft die Cashbox, ob TSE-Clientdaten vorhanden sind. Sind TSE Client-ID und TSE Client-Serial gesetzt, wird zunächst die Erreichbarkeit des Location-Servers geprüft. Die Cashbox verwendet dafür die lokale Serveradresse und den lokalen API-Token aus der Kasseninitialisierung und fragt den TSE-Status des Location-Servers ab.
Wenn der Location-Server bereit ist, werden TSE-Start, TSE-Update und TSE-Finish über den lokalen Server geschrieben. Ist keine Verbindung zum Location-Server möglich, versucht die Cashbox je nach Gerät zusätzlich eine direkte TSE-Prüfung. Wenn keine TSE-Verbindung verfügbar ist, meldet die App, dass die TSE nicht erreichbar oder nicht bereit ist und der Vorgang kann nicht sauber fortgesetzt werden.
Im Manager werden TSE-relevante Informationen an zwei Stellen sichtbar:
Standorte > Standort öffnen > Server > Location-Server öffnen: Die Serverdetails zeigen die Heartbeat-Daten des Location-Servers. Dazu gehören TSE-Bereitschaft, Seriennummer, Zertifikatsende, Herstellerkennung, Formfaktor, Hardware- und Software-Version, Signaturzähler, registrierte Clients, offene Transaktionen, Speicher, Selbsttest, valide Zeit, CTSS-Status und Initialisierungsstatus.Standorte > Standort öffnen > Kasse > Kasse öffnen: Die Kassendetails zeigen Installationsstatus, lokale Gerätedaten, TSE Client-ID und TSE Client-Serial. Bei einer Hauptkasse werden zusätzlich die TSE-Konfiguration und TCP-Server-Informationen angezeigt.Für die Dokumentation der Kassenkonfiguration kann im Manager unter Standorte > Standort öffnen > Kasse > Kassenprofile verwalten > Kassenprofil bearbeiten die Verfahrensdokumentation-PDF exportiert werden. Diese PDF enthält die für das Kassenprofil relevante TSE- und Location-Server-Konfiguration.
Bei TSE-Problemen sollte zuerst geprüft werden, ob der Location-Server im Manager online ist und aktuelle Heartbeat-Daten sendet. Danach in der Cashbox-App am Location-Server den TSE-Status öffnen, den Stickstatus prüfen und bei Bedarf einen Selbsttest ausführen.
Typische Ursachen sind ein nicht gemounteter USB-Stick, ein nicht initialisierter TSE-Stick, eine falsche oder fehlende Admin-PIN beim Registrieren, ein fehlender Location-Server im Kassenprofil, eine nicht registrierte Kasse oder die aktivierte Standort-Einstellung zur erzwungenen TSE-Deaktivierung.
Die Einrichtung sollte in dieser Reihenfolge erfolgen: Standort und Kassenprofil im Manager vorbereiten, Location-Server im Bereich Server registrieren, TSE-Stick in der Cashbox-App mounten und einrichten, Selbsttest ausführen, Kassen als Clients registrieren und anschließend einen Testbon mit TSE-Schreibung erstellen.
Die Seriennummer des TSE-Sticks, die registrierten Clients und der Status im Manager sollten nach der Einrichtung dokumentiert werden. Nach Änderungen am Kassenprofil oder am Location-Server empfiehlt sich ein erneuter Start der Cashbox-App, damit die aktuelle Initialisierung geladen wird.