În acest articol veți afla cum să implementați corect gestionarea erorilor în Spania.

Cerințe preliminare

• FiscalClient începând cu versiunea 1.6.5 / Spania 1.0.5 pentru funcționalitățile marcate cu *.
• FiscalClient începând cu versiunea 1.5.0

Descriere

The Spanish TicketBAI system offers the possibility to transmit generated receipts immediately, but also later. When transmitting the receipts, validation errors may occur. 

În cazul procesării sincrone, aceste erori de validare sunt raportate imediat către sistemul POS. În cazul transmiterii întârziate (TicketBAI system nu era disponibil la momentul creării bonului fiscal), erorile trebuie citite din sistemul fiscal și, în funcție de cauza erorii, problema trebuie rezolvată corespunzător.

Prelucrare sincronă

The TicketBAI system is available and fiscal receipts can be transferred.

Condiții prealabile

• TicketBAI system este disponibil
• Nu există fișiere de transmis (din întreruperile anterioare)

Chitanța este transferată sincron în TicketBAI system. Dacă chitanța este transferată cu succes și nu există erori de validare, rezultatul este returnat sistemului POS cu starea „succes”.

Bonul fiscal este stocat în sistemul fiscal și în TicketBAI și nu trebuie transferat din nou.

Cauze ale erorilor

TicketBAI system nu mai este disponibil

Bonul este salvat de sistemul fiscal și pus la dispoziție pentru următoarea transmisie. Astfel se inițiază procesul asincron.

Bonul este stocat în sistemul fiscal și este transferat ulterior către TicketBAI. Acesta nu trebuie transferat din nou către sistemul fiscal.

Eroare de validare din partea TicketBAI

Bonul nu este salvat în sistemul fiscal și se returnează un mesaj de eroare către sistemul POS cu privire la bonul nevalid.

Chitanța trebuie transferată din nou în mod corect în sistemul fiscal.

Procesare asincronă

TicketBAI system sau conexiunea la acesta nu este disponibilă.

Condiții preliminare

• FiscalClient este disponibil și gata de funcționare
• TicketBAI system nu este disponibil sau conexiunea la TicketBAI system este întreruptă.

Bonurile sunt preluate de sistemul fiscal, stocate și marcate pentru transfer ulterior.

Datorită procesării asincrone, erorile de validare nu pot fi returnate direct către sistemul POS. Prin urmare, trebuie interogate stările de eroare pentru aceste chitanțe.

Toate chitanțele transmise asincron sunt stocate în sistemul fiscal și nu mai pot fi transmise către sistemul fiscal.

Interogarea informațiilor despre erori și rezolvarea acestora *

Această funcție este disponibilă începând cu versiunea 1.6.5 a clientului fiscal.

Transferurile eșuate pot fi interogate în sistemul fiscal.

Interogare

Există următorul punct final pentru recuperarea fișierelor de eroare:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Punctul de interfață returnează informațiile privind erorile și codurile GUID (DocumentGuid) ale documentelor afectate.

Parametrul onlyAsync poate fi utilizat pentru a obține numai erorile care au apărut în mod asincron.

Soluție

Pentru a rezolva problema, documentul trebuie anulat în sistemul fiscal; acest lucru se realizează prin intermediul următorului punct final.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Prin această solicitare, chitanța este anulată în sistemul fiscal, dar anularea nu este transmisă către TicketBAI system (chitanța nu există încă în TicketBAI system). Dacă această chitanță este marcată ca fiind anulată, ea nu va mai fi returnată ca fiind eronată prin interogarea de mai sus.

Documentul este anulat în sistemul fiscal – nu este șters!

Documentul poate fi acum transferat din nou, cu informații noi din header-ul documentului (numărul documentului, DocumentGuid etc.), către sistemul fiscal, cu datele corectate. 

Acest articol a fost tradus automat.