В тази статия ще научите как правилно да приложите обработката на грешки в Испания.

Предварителни изисквания

• FiscalClient, версия 1.6.5 / Spain 1.0.5 за функциите, отбелязани с *.
• FiscalClient от версия 1.5.0

Описание

The TicketBAI system provides the possibility for immediate, but also for later submission of generated cash receipts. When submitting the cash receipts, validation errors may occur. 

При синхронна обработка тези грешки при валидирането се съобщават незабавно обратно на POS системата. В случай на забавено предаване (TicketBAI system не е била достъпна в момента на създаване на касовата бележка), грешките трябва да бъдат изчетени от фискалната система и, в зависимост от причината за грешката, проблемът трябва да бъде разрешен по съответния начин.

Синхронна обработка

The TicketBAI system is available and the cash receipts can be transferred.

Предпоставки

• The TicketBAI system is available
• Няма файлове за прехвърляне (от предишни прекъсвания)

Касовият бон се прехвърля синхронно към TicketBAI system. Ако касовият бон е прехвърлен успешно и няма грешки при валидирането, резултатът се връща към POS системата със статус „успешно“.

Касовият бон се съхранява във фискалната система и в TicketBAI и не трябва да се прехвърля отново.

Причини за грешки

The TicketBAI system is now not available

Касовият бон се запазва от фискалната система и се подготвя за следващото предаване. Това стартира асинхронния процес.

Касовият бон се съхранява във фискалната система и по-късно се прехвърля към TicketBAI. Той не трябва да се прехвърля отново във фискалната система.

Грешка при валидиране от TicketBAI

Касовият бон не е запазен във фискалната система и към POS системата се връща съобщение за грешка относно невалиден касов бон.

Касовият бон трябва да бъде прехвърлен отново правилно във фискалната система.

Асинхронна обработка

The TicketBAI system or the connection to it are not available.

Предпоставки

• FiscalClient е достъпен и готов за работа
• TicketBAI system не е достъпна или връзката с нея е прекъсната.

Касовите бележки се поемат от фискалната система, съхраняват се и се маркират за по-късно прехвърляне.

Поради асинхронната обработка грешките при валидирането не могат да бъдат върнати директно към POS системата. Поради това състоянията на грешките за тези касови бележки трябва да бъдат проверени.

Всички асинхронно предадени касови бележки се съхраняват във фискалната система и вече не могат да бъдат предадени към нея.

Запитване на информация за грешки и разрешаване *

Тази функция е достъпна от версия 1.6.5 на фискалния клиент.

Неуспешните прехвърляния могат да бъдат проверени във фискалната система.

Заявка

Има следния ендпойнт за извличане на файловете с грешки:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Крайната точка връща информацията за грешките и GUID-овете (DocumentGuid) на засегнатите документи.

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

Решение

За да се разреши проблемът, документът трябва да бъде анулиран във фискалната система, което се извършва чрез следния ендпойнт.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

С това извикване касовият бон се анулира във фискалната система, но анулирането не се препраща към TicketBAI system (касовият бон все още не съществува в TicketBAI system). Ако този касов бон бъде маркиран като анулиран, той вече няма да се връща като грешен чрез горното запитване.

Документът се анулира във фискалната система – не се изтрива!

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

Тази статия е преведена автоматично.