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

Použite

POST /api/v1/management/clients/initialize

slúži na

inicializáciu fiskálnej jednotky (klienta),
akéhokoľvek požadovaného fiškálneho hardvéru (jednotka na vytváranie podpisov, technické bezpečnostné zariadenie, riadiaca jednotka, fiškálna tlačiareň/box atď.) a
na registráciu elektronického záznamového systému (pokladne) u daňových orgánov. (napr. proces registrácie na portáli FinanzOnline – Rakúsko)

Výsledok

V prípade úspešného spracovania (200)

sa príslušný daňový klient a
akýkoľvek potrebný fiškálny hardvér sa uvedú do prevádzky a nakonfigurujú a
(ak je to potrebné / dostupné v danej krajine) sa pokladňa zaregistruje u daňového úradu.

Použitie

Jednorazovo, v rámci uvedenia fiškálneho klienta do prevádzky.

Predpoklady

Nainštalovaný fiskálny middleware,
vytvorený a nakonfigurovaný fiškálny client, buď prostredníctvom
- PUT /api/v1/management/clients, alebo
- PUT /api/v1/management/clients/byCloud
úspešné vykonanie CloudConnect (len pre systémy pripojené k RetailForce Cloud).
Bol vytvorený počiatočný dokument; buď prostredníctvom GET /api/v1/transactions/document/{clientId}/start, alebo samotným nadradeným systémom.

Polia formulára

Na koncový bod sa musí odoslať počiatočný dokument.

Pri volaní GET /api/v1/transactions/document/{clientId}/start bol počiatočný dokument vrátený hostiteľskému systému ako odpoveď. Ten je teraz možné odoslať na koncový bod POST /api/v1/management/clients/initialize.

Alternatívne môže požadovaný počiatočný dokument vytvoriť samotný nadradený systém.

Odpovede

Možné odpovede:

Kód	Popis	Príklad
200	Počiatočný dokument bol úspešne a bez chýb odoslaný a uložený v documentStore. Okrem toho sa do nadradeného systému vráti odpoveď typu fiscalResponse. Táto odpoveď by mala byť uložená v denníku nadradeného systému na účely neskoršieho vyhľadania.	fiscalResponse
204	Počiatočný dokument bol úspešne a bez chýb odoslaný a uložený v documentStore. V niektorých krajinách sa po úspešnom spustení neodosiela žiadna odpoveď fiscalResponse.	-
422	Štartovací dokument nespĺňa požiadavky príslušnej krajiny alebo v ňom chýba clientId. Riešenie problémov: Vykonajte POST /api/v1/transactions/validateDocument alebo POST /api/v1/transactions/validateDocumentString pre podrobnejšiu analýzu chyby; Použite GET /api/v1/transactions/document/{clientId}/start na vytvorenie platného počiatočného dokumentu; zadajte príslušné clientId.	-
500	Chyba validácie v počiatočnom dokumente alebo clientId odoslané v počiatočnom dokumente sa nenachádza v ConfigStore. Riešenie problémov: Vykonajte POST /api/v1/transactions/validateDocument alebo POST /api/v1/transactions/validateDocumentString pre podrobnejšiu analýzu chyby; Použite GET /api/v1/transactions/document/{clientId}/start na vytvorenie platného počiatočného dokumentu; uistite sa, že clientId bol vytvorený aj v systéme (PUT /api/v1/management/clients alebo PUT /api/v1/management/clients/byCloud)	-

Tento článok bol preložený automaticky.

Výsledok

Použitie

Predpoklady

Polia formulára

Odpovede

Podobné články