In diesem Artikel lernen Sie, die Fehlerbehandlung in Spanien richtig umzusetzen.

Voraussetzungen

• FiskalClient ab der Version 1.6.6 / Spanien 1.0.5 für mit * gekennzeichnete Features
• FiskalClient ab der Version 1.5.0

Beschreibung

Das spanische TicketBai System stellt die Möglichkeit zur Verfügung die erstellten Belege sofort, aber auch später einzureichen. Beim Einreichen der Belege kann es zu Validierungsfehlern führen. 

Bei der synchronen Verarbeitung werden diese Validierungsfehler sofort an das Kassensystem zurückgemeldet. Bei verspäteter Übertragung (TicketBAI System war zum Zeitpunkt der Belegerstellung nicht verfügbar) müssen die Fehler aus dem Fiskalsystem ausgelesen werden und in Abhängigkeit der Fehlerursache muss das Problem entsprechend behandelt werden.

Synchrone Verarbeitung

Das TicketBAI System ist verfügbar und Belege können übertragen werden.

Voraussetzungen

• TicketBAI System ist verfügbar
• Es sind keine Dateien für die Übertragung vorhanden (von vorigen Unterbrechungen)

Der Beleg wird synchron an das TicketBAI System übertragen.  Wird der Beleg erfolgreich übertragen und es gibt keine Validierungsfehler wird das Ergebnis mit dem Status erfolgreich an das Kassensystem zurückgegeben.

Der Beleg ist im Fiskalsystem und in TicketBAI gespeichert und darf nicht noch einmal übertragen werden.

Fehlerursachen

TicketBAI System ist nun nicht mehr verfügbar

Der Beleg wird durch das Fiskalsystem gespeichert und für eine nächste Übertragung bereitgestellt. Es startet damit der asynchrone Prozess.

Der Beleg ist im Fiskalsystem gespeichert und wird später an TicketBAI übertragen. Er darf nicht noch einmal an das Fiskalsystem übertragen werden.

Validierungsfehler von TicketBAI

Der Beleg wird nicht im Fiskalsystem gespeichert und es wird eine Fehlermeldung an das Kassensystem über den ungültigen Beleg zurückgegeben.

Der Beleg muss noch einmal an das Fiskalsystem korrekt übertragen werden.

Asynchrone Verarbeitung

Das TicketBAI System oder die Verbindung dorthin ist nicht verfügbar.

Voraussetzungen

• FiskalClient ist verfügbar und funktionsbereit
• TicketBAI System ist nicht verfügbar oder die Verbindung zum TicketBAI System ist unterbrochen.

Die Belege werden vom Fiskalsystem übernommen, gespeichert und für die spätere Übertragung markiert.

Durch die asynchrone Verarbeitung können Validierungsfehler nicht unmittelbar an das Kassensystem zurückgegeben werden. Daher müssen die Fehlerzustände für diese Belege abgefragt werden. 

Alle asynchron übertragenen Belege sind im Fiskalsystem gespeichert und dürfen nicht mehr an das Fiskalsystem übertragen werden.

Abfrage der Fehlerinformation und Auflösung *

Diese Funktion steht ab der Version 1.6.5 des Fiskalclients zur Verfügung.

Die fehlgeschlagenen Übertragungen können am Fiskalsystem abgefragt werden.

Abfrage

Dazu gibt es folgenden Endpunkt um die Fehlerdateien abzurufen:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Der Endpunkt gibt die Fehlerinformationen und die Guids (DocumentGuid) der betroffenen Belege zurück. 

Der Parameter onlyAsync kann dazu verwendet werden nur Fehler die asynchron entstanden sind zurück zu bekommen.

Lösung

Um das Problem aufzulösen, muss der Beleg im Fiskalsystem storniert werden, dies erfolgt über folgenden Endpunkt.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Mit diesem Aufruf wird der Beleg im Fiskalsystem storniert, die Stornierung jedoch nicht an das TicketBAI System weitergeleitet (der Beleg ist im TicketBAI System noch nicht vorhanden). Wird dieser Beleg damit als storniert gekennzeichnet wird dieser auch nicht mehr über die Abfrage sh. oben als fehlerhaft zurückgegeben.

Der Beleg wird im Fiskalsystem storniert - nicht gelöscht!

Der Beleg kann nun nochmals mit neuen Belegkopfinformationen (Belegnummer, DocumentGuid, etc.) an das Fiskalsystem mit den korrigierten Daten übertragen werden.