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

Ovaj krajnji punkt kreira novog klijenta u fiskalnom međusloju i povezuje ga s terminalom u RetailForce Cloudu. Predstavlja prvi korak u puštanju u rad novog blagajničkog uređaja / blagajne.

Rezultati

Uspješan poziv krajnje tačke (200)

kreira novog klijenta u middlewareu, dodjeljuje mu uniqueClientId terminala (cloud) i
preuzima konfiguracijski objekt iz cloud sistema i u skladu s tim konfiguriše klijenta.

Upotreba

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

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

Preduvjeti

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

Polja obrasca

Moraju se dostaviti sljedeće informacije:

Naznaka	Opis	Primjer
Tip	Tip identifikacije kompanije. Tip mora biti unesen i prisutan u RetailForce Cloudu. Sljedeće vrste su dostupne: [0] = Poreski broj (VatNumber), [1] = Poreski broj (TaxNumber), [2] = GML broj (GlnNumber), [3] = Poslovni identifikacijski broj (BusinessIdentificationNumber), [4] = Statistička klasifikacija (Statistical classification), [5] = Broj iz trgovačkog registra (CommercialRegisterNumber), [6] = Broj iz trgovačkog registra (CommercialRegisterNumberOffice), [7] = Broj iz registra obrtnika (TradeRegisterNumber) Pogledajte također: Identifikacija kompanije 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 kompanije u dotičnoj zemlji.	[0] = PDV broj
Identifikacija	Sam identifikacijski broj kompanije. Mora odgovarati informacijama unesenim u RetailForce Cloud.	ATU57780814
brojprodavnice	Broj poslovnice / prodavnice u kojoj se nalazi kasa. Mora odgovarati informacijama unesenim u RetailForce Cloud. PAŽNJA: u Francuskoj se ovdje mora navesti SIRET broj (proširenje SIREN broja brojem poslovnice).	S001, 12345 itd.
broj terminala	Broj blagajne. Mora odgovarati informacijama unesenim u RetailForce Cloud.	0010
cloudApiKey	API ključ za autentifikaciju cloud komunikacije	RFC_4a2abc...
cloudApiSecret	API tajna za autentifikaciju oblačne komunikacije	ypts7u5OU...

Odgovor

Mogući odgovori:

Kod	Opis	Primjer
200	Klijent je uspješno kreiran i konfigurisan. uniqueClientId se vraća kao objekt odgovora. uniqueClientId mora biti sačuvan u POS sistemu i korišten u POS sistemu tokom cijelog daljeg procesa komunikacije (u vezi s klijentom).	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	Nije pronađena nijedna organizacija u RetailForce Cloudu za navedeni ID kompanije. Rješavanje problema: Provjerite ID kompanije u RetailForce Cloudu i na kasi. Kreirajte kompaniju (organizaciju ili kompaniju) u RetailForce Cloudu	-
406	Zbog navedenog tipa (šifra kompanije) nije moguća jasna dodjela (npr. pri korištenju [6] = CommercialRegisterNumberOffice). Otklanjanje poteškoća: Koristite drugačiji tip ID-a (npr. [0] = Poreski broj)	-
409	Već postoji klijent sa relevantnim uniqueClientId u Fiskalnoj službi (Fiskalni middleware). Rješavanje problema: Koristite postojećeg klijenta	-

Ovaj članak je automatski preveden.