TSE-kapcsolati hiba – RetailForce

A németországi adóügyi előírások szerint „hitelesített technikai biztonsági eszköz” (a rendelet angol nyelvű változatában TSE vagy TSS) használata kötelező. Ha hardware TSE-ket használnak, a createDocument művelet után előfordulhat, hogy a rendszer a „Tse connection error.” hibaüzenetet adja vissza.

Lehetséges esetek:

A TSE nincs csatlakoztatva

A TSE nincs csatlakoztatva a pénztárgéphez (ahhoz a rendszerhez, amelyen a RetailForce Middleware telepítve van).

Hibaelhárítás:

Csatlakoztassa a TSE-t a rendszerhez.

TSE csatlakoztatva – a teszt „OK” eredményt jelez

A hibaüzenet megjelenik, de a TSE csatlakozik a rendszerhez, az önteszt eredménye is „OK”

POST /api/v1/management/germany/TSE/{TseSerial}/selftest parancs a következő eredményt adja:
„200 – Siker”

ahogyan a kapcsolat-teszt is:

PUT /api/v1/management/germany/{clientId}/TSE/connectTest,
„200 – Siker”.

Lehetséges ok:

Elérte a nyitott tranzakciók számának korlátját! A BSI (Német Szövetségi Információbiztonsági Hivatal) által előírt TSE-követelmény miatt a TSE-knek korlátozniuk kell az egyidejűleg nyitott tranzakciók számát.

Swissbit hardware TSE legfeljebb 512,
Fiskaly Cloud TSE pedig 2 000 nyitott tranzakciót.

Ezek olyan tranzakciók, amelyeket a createDocument paranccsal indítottak el, de később nem fejezték be megfelelően (a storeDocument vagy a cancelDocument paranccsal). Ez akkor fordulhat elő például, ha a POS-rendszer a createDocument parancs után összeomlik, és nem „jegyezte meg”, hogy még vannak nyitott tranzakciók.

A nyitott tranzakciók száma a következő végponttal olvasható ki:

GET /api/v1/management/germany/TSE

A nyitott tranzakciók a válaszban a „startedTransactions” mezőben jelennek meg:

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

Hibaelhárítás:

A hiba kijavításához, illetve ahhoz, hogy a TSE ismét feldolgozásra fogadja a dokumentumokat („nyugtákat”), a nyitott tranzakciókat le kell zárni.

Ehhez kövesse az alábbi lépéseket.

1. lehetőség:

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

végpont használatával a nyitott tranzakciók fiscalDocumentNumber értékei csomagokban kerülnek visszaadásra.

Példa:

A listTransactions paranccsal lekért tranzakciókat (=fiscalDocumentNumber) a valós helyzetnek megfelelően most le kell zárni az alábbiak egyikével:

Használja a POST /api/v1/transactions/storeDocument parancsot (a szokásos módon) a dokumentum véglegesítéséhez, ha értékesítés történt, és a POST /api/v1/transactions/cancelDocument parancsot a tranzakció törléséhez (sikeres értékesítés nélkül).

Figyelem: kérjük, vegye figyelembe, hogy a dokumentumok törléseit a TSE-ben is rögzíteni kell. Ezért minden , a PUT /api/v1/transactions/createDocument paranccsal indított tranzakciót „storeDocument” vagy „cancelDocument” paranccsal is le kell zárni. Gyakori dokumentumtörlések esetén nem zárható ki, hogy az adóhatóság egy pénztárgép-ellenőrzés során kérdéseket tegyen fel a törlések okairól.

Megjegyzés: A TEST/DEVELOPER TSE-k esetében célszerűbb lehet a TSE-t gyári beállításokra visszaállítani, ahelyett, hogy minden tranzakciót lezárnánk. Erről további információkat a „SWISSBIT HARDWARE TSE ” című cikkben talál.

2. lehetőség:

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

végpont segítségével egyszerre lezárhatók az összes nyitott TSE-tranzakció. Kérjük, feltétlenül kövesse a dokumentumok törlésével kapcsolatos fenti utasításokat, mielőtt ezt a végpontot használná! Az összes nyitott tranzakció lezárása után a TSE ismét elfogadja és feldolgozza a dokumentumokat.

Megjegyzés: A TSE-k a nyitott tranzakciókat csak csomagokban adják vissza (SWISSBIT HARDWARE TSE: kérésenként 8 nyitott tranzakció, Cloud TSE-k: kérésenként 100 nyitott tranzakció)! A függvényt többször is el kell futtatnia.

Figyelem: Függetlenül attól, hogy a hibát hogyan sikerült megoldani, javasoljuk, hogy alaposan elemezze, miért maradnak nyitva a TSE-tranzakciók. A szokásos elszámolási folyamat során a napi zárás előtt minden nyitott tranzakciót le kell zárni.

Ezt a cikket automatikusan lefordították.