DELETE /api/v1/management/germany/ {clientId}/TSE/listTransactions

Polecenie

• DELETE /api/v1/management/germany/{clientId}/TSE/listTransactions

służy do zamykania otwartych transakcji TSE.

Zasadniczo transakcje nie powinny pozostawać otwarte. Zalecamy zamknięcie wszystkich otwartych transakcji przed codziennym zamknięciem za pomocą

• POST /api/v1/transactions/storeDocument – jeśli miała miejsce sprzedaż, albo
• POST /api/v1/transactions/cancelDocument – jeśli sprzedaż nie miała miejsca.

Wynik

Otwarte transakcje w systemie TSE są zamykane zbiorczo za pomocą polecenia POST /api/v1/transactions/cancelDocument, bez konieczności zamykania ich pojedynczo.

Zastosowanie

Zalecamy ostrożne korzystanie z tego punktu końcowego i stosowanie go wyłącznie w przypadku wystąpienia błędu.

Wywołanie to najpierw generuje zapytanie do TSE dotyczące tego, które transakcje są otwarte. Różne typy TSE (Cloud TSE, hardware TSE) nie zwracają pełnej listy otwartych transakcji, a jedynie „pakiet po pakiecie”:

• SWISSBIT HARDWARE TSE: po 8 transakcji,
• fiskal Cloud TSE: po 100 transakcji

Po zwróceniu przez TSE pakietu otwartych transakcji zawarte w nim transakcje są zamykane za pomocą pustego dokumentu zawierającego następujące informacje:

• DocumentId: identyfikator GUID wygenerowany przez usługę
• DocumentNr: identyfikator GUID wygenerowany przez usługę
• DocumentGuid: identyfikator GUID wygenerowany przez serwis
• DocumentType: Potwierdzenie
• documentTypeCaption: CancelTransaction

Jeśli otwartych jest więcej transakcji niż wymieniono powyżej, należy wywołać punkt końcowy więcej niż jeden raz.

Wszystkie zamknięte transakcje są również odpowiednio zapisywane w danych DSFinV-K.

Warunki wstępne

• Na giełdzie TSE istnieją otwarte (rozpoczęte), tj. niezamknięte, transakcje.

W przypadku osiągnięcia określonej liczby otwartych transakcji nie można rozpocząć kolejnych transakcji na giełdzie TSE, a giełda zgłasza błąd. Więcej informacji na ten temat można znaleźć w artykule „Błąd połączenia z giełdą TSE”.

Liczbę otwartych transakcji można uzyskać za pośrednictwem punktu końcowego:

• GET /api/v1/management/germany/{clientId}/TSE/listTransactions

Przykład:

TSE zwraca liczbę rozpoczętych transakcji w polu „startedTransactions”.

{
   ...
   "startedTransactions": 512,
   "maxStartedTransactions": 512,
   ...
}

Pola formularza

Należy przekazać następujące informacje:

Odpowiedzi

Możliwe odpowiedzi:

Ten artykuł został przetłumaczony automatycznie.