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

Ez a végpont új client-t hoz létre a Fiscal Middleware-ben, és összekapcsolja azt egy terminállal a RetailForce Cloudban. Ez jelenti az első lépést egy új pénztárgép üzembe helyezésében.

Eredmények

A végpont sikeres meghívása (200)

új client-t hoz létre a middleware-ben, hozzárendeli hozzá a terminal (Cloud) uniqueClientId azonosítóját, és
letölti a konfigurációs objektumot a Cloud-rendszerből, és ennek megfelelően konfigurálja a clientet.

Használat

Egyszer, amikor egy új pénztárgépet üzembe helyeznek. Ugyanazon kliens (clientId) esetében az végpont ismételt meghívása hibát eredményez!

FIGYELEM : ha egy adott kliens már egyszer csatlakozott a felhőben létrehozott terminalhoz (uniqueClientId hozzárendelés), a végpont újbóli meghívása hibaüzenetet eredményez: „409 – A kliens már létezik”. Ha egy klienst újra kell létrehozni (pl. merevlemez-meghibásodás stb.), akkor a /api/v1/management/clients/recovery/restoreByCloud végpontot kell használni.

Előfeltételek

A szervezeti felépítés és a konfigurációs objektumok létrehozásra kerültek a RetailForce Cloudban, és megfelelően hozzárendelve lettek
A Fiscal middleware telepítve van

Űrlapmezők

A következő információkat kell megadni:

Megnevezés	Leírás	Példa
Típus	A vállalat azonosításának típusa. A típust be kell írni, és szerepelnie kell a RetailForce Cloud rendszerben. A következő típusok állnak rendelkezésre: [0] = VatNumber, [1] = taxNumber, [2] = GLN-szám, [3] = BusinessIdentificationNumber, [4] = Statisztikai besorolás, [5] = Kereskedelmi nyilvántartási szám, [6] = Kereskedelmi nyilvántartási hivatal, [7] = Kereskedelmi nyilvántartási szám Lásd még: Cégazonosító Javasoljuk, hogy minden országban (EU) a [0] = VatNumber típust használja elsődleges ID-ként, még akkor is, ha az adott országban ez nem kötelező vállalati ID.	[0] = VatNumber
Azonosító	Maga a vállalati azonosító. Meg kell egyeznie a RetailForce Cloudba bevitt adatokkal.	ATU57780814
storeNumber	A pénztárgép helye szerinti fiók/üzlet száma. Meg kell egyeznie a RetailForce Cloudba bevitt adatokkal. FIGYELEM: Franciaországban itt a SIRET-számot (a SIREN-szám fiókszámmal kiegészített változata) kell megadni.	S001, 12345 stb.
terminalNumber	Pénztárgép száma. Meg kell egyeznie a RetailForce Cloudba bevitt adatokkal.	0010
cloudApiKey	A Cloud-vel való kommunikáció hitelesítéséhez szükséges API-kulcs	RFC_4a2abc...
cloudApiSecret	A felhőalapú kommunikáció hitelesítéséhez szükséges API Secret	ypts7u5OU...

Válasz

Lehetséges válaszok:

Kód	Leírás	Példa
200	The client creation and configuration were successful. A válaszobjektumként a uniqueClientId kerül visszaadásra. Az uniqueClientId-t a POS-rendszernek el kell mentenie, és azt a POS-rendszernek a további teljes kommunikációs folyamat során (az ügyféllel kapcsolatban) használnia kell.	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	A RetailForce Cloudban nem található szervezet a megadott vállalati ID-hez. Hibaelhárítás: Ellenőrizze a vállalati ID-t a RetailForce Cloudban és a pénztárgépnél. Hozzon létre egy vállalatot (szervezetet vagy céget) a RetailForce Cloudban	-
406	A megadott típus (cégkód) miatt nem lehetséges egyértelmű hozzárendelés (pl. a [6] = Kereskedelmi Nyilvántartási Hivatal használata esetén). Hibaelhárítás: Használjon más ID típust (pl. [0] = VatNumber)	-
409	A Fiscal Service-ben (Fiscal Middleware) már létezik egy client a megadott uniqueClientId azonosítóval. Hibaelhárítás: Használja a meglévő clientet	-

Ezt a cikket automatikusan lefordították.