W niniejszym artykule dowiedzą się Państwo, jak prawidłowo wdrożyć obsługę błędów w Hiszpanii.

Wymagania wstępne

• FiscalClient w wersji 1.6.5 lub nowszej / Hiszpania 1.0.5 dla funkcji oznaczonych symbolem *.
• FiscalClient w wersji 1.5.0 lub nowszej

Opis

Hiszpański TicketBAI system umożliwia przesyłanie wygenerowanych paragonów zarówno natychmiast, jak i w późniejszym terminie. Podczas przesyłania paragonów mogą wystąpić błędy walidacji. 

W przypadku przetwarzania synchronicznego błędy walidacji są natychmiast zgłaszane z powrotem do systemu POS. W przypadku opóźnionej transmisji (TicketBAI system był niedostępny w momencie tworzenia paragonu) błędy należy odczytać z systemu fiskalnego i, w zależności od przyczyny błędu, odpowiednio rozwiązać problem.

Przetwarzanie synchroniczne

TicketBAI system jest dostępny i możliwe jest przesyłanie paragonów.

Warunki wstępne

• TicketBAI system jest dostępny
• Nie ma żadnych plików do przesłania (z poprzednich przerw w działaniu)

Paragon jest synchronicznie przesyłany do TicketBAI systemu. Jeśli przesyłanie paragonu zakończy się powodzeniem i nie wystąpią żadne błędy walidacji, wynik jest zwracany do systemu POS ze statusem „powodzenie”.

Paragon jest przechowywany w systemie fiskalnym oraz w TicketBAI i nie wolno go przesyłać ponownie.

Przyczyny błędów

TicketBAI system nie jest obecnie dostępny

Paragon jest zapisywany przez system fiskalny i udostępniany do następnej transmisji. Rozpoczyna to proces asynchroniczny.

Paragon jest przechowywany w systemie fiskalnym, a następnie przesyłany do TicketBAI systemu. Nie wolno go ponownie przesyłać do systemu fiskalnego.

Błąd walidacji z systemu TicketBAI

Paragon nie został zapisany w systemie fiskalnym, w związku z czym do systemu POS wysyłany jest komunikat o błędzie dotyczący nieprawidłowego paragonu.

Paragon należy ponownie poprawnie przesłać do systemu fiskalnego.

Przetwarzanie asynchroniczne

TicketBAI system lub połączenie z nim jest niedostępne.

Wymagania wstępne

• FiscalClient jest dostępny i gotowy do pracy
• TicketBAI system jest niedostępny lub połączenie z TicketBAI systemem zostało przerwane.

Paragony są przejmowane przez system fiskalny, zapisywane i oznaczane do późniejszego przesłania.

Ze względu na przetwarzanie asynchroniczne błędy walidacji nie mogą być zwracane bezpośrednio do systemu POS. W związku z tym należy sprawdzić stany błędów dla tych paragonów.

Wszystkie paragony przesłane asynchronicznie są przechowywane w systemie fiskalnym i nie mogą być już przesłane do systemu fiskalnego.

Sprawdzanie informacji o błędach i ich usuwanie *

Funkcja ta jest dostępna od wersji 1.6.5 klienta fiskalnego.

W systemie fiskalnym można sprawdzić nieudane transfery.

Zapytanie

Do pobrania plików błędów służy następujący punkt końcowy:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Punkt końcowy zwraca informacje o błędach oraz identyfikatory GUID (DocumentGuid) dokumentów, których dotyczy problem.

Za pomocą parametru onlyAsync można pobrać wyłącznie błędy, które wystąpiły w trybie asynchronicznym.

Rozwiązanie

Aby rozwiązać ten problem, należy anulować dokument w systemie podatkowym; można to zrobić za pomocą poniższego punktu końcowego.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Dzięki temu wywołaniu paragon zostaje anulowany w systemie fiskalnym, jednak informacja o anulowaniu nie jest przekazywana do TicketBAI systemu (paragon nie istnieje jeszcze w TicketBAI systemie). Jeśli paragon ten zostanie oznaczony jako anulowany, nie będzie już zwracany jako błędny w wyniku powyższego zapytania.

Dokument zostaje unieważniony w systemie fiskalnym – nie jest usuwany!

Dokument można teraz ponownie przesłać do systemu fiskalnego wraz z nowymi danymi nagłówkowymi (numer dokumentu, DocumentGuid itp.) oraz skorygowanymi danymi. 

Ten artykuł został przetłumaczony automatycznie.