In questo articolo imparerete come implementare correttamente la gestione degli errori in Spagna.

Prerequisiti

• FiscalClient a partire dalla versione 1.6.5 / Spagna 1.0.5 per le funzionalità contrassegnate con *.
• FiscalClient a partire dalla versione 1.5.0

Descrizione

Il sistema spagnolo TicketBAI consente di trasmettere gli scontrini generati sia in modo sincrono che asincrono. Durante l’invio possono verificarsi errori di validazione. 

Con l’elaborazione sincrona, tali errori di convalida vengono immediatamente segnalati al sistema POS. In caso di trasmissione ritardata (il TicketBAI system non era disponibile al momento della creazione della ricevuta), gli errori devono essere letti dal sistema fiscale e, a seconda della causa dell’errore, il problema deve essere risolto di conseguenza.

Elaborazione sincrona

Il sistema TicketBAI è disponibile e consente il trasferimento delle ricevute.

Prerequisiti

• Il sistema TicketBAI è disponibile
• Non sono presenti file da trasmettere (derivanti da precedenti interruzioni)

Lo scontrino viene trasferito in modo sincrono al sistema TicketBAI. Se il trasferimento dello scontrino va a buon fine e non si riscontrano errori di convalida, il risultato viene restituito al sistema POS con lo stato «completato con successo».

Lo scontrino viene archiviato sia nel sistema fiscale sia in TicketBAI e non deve essere trasmesso nuovamente.

Cause degli errori

Il sistema TicketBAI non è più disponibile

Lo scontrino viene salvato dal sistema fiscale e reso disponibile per la successiva trasmissione. In questo modo si avvia il processo asincrono.

Lo scontrino viene archiviato nel sistema fiscale e successivamente trasferito a TicketBAI. Non deve essere trasferito nuovamente al sistema fiscale.

Errore di convalida da parte di TicketBAI

La ricevuta non viene salvata nel sistema fiscale e al sistema POS viene restituito un messaggio di errore relativo alla ricevuta non valida.

Lo scontrino deve essere nuovamente trasferito correttamente al sistema fiscale.

Elaborazione asincrona

Il sistema TicketBAI o la connessione ad esso non sono disponibili.

Prerequisiti

• FiscalClient è disponibile e pronto all’uso
• Il sistema TicketBAI non è disponibile o la connessione al sistema TicketBAI è interrotta.

Le ricevute vengono acquisite dal sistema fiscale, archiviate e contrassegnate per il trasferimento successivo.

A causa dell’elaborazione asincrona, le eccezioni di convalida non possono essere restituite direttamente al sistema POS. Pertanto, è necessario interrogare gli stati di errore relativi a tali ricevute.

Tutte le ricevute trasmesse in modo asincrono vengono archiviate nel sistema fiscale e non possono più essere ritrasmesse al sistema fiscale.

Richiesta delle informazioni di errore e risoluzione *

Questa funzionalità è disponibile a partire dalla versione 1.6.5 del client fiscale.

È possibile interrogare i trasferimenti non andati a buon fine presso il sistema fiscale.

Endpoint di richiesta

È disponibile il seguente endpoint per recuperare i file di errore:

REST:

GET /api/v1/transactions/errorDocuments/{clientId}

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

L'endpoint restituisce le informazioni relative agli errori e i GUID (DocumentGuid) dei documenti interessati.

È possibile utilizzare il parametro onlyAsync per ottenere esclusivamente gli errori verificatisi in modo asincrono.

Soluzione

Per risolvere il problema, è necessario annullare il documento nel sistema contabile; tale operazione avviene tramite il seguente endpoint.

REST:

DELETE /api/v1/transactions/errorDocuments/{clientId}/{documentGuid}

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Con questa chiamata, la ricevuta viene annullata nel sistema fiscale, ma l’annullamento non viene inoltrato al TicketBAI system (la ricevuta non esiste ancora nel TicketBAI system). Se questa ricevuta viene contrassegnata come annullata, non verrà più restituita come errata tramite la query sopra indicata.

Il documento viene annullato nel sistema fiscale – non cancellato.

Il documento può ora essere nuovamente trasferito al sistema fiscale con nuove informazioni di header (numero del documento, DocumentGuid, ecc.) e con i dati corretti. 

Questo articolo è stato tradotto automaticamente.