I denne artikel lærer du, hvordan du korrekt implementerer fejlhåndtering i Spanien.

Forudsætninger

• FiscalClient fra version 1.6.5 / Spanien 1.0.5 for funktioner markeret med *.
• FiscalClient fra og med version 1.5.0

Beskrivelse

Det spanske TicketBAI-system giver mulighed for at indsende de genererede kvitteringer med det samme, men også senere. Ved indsendelse af kvitteringerne kan der opstå valideringsfejl. 

Ved synkron behandling rapporteres disse valideringsfejl straks tilbage til POS-systemet. I tilfælde af forsinket overførsel (TicketBAI systemet var ikke tilgængeligt på tidspunktet for kvitteringens oprettelse) skal fejlene udlæses fra det skattemæssige system, og afhængigt af årsagen til fejlen skal problemet håndteres i overensstemmelse hermed.

Synkron behandling

TicketBAI systemet er tilgængeligt, og kvitteringer kan overføres.

Forudsætninger

• TicketBAI systemet er tilgængeligt
• Der er ingen filer til overførsel (fra tidligere afbrydelser)

Kvitteringen overføres synkront til TicketBAI-systemet. Hvis kvitteringen overføres uden problemer, og der ikke er nogen valideringsfejl, returneres resultatet til POS-systemet med status "vellykket".

Kvitteringen gemmes i det skattemæssige system og i TicketBAI og må ikke overføres igen.

Årsager til fejl

TicketBAI systemet er nu ikke længere tilgængeligt

Kvitteringen gemmes af det skattepligtige system og gøres tilgængelig til den næste overførsel. Dette starter den asynkrone proces.

Kvitteringen gemmes i det skattepligtige system og overføres senere til TicketBAI systemet. Den må ikke overføres til det skattepligtige system igen.

Valideringsfejl fra TicketBAI

Kvitteringen gemmes ikke i det skattemæssige system, og der returneres en fejlmeddelelse til POS-systemet om den ugyldige kvittering.

Kvitteringen skal overføres korrekt til det skattepligtige system endnu en gang.

Asynkron behandling

TicketBAI systemet eller forbindelsen til det er ikke tilgængelig.

Forudsætninger

• FiscalClient er tilgængeligt og klar til brug
• TicketBAI systemet er ikke tilgængeligt, eller forbindelsen til TicketBAI-systemet er afbrudt.

Kvitteringerne overføres til det skattemæssige system, gemmes og markeres til senere overførsel.

På grund af asynkron behandling kan valideringsfejl ikke returneres direkte til POS-systemet. Derfor skal fejltilstandene for disse kvitteringer forespørges.

Alle asynkront overførte kvitteringer gemmes i det skattemæssige system og kan ikke længere overføres til det skattemæssige system.

Forespørgsel om fejloplysninger og løsning *

Denne funktion er tilgængelig fra version 1.6.5 af det skattepligtige klientprogram.

De mislykkede overførsler kan forespørges i det skattemæssige system.

Forespørgsel

Der findes følgende endpoint til hentning af fejlfilerne:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Endpointet returnerer fejloplysningerne og DocumentGuid'erne for de berørte dokumenter.

Parameteren onlyAsync kan bruges til kun at hente fejl, der opstod asynkront.

Løsning

For at løse problemet skal dokumentet annulleres i regnskabssystemet. Dette gøres via følgende endpoint.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Med dette opkald annulleres kvitteringen i det skattemæssige system, men annulleringen videresendes ikke til TicketBAI systemet (kvitteringen findes endnu ikke i TicketBAI systemet). Hvis denne kvittering markeres som annulleret, vil den ikke længere blive returneret som fejlbehæftet via ovenstående forespørgsel.

Dokumentet annulleres i det skattemæssige system – det slettes ikke!

Dokumentet kan nu overføres igen med nye dokumentheader-oplysninger (dokumentnummer, DocumentGuid osv.) til det skattemæssige system med de korrigerede data. 

Denne artikel er oversat automatisk.