Šiame straipsnyje sužinosite, kaip teisingai įgyvendinti klaidų tvarkymą Ispanijoje.

Reikalavimai

• „FiskalClient“ nuo versijos 1.6.6 / „Ispanija 1.0.5“ funkcijoms, pažymėtoms žvaigždute
• „FiskalClient“ nuo versijos 1.5.0

Aprašymas

Ispanijos „TicketBai“ sistema suteikia galimybę pateikti sukurtus dokumentus iš karto arba vėliau. Pateikiant dokumentus gali atsirasti patvirtinimo klaidų. 

Sinchroninio apdorojimo metu šios patvirtinimo klaidos iš karto perduodamos atgal į kasos sistemą. Vėluojant perdavimui (TicketBAI sistema nebuvo prieinama dokumento sukūrimo metu), klaidos turi būti nuskaitytos iš fiskalinės sistemos ir, priklausomai nuo klaidos priežasties, problema turi būti atitinkamai išspręsta.

Sinchroninis apdorojimas

„TicketBAI“ sistema veikia ir kvitus galima perduoti.

Reikalavimai

• „TicketBAI“ sistema veikia
• Nėra failų perdavimui (iš ankstesnių pertraukų)

Kvitą sinchroniškai perduodama į „TicketBAI“ sistemą. Jei kvitas sėkmingai perduodamas ir nėra patvirtinimo klaidų, rezultatas su statusu „sėkmingai“ grąžinamas į kasos sistemą.

Kvitą saugoma fiskalinėje sistemoje ir „TicketBAI“ sistemoje, todėl jos negalima perduoti dar kartą.

Klaidų priežastys

„TicketBAI“ sistema dabar nebeprieinama

Kvitą išsaugo fiskalinė sistema ir parengia kitam perdavimui. Taip prasideda asinchroninis procesas.

Kvitą saugo fiskalinė sistema, o vėliau jis perduodamas į „TicketBAI“. Jo negalima perduoti į fiskalinę sistemą dar kartą.

„TicketBAI“ patvirtinimo klaida

Kvitą fiskalinė sistema neišsaugo, o kasos sistemai grąžinamas pranešimas apie negaliojantį kvitą.

Kvitą reikia dar kartą teisingai perduoti į fiskalinę sistemą.

Asinchroninis apdorojimas

„TicketBAI“ sistema arba ryšys su ja nėra prieinamas.

Reikalavimai

• „FiskalClient“ yra prieinama ir veikia
• „TicketBAI“ sistema nėra prieinama arba ryšys su „TicketBAI“ sistema yra nutrauktas.

Kvitai perimami iš fiskalinės sistemos, išsaugomi ir pažymimi vėlesniam perdavimui.

Dėl asinchroninio apdorojimo patvirtinimo klaidos negali būti iškart grąžintos į kasos sistemą. Todėl reikia patikrinti šių dokumentų klaidų būsenas. 

Visi asinchroniškai perduoti dokumentai yra išsaugoti fiskalinėje sistemoje ir negali būti perduoti atgal į fiskalinę sistemą.

Klaidų informacijos užklausa ir išsprendimas *

Ši funkcija yra prieinama nuo fiskalinio kliento versijos 1.6.5.

Nepavykusios perdavimo operacijos gali būti užklausomos fiskalinėje sistemoje.

Užklausa

Tam yra skirtas šis galinis taškas, skirtas klaidų failams gauti:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Galinis taškas grąžina klaidų informaciją ir atitinkamų dokumentų GUID (DocumentGuid). 

Parametras onlyAsync gali būti naudojamas norint gauti tik asinchronines klaidas.

Sprendimas

Norint išspręsti šią problemą, dokumentas turi būti anuliuotas fiskalinėje sistemoje, tai atliekama naudojant šį galinį tašką.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Šiuo iškvietimu dokumentas fiskalinėje sistemoje anuliuojamas, tačiau anuliavimas nėra perduodamas į „TicketBAI“ sistemą (dokumento „TicketBAI“ sistemoje dar nėra). Jei šis dokumentas bus pažymėtas kaip anuliuotas, jis nebebus grąžinamas kaip klaidingas per aukščiau nurodytą užklausą.

Dokumentas fiskalinėje sistemoje yra anuliuojamas – ne ištrinamas!

Dabar dokumentas gali būti dar kartą perduotas į fiskalinę sistemą su nauja dokumento antraštės informacija (dokumento numeris, DocumentGuid ir kt.) ir ištaisytomis duomenimis.