Napaka pri povezavi s TSE

Fiskalizacija v Nemčiji zahteva uporabo »certificirane tehnične varnostne naprave« (TSE ali TSS v angleški različici uredbe). Če se uporabljajo hardware TSE-je, se po izvedbi ukaza createDocument lahko prikaže napaka »Tse connection error.«.

Možni scenariji:

TSE ni priključena

TSE ni priključen na blagajno (na sistem, na katerem je nameščen RetailForce Middleware).

Odpravljanje težav:

Povežite TSE s sistemom.

TSE je priključen – test prikazuje »OK«

Prikaže se napaka, vendar je TSE povezan s sistemom, opravljen je tudi samopreizkus

• POST /api/v1/management/germany/TSE/{TseSerial}/selftest vrne
• »200 – Uspešno«,

enako kot test povezave:

• PUT /api/v1/management/germany/{clientId}/TSE/connectTest,
• »200 – Uspešno«.

Možni vzrok:

Dosežena je bila omejitev odprtih transakcij! Zaradi zahteve BSI (Nemški zvezni urad za informacijsko varnost) morajo TSE-ji omejiti število transakcij, ki so lahko odprte hkrati.

• SWISSBIT HARDWARE TSE lahko upravlja največ 512,
• Fiskaly Cloud TSE pa 2.000 odprtih transakcij.

To so transakcije, ki so bile začete s funkcijo createDocument, vendar kasneje niso bile pravilno zaključene (s funkcijo storeDocument ali cancelDocument). To se lahko zgodi na primer, če se POS-sistem po izvedbi funkcije createDocument sesuje in si ni »zapomnil«, da so še vedno odprte transakcije.

Število odprtih transakcij je mogoče prebrati z naslednjim končnim točkom:

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

Odprte transakcije so v odgovoru prikazane v polju »startedTransactions«:

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

Odpravljanje težav:

Da bi odpravili napako ali omogočili sistemu TSE, da ponovno sprejema dokumente („račune“) v obdelavo, je treba odprte transakcije zapreti.

Za to ravnajte na naslednji način.

Možnost 1:

Z uporabo

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

se v paketih vrnejo fiscalDocumentNumbers odprtih transakcij.

Primer:

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

Transakcije, pridobljene prek listTransactions (=fiscalDocumentNumber), je treba zdaj, glede na dejansko situacijo, zapreti bodisi s:

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

Uporabite POST /api/v1/transactions/storeDocument (kot običajno) za dokončanje dokumenta, ko je bila prodaja opravljena, in POST /api/v1/transactions/cancelDocument za preklic transakcije (brez uspešne prodaje).

Možnost 2:

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

se lahko uporabi za hkratno zaprtje vseh odprtih transakcij TSE. Pred uporabo te končne točke se prepričajte, da upoštevate zgornja navodila glede preklica dokumentov! Po zaprtju vseh odprtih transakcij bo TSE spet sprejemal in obdeloval dokumente.

Ta članek je bil samodejno preveden.