GET /api/v1/transactions/document/ {clientId}/start – RetailForce

Korzystanie z punktu końcowego

GET /api/v1/transactions/document/{clientId}/start,

usługa fiskalna generuje tzw. dokument startowy (dokument początkowy) i zwraca go do systemu nadrzędnego.

Dokumenty początkowe są dokumentami specyficznymi dla danego kraju, służącymi do zainicjowania (uruchomienia) jednostki fiskalnej.

W niektórych krajach taki dokument początkowy jest wymagany przez prawo, jak pokazano w poniższej tabeli.

Kraj	Nazwa	DocumentType
Austria	„Startbeleg” – pokwitowanie początkowe	[1000] = NullReceipt
Litwa	raport początkowy (Z)	[99] = EndOfDay

Wywołanie GET /api/v1/transactions/document/{clientId}/start zawsze generuje dokument początkowy wymagany w danym kraju.

Ważne: Zgodnie ze standardowym interfejsem inicjalizacja klienta fiskalnego zawsze odbywa się zgodnie z procesem opisanym w artykule, do którego prowadzi link. W związku z tym do urzędu skarbowego w każdym kraju należy przesłać dokument początkowy.

Uwaga: alternatywnie do korzystania z punktu końcowego GET /api/v1/transactions/document/{clientId}/start odpowiedni dokument początkowy może zostać wygenerowany również przez sam system nadrzędny (elektroniczny system rejestracji).

Wynik

W przypadku pomyślnego przetworzenia (200) dany klient podatkowy zwraca dokument początkowy do systemu nadrzędnego.

Zastosowanie

Jednorazowo, w ramach uruchomienia klienta podatkowego.

Wymagania wstępne

Zainstalowane oprogramowanie Fiscal Middleware,
utworzony i skonfigurowany client fiskalny, za pomocą polecenia
- PUT /api/v1/management/clients, albo
- PUT /api/v1/management/clients/byCloud
pomyślne wykonanie polecenia CloudConnect (dotyczy wyłącznie systemów podłączonych do RetailForce Cloud).

Pola formularza

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

Nazwa	Opis	Przykład
clientId	Unikalny identyfikator klienta (uniqueClientId) kasy fiskalnej (z RetailForce systemu).	c1062c55-57c4-4ed2-9c53-aff1762326a4
BookDate	Opcjonalnie: data księgowania dokumentu początkowego	2023-05-19T10:30:04.297Z

Odpowiedź

Możliwe odpowiedzi:

Kod	Opis	Przykład
200	Dokument początkowy dla danego kraju	-

Ten artykuł został przetłumaczony automatycznie.