W niniejszym artykule dowiedzą się Państwo, jak zamknąć otwartą transakcję TSE oraz jak ustalić, które transakcje TSE są nadal otwarte w systemie TSE.

Wymagania

• Tax client with tax country = Germany

Wyszukiwanie otwartych transakcji TSE

Zapytania kierowane do usługi REST

Żądanie do usługi REST jest wysyłane za pośrednictwem punktu końcowego:

GET /api/v1/management/germany/{clientId}/tse/listTransactions

Parametr: ClientId = ID klienta podatkowego (FiscalClient), dla którego mają zostać wyszukane transakcje TSE.

Wartość zwracana: Lista otwartych transakcji TSE w postaci wartości całkowitych.

Wartość całkowita odpowiada numerowi dokumentu podatkowego (FiscalDocumentNo) pierwotnej odpowiedzi podatkowej (fiscalResponse) wygenerowanej podczas korzystania z funkcji createDocument.

Zapytania w interfejsie .NET (nuget)

Warunek wstępny: Moduł fiskalny dla danego klienta jest dostępny jako zmienna „fiscalModule”.

Parametr: clientId = ID klienta podatkowego, dla którego mają zostać wyszukane transakcje TSE.

if (fiscalModule.ModulImplementation is TrustedFiscalModuleGermany)
{
  fiscalModuleGermany = (TrustedFiscalModuleGermany)fiscalModule.ModulImplementation;
  var resultList = fiscalModuleGermany.Tse.ListStartedTransactions(clientId);
}

Wartość zwracana: Lista otwartych transakcji TSE w postaci wartości całkowitych.

Wartość całkowita odpowiada numerowi dokumentu podatkowego (FiscalDocumentNo) pierwotnej odpowiedzi fiscalResponse wygenerowanej podczas korzystania z funkcji createDocument.

Zamykanie otwartych transakcji

Zamknięcie otwartych transakcji TSE odbywa się za pomocą metody storeDocument (w celu zamknięcia zakończonego dokumentu zgodnie ze standardową procedurą) lub metody cancelDocument (w celu anulowania otwartej transakcji).

Zamykanie za pomocą metody storeDocument nie jest omawiane w niniejszym artykule, ponieważ stanowi to część standardowego procesu. 

Jeśli transakcja kasowa ma zostać anulowana, należy to zrobić za pomocą metody cancelDocument. Spowoduje to również zamknięcie transakcji TSE.

Sposób anulowania paragonów za pomocą funkcji cancelDocument został szczegółowo opisany w poniższym artykule:

Wdrażanie anulowania paragonów

Jeśli dla transakcji, która jest nadal otwarta, nie ma już żadnych danych, do metody cancelDocument należy przesłać dokument zawierający co najmniej następujące informacje:

{
  "UniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
  "DocumentGuid": "5c374337-e093-4fb5-abf4-d1c48f0428b4",
  "DocumentId": "5c374337-e093-4fb5-abf4-d1c48f0428b4",
  "CreateDate": "2021-03-29T06:38:26.1392038+02:00",
  "BookDate": "2021-03-29T06:38:26.1392038+02:00",
  "IsTraining": false,
  "DocumentType": 0,
  "User": 
  {
    "Id": "123",
    "Caption": "TestUser"
  },
  "FiscalDocumentNumber": {Rückgabe von ListStartedTransactions},
  "FiscalDocumentRevision": 0,
}

Identyfikator clientId, wartości pól DocumentGuid/Id, BookDate/CreateDate oraz użytkownik w powyższym bloku kodu stanowią przykładowe dane.

Jeśli metoda listTransactions zwraca kilka numerów, należy kilkakrotnie wywołać metodę cancelDocument.

Ten artykuł został przetłumaczony automatycznie.