Chyba pripojenia k TSE – RetailForce

Fiskalizácia v Nemecku vyžaduje použitie „certifikovaného technického bezpečnostného zariadenia“ (TSE alebo TSS v anglickej verzii nariadenia). Ak sa používajú hardware TSE, po volaní createDocument sa môže zobraziť chybová správa „Tse connection error.“.

Možné scenáre:

TSE nie je pripojené

TSE nie je pripojené k pokladni (k systému, na ktorom je nainštalovaný RetailForce Middleware).

Riešenie problému:

Pripojte TSE k systému.

TSE je pripojené – test vykazuje „OK“

Chyba sa vráti, ale TSE je pripojené k systému, rovnako aj autotest

POST /api/v1/management/germany/TSE/{TseSerial}/selftest vráti
„200 – Úspešné“,

rovnako ako test pripojenia:

PUT /api/v1/management/germany/{clientId}/TSE/connectTest,
„200 – Úspešné“.

Možná príčina:

Bol dosiahnutý limit otvorených transakcií! Vzhľadom na požiadavku BSI (Nemecký federálny úrad pre informačnú bezpečnosť) týkajúcu sa TSE musia TSE obmedziť počet transakcií, ktoré môžu byť otvorené súčasne.

SWISSBIT HARDWARE TSE zvládnu maximálne 512,
Fiskaly Cloud TSE 2 000 otvorených transakcií.

Ide o transakcie, ktoré boli spustené pomocou createDocument, ale neskôr neboli správne dokončené (pomocou storeDocument alebo cancelDocument). K tomu môže dôjsť napríklad v prípade, ak POS systém po vykonaní createDocument havaruje a „nezapamätal si“, že stále existujú otvorené transakcie.

Počet otvorených transakcií je možné zistiť pomocou nasledujúceho koncového bodu:

GET /api/v1/management/germany/TSE

Otvorené transakcie sa v odpovedi zobrazujú v poli „startedTransactions“:

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

Riešenie problémov:

Na odstránenie chyby alebo na to, aby systém TSE mohol opäť prijímať dokumenty („účtenky“) na spracovanie, je potrebné uzavrieť otvorené transakcie.

Postupujte nasledovne.

Možnosť 1:

Pomocou

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

sa v balíkoch vrátia fiscalDocumentNumbers otvorených transakcií.

Príklad:

Transakcie získané prostredníctvom listTransactions (=fiscalDocumentNumber) musia byť teraz, podľa skutočnej situácie, uzavreté buď pomocou:

Na dokončenie dokumentu v prípade uskutočnenia predaja použite (ako zvyčajne) POST /api/v1/transactions/storeDocument a na zrušenie transakcie (bez úspešného predaja) použite POST /api/v1/transactions/cancelDocument.

Upozornenie: vezmite prosím na vedomie, že zrušenia dokumentov sa (musia) zaznamenať aj v TSE. Preto je tiež potrebné ukončiť každú transakciu začatú pomocou PUT /api/v1/transactions/createDocument pomocou „storeDocument“ alebo „cancelDocument“. V prípade častých zrušení dokumentov nemôžeme vylúčiť možnosť, že daňové orgány môžu v priebehu kontroly pokladne klásť otázky týkajúce sa dôvodov týchto zrušení.

Poznámka: V prípade TSE v režime TEST/DEVELOPER môže mať väčší zmysel obnoviť TSE na továrenské nastavenia namiesto uzatvárania všetkých transakcií. Viac informácií o tejto téme nájdete v článku „SWISSBIT HARDWARE TSE “.

Možnosť 2:

Použite

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

slúži na jednorazové uzavretie všetkých otvorených transakcií TSE. Pred použitím tohto koncového bodu sa uistite, že ste postupovali podľa vyššie uvedených pokynov týkajúcich sa zrušenia dokladov! Po uzavretí všetkých otvorených transakcií bude TSE opäť prijímať a spracovávať doklady.

Poznámka: TSE vrátia otvorené transakcie iba v balíkoch (hardware TSE od swissbit: 8 otvorených transakcií na jednu požiadavku, cloudové TSE: 100 otvorených transakcií na jednu požiadavku)! Túto funkciu je potrebné použiť viackrát.

Upozornenie: Bez ohľadu na to, ako bola chyba vyriešená, odporúčame vám dôkladne analyzovať dôvod, prečo transakcie TSE zostávajú otvorené. V bežnom procese uzávierky by mali byť všetky otvorené transakcie uzavreté pred denným uzatvorením.

Tento článok bol preložený automaticky.