V tomto článku sa dozviete, ako správne implementovať spracovanie chýb v Španielsku.

Predpoklady

• FiscalClient vo verzii 1.6.5 / Španielsko 1.0.5 pre funkcie označené znakom *.
• FiscalClient od verzie 1.5.0

Popis

The Spanish TicketBAI system offers the possibility to send generated sales receipts immediately, but also later. When sending the receipts, validation errors may occur. 

Pri synchronnom spracovaní sa tieto chyby validácie okamžite nahlásia späť do POS systému. V prípade oneskoreného odoslania (TicketBAI system nebol k dispozícii v čase vytvorenia dokladu) je potrebné chyby vyčítať z daňového systému a v závislosti od príčiny chyby problém zodpovedajúcim spôsobom vyriešiť.

Synchrónne spracovanie

The TicketBAI system is available and receipts can be sent.

Predpoklady

• TicketBAI system je dostupný
• Neexistujú žiadne súbory na odoslanie (z predchádzajúcich prerušení)

Účtenka sa synchronne prenáša do TicketBAI systemu. Ak sa účtenka úspešne prenesie a nevyskytnú sa žiadne chyby pri overovaní, výsledok sa vráti do POS systému so stavom „úspešné“.

Účtenka je uložená vo fiskálnom systéme a v systéme TicketBAI a nesmie sa prenášať znovu.

Príčiny chýb

TicketBAI system už nie je k dispozícii

Účtenka je uložená vo fiskálnom systéme a je k dispozícii na ďalší prenos. Tým sa spustí asynchrónny proces.

Účtenka je uložená vo fiskálnom systéme a neskôr sa prenesie do TicketBAI. Nesmie sa opätovne prenášať do fiskálneho systému.

Chyba overenia zo systému TicketBAI

Účtenka nie je uložená vo fiskálnom systéme a do POS systému sa vráti chybová správa o neplatnej účtenke.

Účtenka musí byť opäť správne prenesená do fiskálneho systému.

Asynchrónne spracovanie

TicketBAI system alebo pripojenie k nemu nie je k dispozícii.

Predpoklady

• Systém FiscalClient je dostupný a pripravený na prevádzku
• TicketBAI system nie je k dispozícii alebo je prerušené pripojenie k TicketBAI systemu.

Účtenky sú prevzaté do daňového systému, uložené a označené na neskorší prenos.

V dôsledku asynchrónneho spracovania nie je možné chyby validácie vrátiť priamo do POS systému. Preto je potrebné zistiť stav chýb týchto dokladov.

Všetky asynchrónne odoslané doklady sú uložené vo fiskálnom systéme a už nemôžu byť odoslané do fiskálneho systému.

Vyžiadanie informácií o chybách a ich riešenie *

Táto funkcia je k dispozícii od verzie 1.6.5 fiškálneho klienta.

Neúspešné prenosy je možné vyhľadať vo fiskálnom systéme.

Vyhľadávanie

Na získanie súborov s chybami je k dispozícii nasledujúci koncový bod:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Tento koncový bod vráti informácie o chybách a identifikátory GUID (DocumentGuid) dotknutých dokumentov.

Pomocou parametra onlyAsync je možné získať iba chyby, ktoré nastali asynchrónne.

Riešenie

Na vyriešenie problému je potrebné dokument zrušiť vo finančnom systéme, čo sa vykonáva prostredníctvom nasledujúceho koncového bodu.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Týmto volaním sa doklad zruší vo fiskálnom systéme, ale zrušenie sa neprepošle do TicketBAI systemu (doklad v TicketBAI systeme ešte neexistuje). Ak sa tento doklad označí ako zrušený, už sa nebude vrátiť ako chybný prostredníctvom vyššie uvedeného dotazu.

Dokument je v daňovom systéme zrušený – nie je vymazaný!

Dokument je teraz možné opäť odoslať s novými informáciami v hlavičke dokumentu (číslo dokumentu, DocumentGuid atď.) do daňového systému s opravenými údajmi. 

Tento článok bol preložený automaticky.