ĮRAŠYK /api/v1/management/clients/ byCloud – RetailForce

Naudojant šį galinį tašką, fiskalinėje tarpinėje programinėje įrangoje sukuriama nauja kliento sąskaita, kuri susiejama su „Terminal“ programa „RetailForce Cloud“ sistemoje. Tai yra pirmasis žingsnis pradedant naudoti naują kasos aparatą.

Rezultatas

Sėkmingas galinio taško (200) iškvietimas

sukuria naują klientą tarpinėje programinėje įrangoje ir jam priskiria terminalo (debesies) unikalų kliento identifikatorių (uniqueClientId).
atsisiunčia konfigūracijos objektą iš debesų sistemos ir atitinkamai konfigūruoja klientą.

Naudojimas

Vienkartinis, kai pradedama naudoti nauja kasos sistema. Pakartotinis galinio taško iškvietimas tam pačiam klientui (clientId) sukelia klaidą!

DĖMESIO : jei tam tikras klientas jau buvo kartą prijungtas prie debesyje sukurto terminalo (priskirtas uniqueClientId), pakartotinis galinio taško iškvietimas sukelia klaidos pranešimą: „409 – Klientas jau egzistuoja“. Jei klientą reikia sukurti iš naujo (pvz., dėl kietojo disko gedimo ir pan.), reikia naudoti galinį tašką /api/v1/management/clients/recovery/restoreByCloud.

Reikalavimai

Organizacijos struktūra ir konfigūracijos objektas buvo sukurti „RetailForce Cloud“ ir atitinkamai priskirti
Įdiegta fiskalinė tarpinė programinė įranga

Formos laukeliai

Reikia pateikti šią informaciją:

Pavadinimas	Aprašymas	Pavyzdžiai
Tipas	Įmonės identifikavimo tipas. Tipas taip pat turi būti įvestas ir egzistuoti „RetailForce Cloud“ sistemoje. Galimi šie tipai: [0] = PVM kodas, [1] = Mokesčių kodas, [2] = GLN kodas, [3] = Įmonės identifikavimo kodas, [4] = Statistinė klasifikacija, [5] = Komercinio registro numeris, [6] = Komercinio registro numerio išdavimo įstaiga, [7] = Prekybos registro numeris Taip pat žr.: Įmonės identifikatorius Rekomenduojame visose šalyse (ES) kaip pagrindinį identifikatorių naudoti tipą [0] = PVM kodas, net jei jis nėra privalomas įmonės identifikatorius atitinkamoje šalyje.	[0] = PVM kodas
Identifikacija	Pats įmonės identifikatorius. Turi atitikti informaciją, įvestą į „RetailForce Cloud“.	ATU57780814
storeNumber	Filialo, kuriame yra kasos aparatas, numeris. Turi sutapti su informacija, įvestą į „RetailForce Cloud“. DĖMESIO: Prancūzijoje čia reikia nurodyti SIRET (SIREN su filialo numeriu).	S001, 12345 ir pan.
terminalNumber	Kaso numeris. Turi sutapti su informacija, įvestą į „RetailForce Cloud“.	0010
cloudApiKey	API raktas, skirtas autentiškumui patvirtinti	RFC_4a2abc...
cloudApiSecret	API raktas, skirtas autentiškumui patvirtinti debesų ryšyje	ypts7u5OU...

Atsakymas

Galimi atsakymai:

Kodas	Aprašymas	Pavyzdys
200	Klientas buvo sėkmingai sukurtas ir sukonfigūruotas. Kaip atsakymo objektas grąžinamas uniqueClientId. „uniqueClientId“ turi būti išsaugotas kasos sistemoje ir naudojamas visam tolesniam komunikacijos procesui (susijusiam su klientu) kasos sistemoje.	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	„RetailForce Cloud“ nerasta organizacijos, atitinkančios nurodytą įmonės kodą. Klaidų šalinimas: Įmonės kodo patikrinimas „RetailForce Cloud“ ir kasoje Įmonės (organizacijos arba bendrovės) sukūrimas „RetailForce Cloud“	-
406	Dėl nurodyto tipo (įmonės kodo) neįmanoma atlikti aiškaus priskyrimo (pvz., nurodžius [6] = CommercialRegisterNumberOffice) Klaidų šalinimas: Naudokite kitą kodo tipą (pvz., [0] = PVM kodas)	-
409	Fiskal Service (Fiskal Middleware) jau yra klientas su atitinkamu uniqueClientId Klaidos šalinimas: Naudokite esamą klientą	-