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

Acest punct final creează un client nou în Fiscal Middleware și îl asociază cu un terminal din RetailForce Cloud. Acesta reprezintă primul pas în punerea în funcțiune a unei noi case de marcat.

Rezultate

O apelare reușită a punctului de capăt (200)

creează un client nou în middleware, îi atribuie uniqueClientId-ul terminalului (Cloud) și
descărcă obiectul de configurare din sistemul Cloud și configurează clientul în consecință.

Utilizare

O singură dată, atunci când se pune în funcțiune o nouă casă de marcat. Apelarea din nou a punctului final pentru același client (clientId) va genera o eroare!

ATENȚIE : dacă un anumit client a fost deja conectat o dată la terminalul creat în cloud (atribuirea uniqueClientId), apelarea din nou a punctului final va genera un mesaj de eroare: „409 – Clientul există deja”. Dacă un client trebuie creat din nou (de exemplu, în cazul unei defecțiuni a hard disk-ului etc.), trebuie utilizat punctul final /api/v1/management/clients/recovery/restoreByCloud.

Condiții prealabile

Structura organizațională și obiectul de configurare au fost create în RetailForce Cloud și atribuite corespunzător
Middleware-ul fiscal a fost instalat

Câmpuri ale formularului

Trebuie furnizate următoarele informații:

Denumire	Descriere	Exemplu
Tip	Tipul de identificare a companiei. Tipul trebuie să fi fost introdus și să fie prezent în RetailForce Cloud. Sunt disponibile următoarele tipuri: [0] = VatNumber, [1] = taxNumber, [2] = GLNNumber, [3] = BusinessIdentificationNumber, [4] = Clasificare statistică, [5] = Număr de înregistrare în registrul comerțului, [6] = Oficiul de înregistrare în registrul comerțului, [7] = Număr de înregistrare în registrul comercial Vezi și: Identificarea companiei Vă recomandăm să utilizați tipul [0] = VatNumber ca ID principal în toate țările (UE), chiar dacă acesta nu este utilizat ca ID obligatoriu al companiei în țara respectivă.	[0] = VatNumber
Identificare	Identificarea propriu-zisă a companiei. Trebuie să corespundă informațiilor introduse în RetailForce Cloud.	ATU57780814
storeNumber	Numărul sucursalei/magazinului în care se află casa de marcat. Trebuie să corespundă informațiilor introduse în RetailForce Cloud. ATENȚIE: în Franța, aici trebuie indicat codul SIRET (extensia codului SIREN cu numărul sucursalei).	S001, 12345 etc.
terminalNumber	Numărul casei de marcat. Trebuie să corespundă informațiilor introduse în RetailForce Cloud.	0010
cloudApiKey	Cheie API pentru autentificarea comunicării cu Cloud	RFC_4a2abc...
cloudApiSecret	API Secret pentru autentificarea comunicării în cloud	ypts7u5OU...

Răspuns

Răspunsuri posibile:

Cod	Descriere	Exemplu
200	Clientul a fost creat și configurat cu succes. ID-ul unic al clientului (uniqueClientId) este returnat ca obiect de răspuns. ID-ul unic al clientului (uniqueClientId) trebuie salvat de sistemul POS și utilizat de acesta pe parcursul întregului proces de comunicare ulterioară (referitor la client).	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	Nu s-a găsit nicio organizație în RetailForce Cloud pentru ID-ul companiei specificat. Depanare: Verificați ID-ul companiei în RetailForce Cloud și la casa de marcat. Creați o companie (organizație sau firmă) în RetailForce Cloud	-
406	Datorită tipului specificat (codul companiei), nu este posibilă o atribuire clară (de exemplu, atunci când se utilizează [6] = CommercialRegisterNumberOffice). Depanare: Utilizați un alt tip de ID (de exemplu, [0] = VatNumber)	-
409	Există deja un client cu uniqueClientId în Serviciul fiscal (Fiscal Middleware). Depanare: Utilizați clientul existent	-

Acest articol a fost tradus automat.