Betrieb

Wie das Plugin arbeitet

Das Plugin fragt das Ablaufdatum des Zertifikats direkt bei der TSE ab (über die TSE-Anbindung von Customer Checkout) und speichert es zwischen. Die erste Abfrage läuft etwa 90 Sekunden nach dem Kassenstart, danach im konfigurierten Intervall (Standard: alle 6 Stunden). Anmeldebildschirm und Anmelde-Dialog lesen nur diesen Zwischenspeicher — die Anmeldung wird nie durch eine TSE-Abfrage verzögert.

Ist die TSE vorübergehend nicht erreichbar, behält das Plugin das zuletzt bekannte Ablaufdatum und vermerkt den Fehler im Log. Es sendet keine Daten nach außen; alles läuft lokal auf der Kasse.

Updates

Neue Versionen erscheinen im Kundenportal (portal.stefanbaust.de), zusammen mit den Versionshinweisen auf der Produktseite. Ein Update ist ein Jar-Tausch: neue Version herunterladen, Jar in POSPlugins/AP/ ersetzen, Kasse neu starten.

Lizenz

Der Portal-Download bettet Ihre Lizenz direkt in das Jar ein — im Normalfall müssen Sie sich um die Lizenz nie kümmern.

Findet das Plugin keine gültige Lizenz, deaktiviert es sich deutlich sichtbar: Es schreibt einen unübersehbaren Fehler ins Log und zeigt auf dem Anmeldebildschirm den Hinweis „TSE-Ablauf-Warnung: keine gültige Lizenz — Warnungen deaktiviert (Portal-Download)“. Die Kasse selbst läuft davon unberührt weiter, nur die TSE-Warnungen fehlen dann.

Abhilfe: das Plugin frisch aus dem Portal herunterladen (der Download enthält die Lizenz) — oder eine vom Support bereitgestellte Lizenz als Datei license-tse-expiry-warning-plugin.key neben das Jar in POSPlugins/AP/ legen. Als Dateiinhalt genügt die komplette LICENSE.txt aus dem Portal-Download. Eine solche Datei übersteuert die eingebettete Lizenz.

Logs

Alle Meldungen des Plugins tragen das Präfix [tse-expiry] und landen im Standard-Log der Kasse (cco_standard.log):

Logzeile	Bedeutung
started (refresh every N h)	Plugin gestartet, Abfrageintervall aktiv
TSE certificate expires <Datum>	Ablaufdatum (neu) von der TSE gelesen
login dialog shown (N days to expiry)	Warn-Dialog wurde angezeigt
could not read certificate expiry: …	TSE nicht erreichbar; letzter bekannter Wert bleibt
invalid value for <Property>	Ungültiger Konfigurationswert, Standardwert wird verwendet

Fehlersuche

Es erscheint keine Warnung, obwohl der Ablauf näher rückt. Prüfen Sie der Reihe nach:

1. Ist das deutsche Signaturprofil mit TSE auf dieser Kasse aktiv? Ohne aktive TSE bleibt das Plugin bewusst inaktiv.
2. Steht im Log eine TSE certificate expires-Zeile? Falls nicht, konnte das Plugin das Datum noch nicht lesen — direkt nach dem Kassenstart kann das bis zu zwei Minuten dauern.
3. Steht im Log ein Lizenzfehler bzw. auf dem Anmeldebildschirm der Hinweis „keine gültige Lizenz“? Dann siehe oben unter Lizenz.
4. Liegt das Ablaufdatum wirklich innerhalb des Schwellwerts? Der Dialog erscheint standardmäßig erst ab 14 Tagen, der Hinweis ab 30 Tagen (Konfiguration).

Die Warnung bleibt nach dem TSE-Tausch stehen. Das Plugin liest das Ablaufdatum im konfigurierten Intervall neu (Standard: alle 6 Stunden). Nach einem TSE-Tausch verschwindet die Warnung also spätestens nach diesem Intervall — oder sofort nach einem Neustart der Kasse.

Der Hinweis erscheint, aber kein Dialog. So ist es gedacht: Zwischen 30 und 14 Tagen vor Ablauf gibt es nur den Hinweis auf dem Anmeldebildschirm; der Dialog kommt ab 14 Tagen dazu.