Tse ryšio klaida

Vokietijoje taikomi fiskaliniai reikalavimai numato, kad turi būti naudojamas vadinamasis sertifikuotas techninis saugumo įrenginys (TSE). Jei naudojamas aparatinis TSE, gali atsitikti taip, kad po komandos „createDocument“ bus grąžintas klaidos pranešimas „Tse connection error.“.

Galimi scenarijai:

1. TSE neprijungta

TSE nėra prijungtas prie kasos (prie sistemos, kurioje įdiegta „RetailForce“ tarpinė programinė įranga).

Sprendimas:

Prijunkite TSE prie sistemos.

2. TSE prijungta – testas rodo „OK“

Klaida grąžinama, tačiau TSE yra prijungtas prie sistemos, taip pat atliktas savikontrolės testas:

• POST /api/v1/management/germany/tse/{tseSerial}/selftest pateikia
• „200 – Success“

taip pat kaip ir ryšio testas:

• PUT /api/v1/management/germany/{clientId}/tse/connectTest
• „200 – Success“

Galima priežastis:

Pasiektas atvirų sandorių limitas! Dėl BSI (Federalinės informacinių technologijų saugumo tarnybos) reikalavimo TSE turi riboti sandorių, kurie gali būti atviri tuo pačiu metu, skaičių.

• „swissbit“ aparatinės įrangos TSE gali valdyti ne daugiau kaip 512,
• o „fiskaly Cloud TSE“ – 2 000 atvirų sandorių.

Tai yra sandoriai, kurie buvo pradėti naudojant „createDocument“, bet vėliau nebuvo tinkamai užbaigti (naudojant „storeDocument“ arba „cancelDocument“). Tai gali atsitikti, pavyzdžiui, jei kasos sistema po „createDocument“ užstrigo ir „neįsidėmėjo“, kad dar yra atvirų sandorių.

Atvirų sandorių skaičių galima sužinoti naudodami šį galinį tašką:

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

Atidarytos operacijos atsakymo lauke „startedTransactions“ rodomos taip:

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

Išsprendimas:

Norint išspręsti šią klaidą, t. y. kad TSE vėl priimtų dokumentus (kvitus) apdorojimui, reikia užbaigti nebaigtas operacijas.

Tam atlikite šiuos veiksmus.

1 galimybė:

Naudodami galinį tašką:

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

grąžinami nebaigtų sandorių fiscalDocumentNumbers paketais.

Pavyzdys:

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

Naudojant listTransactions gautos operacijos (=fiscalDocumentNumber) dabar, atsižvelgiant į realią situaciją, turi būti arba:

• POST /api/v1/transactions/storeDocument arba
• POST /api/v1/transactions/cancelDocument

.

Naudokite POST /api/v1/transactions/storeDocument (kaip įprasta), kad užbaigtumėte dokumentą, jei pardavimas įvyko, ir POST /api/v1/transactions/cancelDocument, kad nutrauktumėte sandorį (be sėkmingo pardavimo).

2 galimybė:

Naudojant galinį tašką

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

galima vienu metu uždaryti visas atidarytas TSE operacijas. Prieš naudodami šį galinį tašką, būtinai atsižvelkite į aukščiau pateiktas pastabas dėl dokumentų nutraukimo! Uždarius visas atidarytas operacijas, TSE vėl priims ir apdoros dokumentus.