TSE-anslutningsfel

Fiskalisering i Tyskland kräver användning av en ”certifierad teknisk säkerhetsenhet” (TSE eller TSS i den engelska versionen av förordningen). Om hardware TSE:er används kan felmeddelandet ”Tse connection error.” visas efter createDocument.

Möjliga scenarier:

TSE är inte ansluten

TSE är inte ansluten till kassan (till det system där RetailForce Middleware är installerat).

Felsökning:

Anslut TSE till systemet.

TSE ansluten – testet visar ”OK”

Felet returneras, men TSE är ansluten till systemet, även ett självtest

• POST /api/v1/management/germany/TSE/{TseSerial}/selftest returnerar
• "200 – Framgång",

liksom ett anslutningstest:

• PUT /api/v1/management/germany/{clientId}/TSE/connectTest,
• "200 – Framgång".

Möjlig orsak:

Gränsen för öppna transaktioner har nåtts! Enligt ett TSE-krav från BSI (det tyska federala kontoret för informationssäkerhet) måste TSE:er begränsa antalet transaktioner som kan vara öppna samtidigt.

• Swissbit hardware TSE kan hantera maximalt 512,
• Fiskaly Cloud TSE 2 000 öppna transaktioner.

Detta är transaktioner som startades med createDocument men som inte slutfördes korrekt senare (med storeDocument eller cancelDocument). Detta kan till exempel inträffa om kassasystemet kraschar efter ett createDocument och inte har ”kommit ihåg” att det fortfarande finns öppna transaktioner.

Antalet öppna transaktioner kan läsas ut med följande endpoint:

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

Öppna transaktioner visas i svaret i fältet ”startedTransactions”:

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

Felsökning:

För att åtgärda felet eller för att TSE återigen ska kunna ta emot dokument (”kvitton”) för bearbetning måste de öppna transaktionerna stängas.

Gör så här:

Alternativ 1:

Använd

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

returneras fiscalDocumentNumbers för öppna transaktioner i paket.

Exempel:

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

De transaktioner som hämtas via listTransactions (=fiscalDocumentNumber) måste nu, i enlighet med den faktiska situationen, avslutas antingen med:

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

Använd POST /api/v1/transactions/storeDocument (som vanligt) för att slutföra dokumentet när en försäljning har genomförts och POST /api/v1/transactions/cancelDocument för att avbryta transaktionen (utan att försäljningen har genomförts).

Alternativ 2:

Kommandot

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

kan användas för att avsluta alla öppna TSE-transaktioner på en gång. Se till att följa anvisningarna ovan om annullering av dokument innan du använder denna endpunkt! Efter att alla öppna transaktioner har avslutats kommer TSE:n återigen att ta emot och bearbeta dokument.

Den här artikeln har översatts automatiskt.