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

Ova krajnja točka stvara novog klijenta u fiskalnom međusloju i povezuje ga s terminalom u RetailForce Cloudu. Predstavlja prvi korak u puštanju u rad novog blagajnog terminala.

Rezultati

Uspješan poziv krajnje točke (200)

stvara novog klijenta u posredničkom sloju, dodjeljuje mu jedinstveni identifikator terminala (cloud) i
preuzima konfiguracijski objekt iz sustava u oblaku i u skladu s tim konfigurira klijenta.

Upotreba

Jednom, kada se nova blagajna pušta u rad. Ponovno pozivanje krajnje točke za istog klijenta (clientId) rezultirat će pogreškom!

PAŽNJA : ako je određeni klijent već jednom povezan s terminalom stvorenim u oblaku (dodjela uniqueClientId), ponovno pozivanje krajnje točke rezultirat će porukom o pogrešci: "409 - Klijent već postoji"). Ako klijent treba ponovno stvoriti (npr. zbog kvara tvrdog diska itd.), mora se koristiti krajnja točka /api/v1/management/clients/recovery/restoreByCloud.

Preduvjeti

Organizacijska struktura i konfiguracijski objekt stvoreni su u RetailForce Cloudu i dodijeljeni u skladu s tim
Instaliran fiskalni middleware

Oblasti obrasca

Moraju se dostaviti sljedeće informacije:

Naznaka	Opis	Primjer
Vrsta	Vrsta identifikacije tvrtke. Vrsta mora biti unijeta i prisutna u RetailForce Cloudu. Sljedeće vrste su dostupne: [0] = PDV-broj, [1] = Porezni broj, [2] = Gln-broj, [3] = Poslovni identifikacijski broj, [4] = Statistička klasifikacija, [5] = Broj iz trgovačkog registra, [6] = Broj iz trgovačkog registra – ured, [7] = Broj iz obrtnog registra Vidi također: Identifikacija tvrtke Preporučujemo korištenje tipa [0] = VatNumber kao primarnog ID-a u svim zemljama (EU), čak i ako se on ne koristi kao obavezni identifikator tvrtke u dotičnoj zemlji.	[0] = PDV-broj
Identifikacija	Sam identifikacijski broj tvrtke. Mora odgovarati informacijama unesenima u RetailForce Cloud.	ATU57780814
brojtrgovine	Broj podružnice / trgovine u kojoj se nalazi blagajna. Mora odgovarati informacijama unesenima u RetailForce Cloud. PAŽNJA: u Francuskoj se ovdje mora navesti SIRET (proširenje SIREN-a brojem podružnice).	S001, 12345 itd.
broj terminala	Broj blagajne. Mora odgovarati informacijama unesenim u RetailForce Cloud.	0010
cloudApiKey	API ključ za autentifikaciju komunikacije u oblaku	RFC_4a2abc...
cloudApiSecret	API tajna za autentifikaciju komunikacije u oblaku	ypts7u5OU...

Odgovor

Mogući odgovori:

Kod	Opis	Primjer
200	Klijent je uspješno stvoren i konfiguriran. uniqueClientId se vraća kao objekt odgovora. uniqueClientId mora biti pohranjen u POS sustavu i korišten u POS sustavu tijekom cijelog daljnjeg procesa komunikacije (u vezi s klijentom).	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	Nije pronađena nijedna organizacija u RetailForce Cloudu za navedeni ID tvrtke. Rješavanje problema: Provjerite ID tvrtke u RetailForce Cloudu i na blagajni. Kreira tvrtku (organizaciju ili tvrtku) u RetailForce Cloudu	-
406	Zbog navedenog tipa (šifra tvrtke) nije moguća jasna dodjela (npr. pri korištenju [6] = CommercialRegisterNumberOffice). Rješavanje problema: Koristite drugačiju vrstu ID-a (npr. [0] = broj PDV-a)	-
409	Već postoji klijent s relevantnim uniqueClientId u Poreznoj službi (Fiscal Middleware). Rješavanje problema: Koristite postojećeg klijenta	-

Ovaj je članak automatski preveden.