Errore di connessione TSE – RetailForce

La fiscalizzazione in Germania richiede l’utilizzo di un «dispositivo tecnico di sicurezza certificato» (TSE o TSS nella versione inglese dell’ordinanza). Se si utilizzano hardware TSE, dopo l’esecuzione di createDocument potrebbe essere restituito il messaggio di errore «Tse connection error.».

Possibili scenari:

Il TSE non è collegato

Il TSE non è collegato al registratore di cassa (al sistema su cui è installato il RetailForce Middleware).

Risoluzione dei problemi:

Collegare il TSE al sistema.

TSE collegato – l’esito del test riporta “OK”.

Viene restituito l’errore, ma il TSE è collegato al sistema; eseguire anche un test automatico

POST /api/v1/management/germany/TSE/{TseSerial}/selftest restituisce
"200 - Success",

così come il test di connessione:

PUT /api/v1/management/germany/{clientId}/TSE/connectTest,
"200 - Successo".

Possibile causa:

È stato raggiunto il limite delle transazioni aperte. A causa di un requisito TSE imposto dal BSI (Bundesamt für Sicherheit in der Informationstechnik, Ufficio federale tedesco per la sicurezza informatica), le TSE devono limitare il numero di transazioni che possono essere aperte contemporaneamente.

Il TSE hardware di Swissbit può gestire al massimo 512,
Fiskaly Cloud TSE 2'000 transazioni aperte.

Si tratta di transazioni avviate con createDocument ma non completate correttamente in seguito (con storeDocument o cancelDocument). Ciò può verificarsi, ad esempio, se il sistema POS si blocca dopo un createDocument e non ha «ricordato» che vi sono ancora transazioni aperte.

Il numero di transazioni aperte può essere letto tramite il seguente endpoint:

GET /api/v1/management/germany/TSE

Le transazioni aperte sono riportate nella risposta nel campo «startedTransactions»:

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

Risoluzione dei problemi:

Per correggere l’errore o consentire al TSE di accettare nuovamente i documenti («scontrini») per l’elaborazione, è necessario chiudere le transazioni aperte.

A tal fine, procedere come segue.

Opzione 1:

Utilizzando il

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

vengono restituiti in blocchi i fiscalDocumentNumbers delle transazioni aperte.

Esempio:

Le transazioni recuperate tramite listTransactions (=fiscalDocumentNumber) devono ora, in base alla situazione reale, essere chiuse tramite:

Utilizzare POST /api/v1/transactions/storeDocument (come di consueto) per completare il documento quando è stata effettuata una vendita e POST /api/v1/transactions/cancelDocument per annullare la transazione (in assenza di una vendita andata a buon fine).

Attenzione: si prega di notare che anche le cancellazioni dei documenti vengono (devono essere) registrate nel TSE. Pertanto, è necessario concludere ogni transazione avviata con PUT /api/v1/transactions/createDocument utilizzando "storeDocument" o "cancelDocument". In caso di frequenti cancellazioni di documenti, non si può escludere che le autorità fiscali possano richiedere chiarimenti sui motivi delle cancellazioni nel corso di un controllo del registratore di cassa .

Nota: per i TSE TEST/DEVELOPER , potrebbe essere più opportuno ripristinare le impostazioni di fabbrica del TSE anziché chiudere tutte le transazioni. Maggiori informazioni al riguardo sono disponibili nell’articolo «SWISSBIT HARDWARE TSE ».

Opzione 2:

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

può essere utilizzato per chiudere contemporaneamente tutte le transazioni TSE aperte. Si prega di assicurarsi di seguire le istruzioni sopra riportate relative alle cancellazioni dei documenti prima di utilizzare questo endpoint! Dopo aver chiuso tutte le transazioni aperte, il TSE accetterà ed elaborerà nuovamente i documenti.

Nota: i TSE restituiscono le transazioni aperte solo in pacchetti (SWISSBIT HARDWARE TSE: 8 transazioni aperte per richiesta, Cloud TSE: 100 transazioni aperte per richiesta). È necessario utilizzare la funzione più volte.

Attenzione: indipendentemente dalla modalità di risoluzione dell’errore, si raccomanda di analizzare attentamente la causa per cui le transazioni TSE rimangono aperte. Nel normale processo di chiusura, tutte le transazioni aperte dovrebbero essere chiuse prima della chiusura giornaliera.

Questo articolo è stato tradotto automaticamente.