Eroare de conexiune TSE – RetailForce

Fiscalizarea în Germania impune utilizarea unui „dispozitiv tehnic de securitate certificat” (TSE sau TSS în versiunea în limba engleză a ordonanței). În cazul utilizării unor hardware TSE, este posibil să apară mesajul de eroare „Tse connection error.” după executarea comenzii createDocument.

Scenarii posibile:

TSE-ul nu este conectat

Dispozitivul TSE nu este conectat la casa de marcat (la sistemul pe care este instalat RetailForce Middleware).

Depanare:

Conectați TSE-ul la sistem.

TSE conectat – testul indică „OK”

Se afișează eroarea, dar TSE este conectat la sistem; de asemenea, a fost efectuat un autotest

POST /api/v1/management/germany/TSE/{TseSerial}/selftest returnează
„200 – Succes”,

la fel ca și un test de conexiune:

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

Cauză posibilă:

S-a atins limita tranzacțiilor deschise! Conform unei cerințe TSE impuse de BSI (Oficiul Federal German pentru Securitatea Informațiilor), dispozitivele TSE trebuie să limiteze numărul de tranzacții care pot fi deschise simultan.

SWISSBIT HARDWARE TSE poate gestiona maximum 512,
fiskaly Cloud TSE 2.000 de tranzacții deschise.

Acestea sunt tranzacții care au fost inițiate cu createDocument, dar care nu au fost finalizate corect ulterior (cu storeDocument sau cancelDocument). Acest lucru se poate întâmpla, de exemplu, dacă sistemul POS se blochează după o comandă createDocument și nu a „reținut” că mai există tranzacții deschise.

Numărul de tranzacții deschise poate fi citit cu ajutorul următorului punct final:

GET /api/v1/management/germany/TSE

Tranzacțiile deschise sunt afișate în răspuns în câmpul „startedTransactions”:

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

Depanare:

Pentru a remedia eroarea sau pentru a permite TSE să accepte din nou documente („chitanțe”) pentru procesare, tranzacțiile deschise trebuie închise.

Pentru aceasta, procedați după cum urmează.

Opțiunea 1:

Utilizând comanda

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

se returnează în pachete numerele de fiscalDocumentNumbers ale tranzacțiilor deschise.

Exemplu:

Tranzacțiile recuperate prin listTransactions (=fiscalDocumentNumber) trebuie acum, în funcție de situația reală, să fie închise fie cu:

Utilizați POST /api/v1/transactions/storeDocument (ca de obicei) pentru a finaliza documentul atunci când s-a efectuat o vânzare și POST /api/v1/transactions/cancelDocument pentru a anula tranzacția (fără o vânzare reușită).

Atenție: vă rugăm să rețineți că anulările documentelor sunt (trebuie să fie) înregistrate și în TSE. Prin urmare, este necesar ca fiecare tranzacție inițiată cu PUT /api/v1/transactions/createDocument să fie finalizată cu „storeDocument” sau „cancelDocument”. În cazul unor anulări frecvente ale documentelor, nu putem exclude posibilitatea ca autoritățile fiscale să pună întrebări cu privire la motivele anulărilor în cadrul unei inspecții a casei de marcat .

Notă: Pentru TSE-urile de TEST/DEZVOLTARE , poate fi mai indicat să resetați TSE-ul la setările din fabrică, în loc să închideți toate tranzacțiile. Mai multe informații despre acest aspect pot fi găsite în articolul „SWISSBIT HARDWARE TSE ”.

Opțiunea 2:

Comanda

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

poate fi utilizat pentru a închide simultan toate tranzacțiile TSE deschise. Asigurați-vă că urmați instrucțiunile de mai sus privind anularea documentelor înainte de a utiliza acest punct de interfață! După închiderea tuturor tranzacțiilor deschise, TSE va accepta și va procesa din nou documente.

Notă: TSE-urile vor returna tranzacțiile deschise numai în pachete (SWISSBIT HARDWARE TSE: 8 tranzacții deschise pe cerere, Cloud TSE: 100 de tranzacții deschise pe cerere)! Trebuie să utilizați funcția de mai multe ori.

Atenție: Indiferent de modul în care a fost rezolvată eroarea, vă recomandăm să analizați cu atenție motivul pentru care tranzacțiile TSE rămân deschise. În cadrul procesului obișnuit de închidere, toate tranzacțiile deschise trebuie închise înainte de închiderea zilnică.

Acest articol a fost tradus automat.