TSE-forbindelsesfejl

Fiskalisering i Tyskland kræver brug af en »certificeret teknisk sikkerhedsenhed« (TSE eller TSS i den engelske version af forordningen). Hvis der anvendes hardware TSE'er, kan fejlmeddelelsen »Tse connection error.« blive returneret efter createDocument.

Mulige scenarier:

TSE er ikke tilsluttet

TSE er ikke tilsluttet kasseapparatet (til det system, hvor RetailForce Middleware er installeret).

Fejlfinding:

Tilslut TSE'en til systemet.

TSE er tilsluttet – testen viser "OK

Fejlen vises, men TSE er tilsluttet systemet, også en selvtest

• POST /api/v1/management/germany/TSE/{TseSerial}/selftest returnerer
• "200 - Succes",

ligesom en forbindelsestest:

• PUT /api/v1/management/germany/{clientId}/TSE/connectTest,
• "200 - Succes".

Mulig årsag:

Grænsen for åbne transaktioner er nået! I henhold til et TSE-krav fra BSI (det tyske forbundskontor for informationssikkerhed) skal TSE'er begrænse antallet af transaktioner, der kan være åbne på samme tid.

• Swissbit hardware TSE kan håndtere maksimalt 512,
• Fiskaly Cloud TSE 2.000 åbne transaktioner.

Dette er transaktioner, der blev startet med createDocument, men som ikke senere blev afsluttet korrekt (med storeDocument eller cancelDocument). Dette kan f.eks. ske, hvis POS-systemet går ned efter et createDocument og ikke har "husket", at der stadig er åbne transaktioner.

Antallet af åbne transaktioner kan aflæses via følgende endpoint:

• GET /api/v1/management/germany/TSE

Åbne transaktioner vises i svaret i feltet »startedTransactions«:

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

Fejlfinding:

For at afhjælpe fejlen eller for at gøre det muligt for TSE at acceptere dokumenter ("kvitteringer") til behandling igen, skal de åbne transaktioner lukkes.

Gør følgende for at gøre dette.

Mulighed 1:

Brug

• GET /api/v1/management/germany/{clientId}/TSE/listTransactions ,

returneres fiscalDocumentNumbers for åbne transaktioner i pakker.

Eksempel:

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

De transaktioner, der hentes via listTransactions (=fiscalDocumentNumber), skal nu, i overensstemmelse med den faktiske situation, lukkes enten med:

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

Brug POST /api/v1/transactions/storeDocument (som sædvanlig) til at færdiggøre dokumentet, når et salg er gennemført, og POST /api/v1/transactions/cancelDocument til at annullere transaktionen (uden et vellykket salg).

Mulighed 2:

Kommandoen

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

kan bruges til at afslutte alle åbne TSE-transaktioner på én gang. Sørg for at følge ovenstående instruktioner vedrørende annullering af dokumenter, inden du bruger dette endpoint! Når alle åbne transaktioner er afsluttet, vil TSE'en igen acceptere og behandle dokumenter.

Denne artikel er oversat automatisk.