PUT /api/v1/management/clients/ byCloud – RetailForce

Tento koncový bod vytvoří nového klienta ve fiskálním middlewaru a propojí ho s terminálem v RetailForce Cloud. Představuje první krok při uvedení nové pokladny do provozu.

Výsledky

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

vytvoří nového klienta v middlewaru, přiřadí mu identifikátor uniqueClientId terminálu (Cloud) a
stáhne konfigurační objekt z Cloud systému a klienta podle něj nakonfiguruje.

Použití

Jednou, při uvedení nové pokladny do provozu. Opakované volání koncového bodu pro stejného klienta (clientId) vyústí v chybu!

POZOR : pokud již byl konkrétní klient jednou připojen k terminálu vytvořenému v Cloudu (přiřazení uniqueClientId), bude opakované volání koncového bodu vyústit v chybovou zprávu: „409 – Klient již existuje“. Pokud je nutné klienta vytvořit znovu (např. v důsledku selhání pevného disku atd.), je nutné použít koncový bod /api/v1/management/clients/recovery/restoreByCloud.

Předpoklady

V RetailForce Cloud byly vytvořeny organizační struktura a konfigurační objekt a byly odpovídajícím způsobem přiřazeny
Nainstalován Fiscal Middleware

Pole formuláře

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

Označení	Popis	Příklad
Typ	Typ identifikace společnosti. Typ musí být také zadán a musí být přítomen v RetailForce Cloud. K dispozici jsou následující typy: [0] = DIČ, [1] = daňové číslo, [2] = GLN číslo, [3] = identifikační číslo podniku, [4] = statistická klasifikace, [5] = číslo v obchodním rejstříku, [6] = úřad vedoucí obchodní rejstřík, [7] = číslo v živnostenském rejstříku Viz také: Identifikace společnosti Doporučujeme používat typ [0] = DIČ jako primární identifikátor ve všech zemích (EU), i když není v dané zemi používán jako povinný identifikátor společnosti.	[0] = DIČ
Identifikace	Samotná identifikace společnosti. Musí odpovídat informacím zadaným v RetailForce Cloud.	ATU57780814
storeNumber	Číslo pobočky / prodejny, kde se pokladna nachází. Musí odpovídat údajům zadaným v RetailForce Cloud. POZOR: ve Francii je třeba zde uvést SIRET (rozšíření kódu SIREN o číslo pobočky).	S001, 12345 atd.
terminalNumber	Číslo pokladny. Musí odpovídat údajům zadaným v RetailForce Cloud.	0010
cloudApiKey	API klíč pro ověření komunikace s Cloudem	RFC_4a2abc...
cloudApiSecret	Tajný klíč API pro ověření komunikace s Cloudem	ypts7u5OU...

Odpověď

Možné odpovědi:

Kód	Popis	Příklad
200	Klient byl úspěšně vytvořen a nakonfigurován. Jako objekt odpovědi se vrací uniqueClientId. Hodnota uniqueClientId musí být uložena v POS systému a musí být tímto systémem používána po celou dobu další komunikace (týkající se daného klienta).	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	V RetailForce Cloud nebyla nalezena žádná organizace pro zadané ID společnosti. Řešení problémů: Zkontrolujte ID společnosti v RetailForce Cloud a na pokladně. Vytvořte společnost (organizaci nebo firmu) v RetailForce Cloud	-
406	Vzhledem k zadanému typu (kód společnosti) není možné provést jednoznačné přiřazení (např. při použití [6] = CommercialRegisterNumberOffice). Řešení problémů: Použijte jiný typ ID (např. [0] = DIČ)	-
409	Ve službě Fiscal Service (Fiscal Middleware) již existuje klient s příslušným jedinečným ID klienta (uniqueClientId). Řešení problému: Použijte existujícího klienta	-

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