V tomto článku se dozvíte, jak správně implementovat zpracování chyb ve Španělsku.

Předpoklady

• FiscalClient od verze 1.6.5 / Španělsko 1.0.5 pro funkce označené hvězdičkou *.
• FiscalClient od verze 1.5.0

Popis

Španělský systém TicketBai nabízí možnost odeslat vygenerované účtenky okamžitě, ale i později. Při odesílání účtenek mohou nastat chyby při ověřování. 

Při synchronním zpracování jsou tyto chyby validace okamžitě nahlášeny zpět do pokladního systému. V případě zpožděného přenosu (systém TicketBAI nebyl v době vytvoření dokladu k dispozici) je nutné chyby načíst z fiskálního systému a v závislosti na příčině chyby problém odpovídajícím způsobem vyřešit.

Synchronní zpracování

Systém TicketBAI je dostupný a účtenky lze přenášet.

Předpoklady

• Systém TicketBAI je dostupný
• Nejsou k dispozici žádné soubory k přenosu (z předchozích přerušení)

Účtenka se synchronně přenáší do systému TicketBAI. Pokud je účtenka úspěšně přenesena a nevyskytly se žádné chyby při ověřování, je výsledek vrácen do pokladního systému se stavem „úspěšné“.

Účtenka je uložena ve fiskálním systému i v systému TicketBAI a nesmí být přenášena znovu.

Příčiny chyb

Systém TicketBAI již není k dispozici

Účtenka je uložena v fiskálním systému a připravena k dalšímu přenosu. Tím se spustí asynchronní proces.

Účtenka je uložena ve fiskálním systému a později přenesena do systému TicketBAI. Nesmí být znovu přenesena do fiskálního systému.

Chyba ověření ze strany TicketBAI

Účtenka není uložena ve fiskálním systému a do pokladního systému je vrácena chybová zpráva o neplatné účtence.

Účtenku je nutné znovu správně přenést do fiskálního systému.

Asynchronní zpracování

Systém TicketBAI nebo připojení k němu není k dispozici.

Předpoklady

• FiscalClient je k dispozici a připraven k provozu
• Systém TicketBAI není k dispozici nebo je přerušeno připojení k systému TicketBAI.

Účtenky jsou převzaty fiskálním systémem, uloženy a označeny pro pozdější přenos.

Vzhledem k asynchronnímu zpracování nelze chyby ověření vrátit přímo do pokladního systému. Proto je nutné dotazovat se na chybové stavy těchto dokladů.

Všechny asynchronně přenesené účtenky jsou uloženy ve fiskálním systému a již je nelze do fiskálního systému přenést.

Vyžádání informací o chybách a jejich řešení *

Tato funkce je k dispozici od verze 1.6.5 fiskálního klienta.

Neúspěšné přenosy lze dotazovat ve fiskálním systému.

Dotaz

K načtení chybových souborů slouží následující koncový bod:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Tento koncový bod vrací informace o chybách a identifikátory GUID (DocumentGuid) dotčených dokumentů.

Pomocí parametru onlyAsync lze získat pouze chyby, ke kterým došlo asynchronně.

Řešení

K vyřešení problému je nutné dokument ve fiskálním systému zrušit, což se provádí prostřednictvím následujícího koncového bodu.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Tímto voláním se účtenka zruší ve fiskálním systému, ale zrušení se nepředá do systému TicketBAI (účtenka v systému TicketBAI zatím neexistuje). Pokud bude tato účtenka označena jako zrušená, nebude již prostřednictvím výše uvedeného dotazu vrácena jako chybná.

Doklad je ve fiskálním systému zrušen – není smazán!

Dokument lze nyní znovu přenést s novými údaji v záhlaví (číslo dokumentu, DocumentGuid atd.) do fiskálního systému s opravenými údaji. 

Tento článek byl přeložen automaticky.