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

Ta končna točka ustvari novega klienta v fiskalnem middleware in ga poveže s terminalom v RetailForce Cloud. To predstavlja prvi korak pri zagonu nove blagajne.

Rezultati

Uspešen klic končne točke (200)

ustvari novega odjemalca v middlewareu, mu dodeli uniqueClientId terminala (Cloud) in
prenese konfiguracijski objekt iz Cloud sistema ter client ustrezno konfigurira.

Uporaba

Enkrat, ko se nova blagajna začne uporabljati. Ponovni klic končne točke za istega odjemalca (clientId) bo povzročil napako!

OPOZORILO : če je bil določen odjemalec že enkrat povezan s terminalom, ustvarjenim v oblaku (dodelitev uniqueClientId), bo ponovni klic končne točke povzročil pojav sporočila o napaki: »409 – Odjemalec že obstaja«. Če je treba odjemalca ustvariti na novo (npr. zaradi okvare trdega diska itd.), je treba uporabiti končno točko /api/v1/management/clients/recovery/restoreByCloud.

Predpogoji

Organizacijska struktura in konfiguracijski objekt sta bila ustvarjena v RetailForce Cloud in ustrezno dodeljena
Namestjena je rešitev Fiscal Middleware

Polja obrazca

Posredovati je treba naslednje podatke:

Naziv	Opis	Primer
Vrsta	Vrsta identifikacije podjetja. Vrsta mora biti vnesena in prisotna v RetailForce Cloud. Na voljo so naslednje vrste: [0] = VatNumber, [1] = taxNumber, [2] = GLN number, [3] = BusinessIdentificationNumber, [4] = statistična klasifikacija, [5] = številka iz trgovinskega registra, [6] = urad za vpis v trgovinski register, [7] = številka iz trgovinskega registra Glej tudi: Identifikacija podjetja Priporočamo, da v vseh državah (EU) kot primarni ID uporabite vrsto [0] = VatNumber, tudi če ta v zadevni državi ni obvezna identifikacija podjetja.	[0] = VatNumber
Identifikacija	Sama identifikacija podjetja. Mora se ujemati s podatki, vnesenimi v RetailForce Cloud.	ATU57780814
storeNumber	Številka podružnice/trgovine, v kateri se nahaja blagajna. Mora se ujemati s podatki, vnesenimi v RetailForce Cloud. OPOZORILO: v Franciji je treba tukaj navesti SIRET (razširitev SIREN z številko podružnice).	S001, 12345 itd.
terminalNumber	Številka blagajne. Mora se ujemati s podatki, vnesenimi v RetailForce Cloud.	0010
cloudApiKey	API ključ za avtentifikacijo komunikacije v oblaku	RFC_4a2abc...
cloudApiSecret	API Secret za avtentifikacijo komunikacije v oblaku	ypts7u5OU...

Odgovor

Možni odgovori:

Koda	Opis	Primer
200	The client was successfully created and configured. Kot odzivni objekt se vrne uniqueClientId. POS-sistem mora shraniti uniqueClientId in ga uporabljati za celoten nadaljnji komunikacijski proces (v zvezi s stranko).	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	V RetailForce Cloud ni bilo najdeno nobeno podjetje z navedenim ID podjetja. Odpravljanje težav: Preverite ID podjetja v RetailForce Cloud in na blagajni. Ustvarite podjetje (organizacijo ali podjetje) v RetailForce Cloud	-
406	Zaradi navedene vrste (identifikacijska številka podjetja) ni mogoča jasna dodelitev (npr. pri uporabi [6] = CommercialRegisterNumberOffice). Odpravljanje težav: Uporabite drugo vrsto ID številke (npr. [0] = VatNumber)	-
409	V storitvi Fiscal Service (Fiscal Middleware) že obstaja client z zadevno uniqueClientId. Odpravljanje težav: Uporabite obstoječega klienta	-

Ta članek je bil samodejno preveden.