U ovom članku naučit ćete kako pravilno implementirati rukovanje greškama u Španiji.

Preduvjeti

• FiscalClient od verzije 1.6.5 / Španija 1.0.5 za funkcije označene zvjezdicom (*).
• FiscalClient od verzije 1.5.0

Opis

Španski TicketBai sistem omogućava slanje generisanih računa odmah, ali i naknadno. Prilikom slanja računa mogu se pojaviti greške u validaciji. 

Kod sinkrone obrade, ovi grešci pri validaciji se odmah prijavljuju POS sistemu. U slučaju odgođene prijave (TicketBAI sistem nije bio dostupan u trenutku kreiranja računa), greške se moraju očitati iz fiskalnog sistema i, ovisno o uzroku greške, problem se mora riješiti u skladu s tim.

Sinkrono obrada

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

Preduvjeti

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

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

Potvrda se pohranjuje u fiskalni sistem i u TicketBAI i ne smije se ponovo prenositi.

Uzroci grešaka

Sistem TicketBAI više nije dostupan

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

Potvrda se pohranjuje u fiskalni sistem i kasnije se prenosi u TicketBAI. Ne smije se ponovo prenositi u fiskalni sistem.

Greška pri validaciji iz TicketBAI

Kvitanac se ne sprema u fiskalni sistem i POS sistemu se vraća poruka o grešci zbog nevažećeg kvitanca.

Potvrda se mora ispravno ponovo prenijeti u fiskalni sistem.

Asinkrono obradu

Sistem TicketBAI ili veza s njim nisu dostupni.

Preduvjeti

• FiscalClient je dostupan i spreman za rad
• TicketBAI sistem nije dostupan ili je veza sa TicketBAI sistemom prekinuta.

Prijemnice preuzima fiskalni sistem, pohranjuje ih i označava za kasniji prijenos.

Zbog asinhrone obrade, greške u validaciji se ne mogu direktno vratiti POS sistemu. Stoga je potrebno upitati stanja grešaka za ove račune.

Svi asinhrono preneseni računi se pohranjuju u fiskalni sistem i više se ne mogu slati u fiskalni sistem.

Upit informacija o greškama i rješenju *

Ova funkcija je dostupna od verzije 1.6.5 fiskalnog klijenta.

Neuspjeli transferi se mogu upititi u fiskalnom sistemu.

Upit

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

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

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

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

Rješenje

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

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Ovim pozivom se potvrda otkazuje u fiskalnom sistemu, ali otkazivanje se ne prosljeđuje sistemu TicketBAI (potvrda još ne postoji u sistemu 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 sistemu - ne briše se!

Dokument se sada može ponovo prenijeti u fiskalni sistem sa novim informacijama o zaglavlju dokumenta (broj dokumenta, DocumentGuid itd.) sa ispravljenim podacima. 

Ovaj članak je automatski preveden.