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

Овај ендпоинт креира новог клијента у Фискалном мидлверу и повезује га са терминалом у RetailForce Cloud. То представља први корак у пуштању у рад нове касе.

Резултати

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

ствара новог клијента у мидлверу, додељује му uniqueClientId терминала (cloud) и
преузима конфигурациони објекат из облачног система и у складу с тим конфигурише клијента.

Употреба

Једнократно, при пуштању у рад нове касе. Поновно позивање ендпоинта за истог клијента (clientId) ће резултирати грешком!

ПАЖЊА : ако је одређени клијент већ једном повезан са терминалом креираним у облаку (доделом uniqueClientId), поновно позивање ендпоинта ће резултирати поруком о грешци: "409 - Клијент већ постоји"). Ако клијент мора поново да се креира (нпр. због квара чврстог диска итд.), мора се користити ендпоинт /api/v1/management/clients/recovery/restoreByCloud.

Предуслови

Организациона структура и објекат конфигурације су креирани у RetailForce облаку и додељени у складу с тим
Инсталиран фискални мидлвејр

Поља обрасца

Морају бити достављене следеће информације:

Назив	Опис	Пример
Тип	Тип идентификације компаније. Тај тип такође мора бити унесен и присутан у RetailForce Cloud-у. Следеће типове је могуће користити: [0] = број ПДВ-а, [1] = порески број, [2] = ГЛН број, [3] = пословни идентификациони број, [4] = статистичка класификација, [5] = број из трговинског регистра, [6] = назив канцеларије трговинског регистра, [7] = број из регистра трговаца Погледајте такође: Идентификација компаније Препоручујемо коришћење типа [0] = VatNumber као примарног идентификатора у свим земљама (ЕУ), чак и ако се он не користи као обавезни идентификатор компаније у одређеној земљи.	[0] = VatNumber
Идентификација	Само идентификација компаније. Мора да одговара информацијама унесеним у RetailForce Cloud.	ATU57780814
бројпродавнице	Број филијале/продавнице у којој се налази каса. Мора да одговара информацијама унесеним у RetailForce Cloud. ПАЖЊА: у Француској, овде мора да се наведе SIRET (проширење SIREN-а бројем филијале).	S001, 12345 итд.
број терминала	Број касе. Мора да одговара информацијама унесеним у RetailForce Cloud.	0010
cloudApiKey	API кључ за аутентификацију облачне комуникације	RFC_4a2abc...
cloudApiSecret	API тајна за аутентификацију облачне комуникације	ypts7u5OU...

Одговор

Могући одговори:

Код	Опис	Пример
200	Клијент је успешно креиран и конфигурисан. uniqueClientId се враћа као објекат одговора. uniqueClientId мора да се сачува у POS систему и да се користи у целом даљем процесу комуникације (у вези са клијентом).	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	У RetailForce Cloud-у није пронађена ниједна организација за наведени ID компаније. Отклањање проблема: Проверите ID компаније у RetailForce Cloud и на каси. Креирајте компанију (организацију или компанију) у RetailForce Cloud	-
406	Због наведеног типа (код компаније), није могуће јасно додељивање (нпр. при коришћењу [6] = CommercialRegisterNumberOffice). Отклањање проблема: Користите други тип ИД-а (нпр. [0] = број ПДВ-а)	-
409	Већ постоји клијент са релевантним uniqueClientId у Фискалној служби (Фискални мидлвејр). Отклањање грешака: Користите постојећег клијента	-

Овај чланак је аутоматски преведен.