PUT /api/v1/transactions/createDocument – RetailForce

Tento koncový bod představuje první krok při přenosu transakcí z elektronického záznamového systému („pokladny“) do daňové správy. Proces se vždy skládá ze dvou kroků. Tento dvoustupňový proces přenosu transakcí vychází z požadavků německé vyhlášky o ochraně pokladních systémů proti neoprávněné manipulaci a musí být prováděn ve všech zemích s daňovým systémem ve smyslu standardizovaného rozhraní. V Německu se při volání PUT /api/v1/transactions/createDocument zaregistruje transakce v tzv. technickém bezpečnostním zařízení (TSE/TSS).

Registrace transakce

Transakce/dokument se registruje ve fiskální jednotce:

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

Zrušení transakce

Tím se zaregistruje ukončení transakce ve fiskální jednotce:

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

Poznámka: všechny transakce zahájené příkazem PUT /api/v1/transactions/createDocument musí být uzavřeny buď příkazem POST /api/v1/transactions/storeDocument, nebo příkazem POST /api/v1/transactions/cancelDocument! Vezměte prosím na vědomí funkci listTransactions (DELETE).

Výsledek

Úspěšné volání koncového bodu (200)

zaznamená zahájení transakce ve fiskální jednotce a
vrací fiskální odpověď (fiscalResponse) do nadřazeného systému (systému elektronických záznamů).

Použití

pokaždé, když má být do fiskální jednotky odeslána nová transakce, před voláním POST /api/v1/transactions/storeDocument nebo POST /api/v1/transactions/cancelDocument.

Předpoklady

Inicializovaný klient Fiskal

Pole formuláře

Je nutné odeslat následující informace:

Označení	Typ	Popis	Příklad
clientId	M	Jedinečné ID pokladny (z systému RetailForce).	c1062c55-57c4-4ed2-9c53-aff1762326a4
documentType	M	Typ dokumentu, který má být zaregistrován. Výčet: [0] = Stvrzenka [1] = Faktura [2] = Dodací list [10] = Výplatní doklad [11] = Vklad [12] = Proforma faktura [13] = Objednávka zákazníka [14] = Předběžná účtenka [80] = Dlouhodobá objednávka [90] = Počáteční zůstatek [98] = Hotovostní šek [99] = Konec dne [100] = Skladové zásoby [101] = Nákup [1000] = Neplatná účtenka [1100] = Různé nefiskální	-
documentGuid	R	GUID/UUID přiřazený transakci systémem POS. Chování „documentGuid“ zahrnutého v požadavku: Zadání „documentGuid“ činí volání idempotentním. Funkci createDocument lze volat vícekrát, aniž by se v TSE (Technical Security Device Germany) spustila nová transakce. „fiscalResponse“: vždy se vrátí STEJNÁ odpověď. Chování BEZ „documentGuid“ v požadavku: Pokud není zadán „documentGuid“, spustí se v TSE (Německo) při KAŽDÉM volání funkce createDocument nová transakce! „fiscalResponse“: pokaždé je vrácena NOVÁ odpověď. Poznámka: Stejný „documentGuid“ musí být použit i v následujícím volání POST /api/v1/transactions/storeDocument.	b5744d8c-71ec-4ea0-a340-53070da8b5a1

Odpověď

Možné odpovědi:

Kód	Popis	Příklad
200	Transakce byla zahájena a do nadřazeného systému byla vrácena odpověď typu fiscalResponse	-

Tento článek byl přeložen automaticky.

Výsledek

Použití

Předpoklady

Pole formuláře

Odpověď

Související články