POST /api/v1/management/clients/ initialize – RetailForce

Použijte

POST /api/v1/management/clients/initialize

slouží k

inicializaci fiskální jednotky (klienta),
veškerého požadovaného fiskálního hardwaru (jednotka pro vytváření podpisů, technické bezpečnostní zařízení, řídicí jednotka, fiskální tiskárna/skříňka atd.) a
k registraci elektronického záznamového systému (pokladny) u daňových úřadů. (např. registrační proces na portálu FinanzOnline – Rakousko)

Výsledek

V případě úspěšného zpracování (200)

se uvedou do provozu a nakonfigurují příslušný fiskální klient a
případné požadované fiskální hardwarové vybavení jsou uvedeny do provozu a nakonfigurovány a
(je-li to nutné / dostupné v dané zemi) je pokladna zaregistrována u daňového úřadu.

Použití

Jednorázově, v rámci uvedení fiskálního klienta do provozu.

Předpoklady

Nainstalovaný fiskální middleware,
vytvořený a nakonfigurovaný fiskální klient, a to buď prostřednictvím
- PUT /api/v1/management/clients, nebo
- PUT /api/v1/management/clients/byCloud
úspěšné provedení příkazu cloudConnect (pouze pro systémy připojené k RetailForce Cloud).
Byl vytvořen počáteční dokument; buď pomocí GET /api/v1/transactions/document/{clientId}/start, nebo samotným nadřazeným systémem.

Pole formuláře

Na koncový bod musí být odeslán počáteční dokument.

Při volání GET /api/v1/transactions/document/{clientId}/start byl hostitelskému systému jako odpověď vrácen počáteční dokument. Ten lze nyní odeslat na koncový bod POST /api/v1/management/clients/initialize.

Alternativně může požadovaný počáteční dokument vytvořit samotný nadřazený systém.

Odpovědi

Možné odpovědi:

Kód	Popis	Příklad
200	Počáteční dokument byl úspěšně a bez chyb odeslán a uložen v documentStore. Dále je do nadřazeného systému vrácena fiskální odpověď (fiscalResponse). Ta by měla být uložena v deníku nadřazeného systému pro referenční účely.	fiscalResponse
204	Úvodní dokument byl úspěšně a bez chyb odeslán a uložen v úložišti dokumentů. V některých zemích se po úspěšném uvedení do provozu neodesílá žádná fiscalResponse.	-
422	Úvodní dokument neodpovídá požadavkům dané země nebo v úvodním dokumentu chybí ClientId. Řešení problémů: Pro podrobnější analýzu chyby proveďte POST /api/v1/transactions/validateDocument nebo POST /api/v1/transactions/validateDocumentString ; k vytvoření platného startovacího dokumentu použijte GET /api/v1/transactions/document/{clientId}/start; zadejte příslušné clientId.	-
500	Chyba ověření v počátečním dokumentu nebo clientId přenesené v počátečním dokumentu nebylo nalezeno v ConfigStore. Řešení problémů: Pro podrobnější analýzu chyby proveďte příkaz POST /api/v1/transactions/validateDocument nebo POST /api/v1/transactions/validateDocumentString ; Použijte GET /api/v1/transactions/document/{clientId}/start k vytvoření platného počátečního dokumentu; ujistěte se, že bylo clientId také vytvořeno v systému (PUT /api/v1/management/clients nebo PUT /api/v1/management/clients/byCloud)	-

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

Výsledek

Použití

Předpoklady

Pole formuláře

Odpovědi

Související články