Błąd połączenia z TSE

Wymogi fiskalne w Niemczech nakładają obowiązek stosowania „certyfikowanego technicznego urządzenia zabezpieczającego” (TSE lub TSS w angielskiej wersji rozporządzenia). W przypadku korzystania ze sprzętowych urządzeń TSE po wywołaniu funkcji createDocument może pojawić się komunikat o błędzie „Tse connection error.”

Możliwe scenariusze:

Urządzenie TSE nie jest podłączone

Urządzenie TSE nie jest podłączone do kasy fiskalnej (do systemu, na którym zainstalowano oprogramowanie RetailForce Middleware).

Rozwiązywanie problemów:

Proszę podłączyć TSE do systemu.

Urządzenie TSE jest podłączone – wynik testu to „OK”

Pojawia się komunikat o błędzie, ale TSE jest podłączone do systemu; przeprowadzono również autotest

• POST /api/v1/management/germany/TSE/{TseSerial}/selftest zwraca
• „200 – Sukces”,

podobnie jak test połączenia:

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

Możliwa przyczyna:

Osiągnięto limit otwartych transakcji! Zgodnie z wymogiem dotyczącym TSE określonym przez BSI (Federalny Urząd ds. Bezpieczeństwa Informacji), urządzenia TSE muszą ograniczać liczbę transakcji, które mogą być otwarte jednocześnie.

• SWISSBIT HARDWARE TSE może obsłużyć maksymalnie 512,
• Fiskaly Cloud TSE – 2 000 otwartych transakcji.

Są to transakcje, które zostały zainicjowane za pomocą funkcji createDocument, ale nie zostały później poprawnie zakończone (za pomocą funkcji storeDocument lub cancelDocument). Może to mieć miejsce na przykład wtedy, gdy system POS ulegnie awarii po wykonaniu funkcji createDocument i nie „zapamiętał”, że nadal istnieją otwarte transakcje.

Liczbę otwartych transakcji można odczytać za pomocą następującego punktu końcowego:

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

Otwarte transakcje są wyświetlane w odpowiedzi w polu „startedTransactions”:

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

Rozwiązywanie problemów:

Aby usunąć błąd lub umożliwić systemowi TSE ponowne przyjmowanie dokumentów („paragonów”) do przetwarzania, należy zamknąć otwarte transakcje.

W tym celu należy postępować w następujący sposób.

Opcja 1:

Korzystając z polecenia

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

zwracane są w pakietach numery fiscalDocumentNumbers otwartych transakcji.

Przykład:

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

Transakcje pobrane za pomocą listTransactions (=fiscalDocumentNumber) należy teraz, zgodnie z rzeczywistą sytuacją, zamknąć za pomocą:

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

Należy użyć żądania POST /api/v1/transactions/storeDocument (jak zwykle) w celu sfinalizowania dokumentu po dokonaniu sprzedaży oraz żądania POST /api/v1/transactions/cancelDocument w celu anulowania transakcji (w przypadku braku pomyślnej sprzedaży).

Opcja 2:

Funkcja

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

można wykorzystać do jednoczesnego zamknięcia wszystkich otwartych transakcji w urządzeniu TSE. Przed skorzystaniem z tego punktu końcowego prosimy o zapoznanie się z powyższymi instrukcjami dotyczącymi anulowania dokumentów! Po zamknięciu wszystkich otwartych transakcji urządzenie TSE ponownie zacznie przyjmować i przetwarzać dokumenty.

Ten artykuł został przetłumaczony automatycznie.