У овом чланку ћете научити како правилно имплементирати руковање грешкама у Шпанији.

Предуслови

• FiscalClient од верзије 1.6.5 / Шпанија 1.0.5 за функције означене звездицом (*).
• FiscalClient од верзије 1.5.0

Опис

Шпански TicketBai систем омогућава слање генерисаних потврда одмах, али и касније. Приликом слања потврда могу настати грешке у валидацији. 

При синхроној обради, ове грешке у валидацији се одмах пријављују POS систему. У случају одложеног преноса (систем TicketBAI није био доступан у тренутку креирања потврде), грешке се морају прочитати из фискалног система и, у зависности од узрока грешке, проблем мора бити решен у складу с тим.

Синхроно обрађивање

Систем TicketBAI је доступан и потврде се могу пренети.

Предуслови

• Систем TicketBAI је доступан
• Нема датотека за пренос (из претходних прекида)

Потврда се синхроно преноси у TicketBAI систем. Ако је потврда успешно пренета и нема грешака при валидацији, резултат се враћа POS систему са статусом успешан.

Потврда се чува у фискалном систему и у TicketBAI и не сме се поново преносити.

Узроци грешака

Систем TicketBAI више није доступан

Потврда се сачува у фискалном систему и стави на располагање за следећу пренос. Ово покреће асинхрони процес.

Потврда се чува у фискалном систему и касније се преноси у TicketBAI. Не сме се поново преносити у фискални систем.

Грешка у валидацији из TicketBAI

Потврда није сачувана у фискалном систему и на ПОС систем се враћа порука о грешци због неважеће потврде.

Потврда мора поново бити исправно пренета у фискални систем.

Асинхроно обрађивање

Систем TicketBAI или веза са њим нису доступни.

Предуслови

• FiscalClient је доступан и спреман за рад
• Систем TicketBAI није доступан или је веза са системом TicketBAI прекинута.

Потврде преузима порески систем, чувају се и обележавају за каснији пренос.

Због асинхроне обраде, грешке у валидацији не могу бити враћене директно у ПОС систем. Стога је потребно упитати стања грешака за ове потврде.

Сви асинхроно пренети рачуни се чувају у фискалном систему и више не могу бити пренети у фискални систем.

Упит информација о грешкама и решењима *

Ова функција је доступна од верзије 1.6.5 фискалног клијента.

Неуспеле трансфере може се упитати у фискалном систему.

Упит

Постоји следећи ендпоинт за преузимање фајлова са грешкама:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Крајња тачка враћа информације о грешкама и ГУИД-ове (DocumentGuid) погођених докумената.

Параметар onlyAsync може да се користи за повраћај само грешака које су настале асинхроно.

Решење

Да би се решио проблем, документ мора бити поништен у фискалном систему, што се ради преко следећег ендпоинта.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Овим позивом потврда се поништава у фискалном систему, али поништење се не прослеђује у систем TicketBAI (потврда још не постоји у систему TicketBAI). Ако се ова потврда означи као поништена, она више неће бити враћена као неисправна преко горе наведеног упита.

Документ је поништен у фискалном систему - није избрисан!

Документ се сада може поново пренети у порески систем са новим информацијама у заглављу документа (број документа, DocumentGuid итд.) и исправљеним подацима. 

Овај чланак је аутоматски преведен.