Chyba připojení k TSE

Fiskalizace v Německu vyžaduje použití „certifikovaného technického bezpečnostního zařízení“ (TSE nebo TSS v anglické verzi nařízení). Pokud se používají hardwarová zařízení TSE, může se po volání createDocument zobrazit chybová zpráva „Tse connection error.“.

Možné scénáře:

TSE není připojeno

TSE není připojeno k pokladně (k systému, na kterém je nainstalován RetailForce Middleware).

Řešení problému:

Připojte TSE k systému.

TSE je připojeno – test ukazuje „OK“

Chyba se zobrazuje, ale TSE je připojeno k systému, proveden byl také autotest

• POST /api/v1/management/germany/tse/{tseSerial}/selftest vrací
• „200 – Úspěšné“,

stejně jako test připojení:

• PUT /api/v1/management/germany/{clientId}/tse/connectTest,
• „200 – Úspěch“.

Možná příčina:

Byl dosažen limit otevřených transakcí! V souladu s požadavkem BSI (Německý federální úřad pro bezpečnost informací) na TSE musí TSE omezit počet transakcí, které mohou být otevřeny současně.

• Hardwarové TSE od společnosti Swissbit zvládnou maximálně 512,
• fiskaly Cloud TSE 2 000 otevřených transakcí.

Jedná se o transakce, které byly zahájeny příkazem createDocument, ale později nebyly správně dokončeny (příkazem storeDocument nebo cancelDocument). K tomu může dojít například v případě, že dojde k selhání pokladního systému po provedení příkazu createDocument a systém si „nezapamatoval“, že jsou stále otevřené transakce.

Počet otevřených transakcí lze zjistit pomocí následujícího koncového bodu:

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

Otevřené transakce se v odpovědi zobrazují v poli „startedTransactions“:

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

Řešení problémů:

Chcete-li chybu odstranit nebo umožnit systému TSE opět přijímat dokumenty („účtenky“) ke zpracování, je nutné otevřené transakce uzavřít.

Postupujte následovně.

Možnost 1:

Pomocí

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

se v balíčcích vrátí čísla daňových dokladů (fiscalDocumentNumbers) otevřených transakcí.

Příklad:

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

Transakce načtené pomocí listTransactions (=fiscalDocumentNumber) musí být nyní, v souladu se skutečnou situací, uzavřeny buď pomocí:

• POST /api/v1/transactions/storeDocument, nebo
• POST /api/v1/transactions/cancelDocument

K dokončení dokladu po uskutečnění prodeje použijte (jako obvykle) POST /api/v1/transactions/storeDocument a ke zrušení transakce (bez úspěšného prodeje) použijte POST /api/v1/transactions/cancelDocument.

Možnost 2:

Použijte příkaz

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

lze použít k okamžitému uzavření všech otevřených transakcí TSE. Před použitím tohoto koncového bodu se prosím řiďte výše uvedenými pokyny týkajícími se zrušení dokladů! Po uzavření všech otevřených transakcí bude TSE opět přijímat a zpracovávat doklady.

Tento článek byl přeložen automaticky.