Tse connection error

Die Fiskalisierung in Deutschland verlangt den Einsatz einer s.g. zertifizierten technischen Sicherheitseinrichtung (TSE). Wird eine Hardware TSE verwendet, kann es vorkommen, dass nach createDocument die Fehlermedlung "Tse connection error." zurückgegeben wird.

Mögliche Szenarien:

1. TSE nicht verbunden

TSE ist nicht mit der Kasse (mit dem System, auf welchem die RetailForce Middleware installiert ist) verbunden.

Behebung:

TSE mit System verbinden.

2. TSE verbunden - Test zeigt "OK"

Der Fehler wird zurückgegeben, die TSE ist jedoch mit dem System verbunden, auch ein Selbsttest:

• POST /api/v1/management/germany/tse/{tseSerial}/selftest liefert
• "200 - Success" zurück

ebenso wie ein Verbindungstest:

• PUT /api/v1/management/germany/{clientId}/tse/connectTest
• "200 - Success"

Mögliche Ursache:

Das Limit der offenen Transaktionen wurde erreicht! Aufgrund einer TSE Anforderung des BSI (Bundesamt für Sicherheit in der Informationstechnik) müssen TSEs die Anzahl der Transaktionen, welche gleichzeitig offen sein können, limitieren.

• Die swissbit Hardware TSE kann maximal 512,
• die fiskaly Cloud TSE 2.000 offene Transaktionen verwalten.

Es handelt sich hierbei um Transaktionen, welche mit createDocument gestartet aber später nicht korrekt abgeschlossen wurden (mit storeDocument oder cancelDocument). Dies kann beispielsweise auftreten, wenn das Kassensystem nach einem createDocument abstürzt und sich nicht "gemerkt" hat, dass noch offene Transaktionen existieren.

Die Anzahl offener Transaktionen kann mit dem folgenden Endpunkt ausgelesen werden:

• GET /api/v1/management/germany/tse

Offene Transaktionen werden in der Response im Feld "startedTransactions" angezeigt:

[
   {
      ...
      "startedTransactions": 512,
      "maxStartedTransactions": 512,
      "createdSignatures": 2238,
      "maxSignatures": 20000000,
      ...
   }
]

Behebung:

Zur Behebung des Fehlers, bzw. damit die TSE wieder Dokumente (Belege) zur Verarbeitung entgegennimmt, müssen die offenen Transaktionen geschlossen werden.

Gehen Sie dazu wie folgt vor.

Möglichkeit 1:

Mithilfe des Endpunkts:

• GET /api/v1/management/germany/{clientId}/tse/listTransactions

werden die fiscalDocumentNumbers von offene Transaktionen paketweise zurückgegeben.

Beispiel:

[
   45,
   1,
   2,
   3,
   4,
   5,
   6,
   7
]

Die über listTransactions abgerufenen Transaktionen (=fiscalDocumentNumber) müssen nun, der realen Situation entsprechend, entweder mit:

• POST /api/v1/transactions/storeDocument oder
• POST /api/v1/transactions/cancelDocument

abgeschlossen werden.

Verwenden Sie POST /api/v1/transactions/storeDocument (wie üblich) um den Beleg abzuschließen, wenn ein Verkauf erfolgt ist und POST /api/v1/transactions/cancelDocument, um die Transaktion (ohne erfolgreichen Verkauf) abzubrechen.

Möglichkeit 2:

Mithilfe des Endpunktes

• DELETE /api/v1/management/germany/{clientId}/tse/listTransactions

können sämtliche offene TSE-Transaktionen auf einmal geschlossen werden. Bitte beachten Sie unbedingt die obigen Hinweise hinsichtlich Belegabbrüche, bevor Sie diesen Endpunkt verwenden! Nach dem schließen aller offenen Transaktionen wird die TSE wieder Dokumente entgegennehmen und verarbeiten.