U ovom članku naučit ćete kako ispravno implementirati rukovanje pogreškama u Španjolskoj.

Preduvjeti

• FiscalClient od verzije 1.6.5 / Španjolska 1.0.5 za značajke označene zvjezdicom (*).
• FiscalClient od verzije 1.5.0

Opis

Španjolski sustav TicketBai omogućuje slanje generiranih računa odmah, ali i naknadno. Prilikom slanja računa mogu se pojaviti pogreške u validaciji. 

Kod sinkrone obrade, ovi se pogreške u validaciji odmah vraćaju POS sustavu. U slučaju odgođene prijenosa (sustav TicketBAI nije bio dostupan u trenutku izrade računa), pogreške se moraju očitati iz fiskalnog sustava i, ovisno o uzroku pogreške, problem treba riješiti u skladu s tim.

Sinkrono obrada

Sustav TicketBAI je dostupan i računi se mogu prenijeti.

Preduvjeti

• Sustav TicketBAI je dostupan
• Nema datoteka za prijenos (iz prethodnih prekida)

Potvrda se sinkrono prenosi u sustav TicketBAI. Ako je potvrda uspješno prenesena i nema pogrešaka pri validaciji, rezultat se vraća POS sustavu sa statusom uspješno.

Potvrda se pohranjuje u fiskalnom sustavu i u TicketBAI te se ne smije ponovno prenositi.

Uzroci pogrešaka

Sustav TicketBAI sada više nije dostupan

Potvrda se sprema u fiskalni sustav i čini dostupnom za sljedeći prijenos. Time se pokreće asinkroni proces.

Potvrda se pohranjuje u fiskalni sustav i kasnije prenosi u TicketBAI. Ne smije se ponovno prenositi u fiskalni sustav.

Greška pri validaciji iz TicketBAI

Kvitanac se ne sprema u fiskalni sustav i POS sustavu se vraća poruka o pogrešci zbog nevažećeg kvitanca.

Potvrda se mora ispravno ponovno prenijeti u fiskalni sustav.

Asinkrono obrađivanje

Sustav TicketBAI ili veza s njim nisu dostupni.

Preduvjeti

• FiscalClient je dostupan i spreman za rad
• Sustav TicketBAI nije dostupan ili je veza sa sustavom TicketBAI prekinuta.

Potvrde preuzima fiskalni sustav, pohranjuju se i označavaju za kasniji prijenos.

Zbog asinhrone obrade, greške pri validaciji ne mogu se izravno vratiti POS sustavu. Stoga je potrebno upititi stanja pogrešaka za ove račune.

Sve računi poslani asinkrono pohranjuju se u fiskalni sustav i više se ne mogu slati u fiskalni sustav.

Upit informacija o pogreškama i rješenju *

Ova je funkcija dostupna od verzije 1.6.5 fiskalnog klijenta.

Neuspjeli prijenosi mogu se upititi u fiskalnom sustavu.

Upit

Postoji sljedeći krajnji punkt za dohvaćanje datoteka s greškama:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Endpoint vraća informacije o pogreškama i GUID-ove (DocumentGuid) pogođenih dokumenata.

Parametar onlyAsync može se koristiti za dohvaćanje samo pogrešaka koje su se dogodile asinkrono.

Rješenje

Da bi se riješio problem, dokument se mora otkazati u fiskalnom sustavu, što se radi putem sljedećeg krajnje točke.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Ovom pozivom se potvrda otkazuje u fiskalnom sustavu, ali otkazivanje se ne prosljeđuje sustavu TicketBAI (potvrda još ne postoji u sustavu TicketBAI). Ako se ova potvrda označi kao otkazana, više se neće vraćati kao neispravna putem gore navedenog upita.

Dokument se otkazuje u fiskalnom sustavu – ne briše se!

Dokument se sada može ponovno prenijeti u fiskalni sustav s novim informacijama zaglavlja dokumenta (broj dokumenta, DocumentGuid itd.) i ispravljenim podacima. 

Ovaj je članak automatski preveden.