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

Този ендпойнт създава нов client във фискалния middleware и го свързва с терминал в RetailForce Cloud. Той представлява първата стъпка при пускането в експлоатация на нова каса / касов апарат.

Резултати

Успешното извикване на крайната точка (200)

създава нов клиент в middleware-то, присвоява му uniqueClientId на терминала (Cloud) и
изтегля конфигурационния обект от Cloud системата и конфигурира клиента съответно.

Начин на използване

Еднократно, когато се пуска в експлоатация нова касова система. Повторното извикване на крайната точка за същия клиент (clientId) ще доведе до грешка!

ВНИМАНИЕ : ако даден клиент вече е бил свързан веднъж с терминала, създаден в облака (присвояване на uniqueClientId), повторното извикване на крайната точка ще доведе до съобщение за грешка: „409 – Клиентът вече съществува“. Ако клиентът трябва да бъде създаден отново (например при повреда на твърдия диск и др.), трябва да се използва крайната точка /api/v1/management/clients/recovery/restoreByCloud.

Предварителни условия

Организационната структура и обектът за конфигурация са създадени в RetailForce Cloud и са съответно присвоени
Инсталиран е Fiscal Middleware

Полета във формуляра

Трябва да бъде подадена следната информация:

Наименование	Описание	Пример
Тип	Тип идентификация на компанията. Типът също трябва да е въведен и да присъства в RetailForce Cloud. Налични са следните типове: [0] = VatNumber, [1] = taxNumber, [2] = GLN номер, [3] = BusinessIdentificationNumber, [4] = Статистическа класификация, [5] = Номер в търговския регистър, [6] = Служба по вписване в търговския регистър, [7] = Номер в търговския регистър Вижте също: Идентификация на фирмата Препоръчваме да използвате тип [0] = VatNumber като основен ID във всички държави (ЕС), дори ако той не се използва като задължителен ID на дружеството в съответната държава.	[0] = VatNumber
Идентификация	Самата идентификация на дружеството. Трябва да съвпада с информацията, въведена в RetailForce Cloud.	ATU57780814
storeNumber	Номерът на клона/магазина, в който се намира касовият апарат. Трябва да съвпада с информацията, въведена в RetailForce Cloud. ВНИМАНИЕ: във Франция тук трябва да се посочи SIRET (разширение на SIREN с номера на клона).	S001, 12345 и т.н.
terminalNumber	Номер на касовия апарат. Трябва да съвпада с информацията, въведена в RetailForce Cloud.	0010
cloudApiKey	API ключ за удостоверяване на връзката с Cloud	RFC_4a2abc...
cloudApiSecret	API Secret за удостоверяване на облачната комуникация	ypts7u5OU...

Отговор

Възможни отговори:

Код	Описание	Пример
200	The client was created and configured successfully. uniqueClientId се връща като обект на отговора. uniqueClientId трябва да бъде запазен от POS системата и да се използва от нея за целия по-нататъшен процес на комуникация (отнасящ се до клиента).	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	В RetailForce Cloud не беше намерена организация за посочения ID на компанията. Отстраняване на проблема: Проверете ID-то на компанията в RetailForce Cloud и на касовия апарат. Създайте компания (организация или фирма) в RetailForce Cloud	-
406	Поради посочения тип (код на фирмата) не е възможно ясно присвояване (например при използване на [6] = CommercialRegisterNumberOffice). Отстраняване на проблема: Използвайте друг тип ID (например [0] = VatNumber)	-
409	В Fiscal Service (Fiscal Middleware) вече съществува клиент със съответния uniqueClientId. Отстраняване на проблема: Използвайте съществуващ client	-

Тази статия е преведена автоматично.