PUT /api/v1/transactions/createDocument – RetailForce

Ten punkt końcowy stanowi pierwszy etap przekazywania transakcji z elektronicznego systemu rejestracji („kasa fiskalna”) do Urzędu Skarbowego. Proces ten zawsze składa się z dwóch etapów. Ten dwuetapowy proces przekazywania transakcji opiera się na wymogach niemieckiego rozporządzenia w sprawie zabezpieczenia kas fiskalnych przed manipulacją i musi być realizowany we wszystkich krajach objętych przepisami fiskalnymi w ramach ujednoliconego interfejsu. W Niemczech, po wywołaniu metody PUT /api/v1/transactions/createDocument, transakcja jest rejestrowana w tzw. technicznym urządzeniu zabezpieczającym (TSE/TSS).

Rejestracja transakcji

Transakcja/dokument jest rejestrowany w urządzeniu fiskalnym:

PUT /api/v1/transactions/createDocument oraz
POST /api/v1/transactions/storeDocument

Przerwanie transakcji

Powoduje to zarejestrowanie zakończenia transakcji w jednostce podatkowej:

PUT /api/v1/transactions/createDocument oraz
POST /api/v1/transactions/cancelDocument

Uwaga: wszystkie transakcje rozpoczęte za pomocą PUT /api/v1/transactions/createDocument muszą zostać zamknięte za pomocą POST /api/v1/transactions/storeDocument lub POST /api/v1/transactions/cancelDocument! Proszę zwrócić uwagę na listTransactions (DELETE).

Wynik

Pomyślne wywołanie punktu końcowego (200)

rejestruje rozpoczęcie transakcji w jednostce fiskalnej oraz
zwraca obiekt fiscalResponse do systemu nadrzędnego (systemu e-dokumentacji).

Sposób użycia

za każdym razem, gdy nowa transakcja ma zostać wysłana do jednostki fiskalnej, przed wykonaniem żądania POST /api/v1/transactions/storeDocument lub POST /api/v1/transactions/cancelDocument.

Wymagania wstępne

Zainicjowany client Fiskal

Pola formularza

Należy przesłać następujące informacje:

Nazwa	Typ	Opis	Przykład
clientId	M	Unikalny identyfikator klienta (uniqueClientId) kasy fiskalnej (z RetailForce systemu).	c1062c55-57c4-4ed2-9c53-aff1762326a4
documentType	M	Typ dokumentu, który ma zostać zarejestrowany. Enum: [0] = Paragon [1] = Faktura [2] = List przewozowy [10] = Wypłata [11] = PayIn [12] = Faktura proforma [13] = Zamówienie klienta [14] = PreliminaryReceipt [80] = LongTermOrder [90] = OpeningBalance [98] = CashCheck [99] = EndOfDay [100] = Zapasy [101] = Zakup [1000] = Paragon zerowy [1100] = Różne dokumenty niefiskalne	-
DocumentGuid	R	Identyfikator GUID/UUID przypisany do transakcji przez system POS. Zachowanie pola „DocumentGuid” zawartego w żądaniu: Określenie „DocumentGuid” sprawia, że wywołanie staje się idempotentne. Funkcję createDocument można wywołać wielokrotnie bez rozpoczynania nowej transakcji w TSE (Technical Security Device Germany). „fiscalResponse”: zawsze zwracana jest TA SAMA odpowiedź. Zachowanie BEZ pola „DocumentGuid” w żądaniu: Jeśli nie podano parametru „DocumentGuid”, przy KAŻDYM wywołaniu funkcji createDocument uruchamiana jest nowa transakcja w TSE (Niemcy)! „fiscalResponse”: za każdym razem zwracana jest NOWA odpowiedź. Uwaga: Ten sam identyfikator „DocumentGuid” należy również użyć w kolejnym wywołaniu metody POST /api/v1/transactions/storeDocument.	b5744d8c-71ec-4ea0-a340-53070da8b5a1

Odpowiedź

Możliwe odpowiedzi:

Kod	Opis	Przykład
200	Transakcja została rozpoczęta, a do systemu nadrzędnego zwrócono odpowiedź typu fiscalResponse	-

Ten artykuł został przetłumaczony automatycznie.

Wynik

Sposób użycia

Wymagania wstępne

Pola formularza

Odpowiedź

Powiązane artykuły