Обща информация за конфигурацията – RetailForce

Тази статия съдържа обща информация за това как да създадете конфигурационен обект за RetailForce Fiscal Middleware в облака. Конфигурациите се изтеглят и прилагат от фискалните клиенти по време на инициализацията чрез ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). За повече информация вижте статията за инициализацията.

В RetailForce portal конфигурацията може да се наследява надолу в организационната структура. Това означава, че една конфигурация може да се използва едновременно за няколко терминала и не е необходимо да се създава за всеки терминал поотделно. Възможно е също така някои конфигурации в наследения обект да бъдат презаписани.

Пример:

В примера по-долу конфигурационният обект А е присвоен на организацията „XYZ Holding GmbH“. Конфигурацията се наследява от всички подчинени единици в организационната структура. Касовият апарат „099“ (terminal) е присвоен на конфигурационния обект Б и по този начин презаписва наследения конфигурационен обект А.

Конфигурационният обект винаги е независим от обекта с основните данни, като например организация и др.

Възможно е прехвърлянето на конфигурационен обект на всяко ниво на наследяване. Конфигурационният обект може да бъде прехвърлен на всяко ниво (организация, компания, магазини и терминали).

Важно: Не е възможно да се споделя конфигурационен обект между различни организации. За всяка организация трябва да се създаде отделен конфигурационен обект. Изключение: Основна организация

Структура на наследяване на данни в Cloud:

Организация
- Компания – по избор
  - Магазин
    - Terminal

Пример:

Вашата организация се състои от 13 магазина в Германия и в момента планира откриването на нов филиал в Австрия. Хардуерът на POS системата е един и същ както в Германия, така и в Австрия.

Ще ви е необходимо:

Организация със седалище в Германия (fiscalCountry = Germany)
Допълнителна, по избор, компания със седалище в Австрия (fiscalCountry = Austria)
13 магазина/филиала, свързани с организацията
1 филиал, свързан с организацията И с дружеството в Австрия

Трябва да дефинирате 2 конфигурационни обекта:

конфигурационен обект с всички конфигурации, необходими за Германия
- можете да дефинирате цялата хардуерна конфигурация в конфигурационния обект за Германия
конфигурационен обект с всички конфигурации, необходими за Австрия
- не е необходимо да дефинирате хардуерната конфигурация в конфигурацията за Австрия
- заместете fiscalCountry и специфичната за страната конфигурация в конфигурацията за Австрия

Присвояване на конфигурации

Присвояването на конфигурационен обект се извършва в RetailForce portal чрез подробностите на съответните обекти (организационни обекти: Организация, Компания, Магазин, Terminal).

За целта изберете съответната конфигурация в областта „Конфигурация“ чрез падащото меню и кликнете върху „Запази“.

Забележка: Ако в списъка за избор не се показва конфигурационен обект, това означава, че или все още не е създадена конфигурация, или създадената конфигурация не съответства на зададената данъчна държава на обекта. Конфигурациите могат да бъдат присвоени само ако данъчната държава на обекта (например фирмата) съвпада с тази на конфигурацията.

Чрез менюто „Нова конфигурация“ може да се зададе нова конфигурация, валидна от определена дата („Нова, валидна от“).

Актуализиране на конфигурацията

Внимание: Ако обектът за конфигурация бъде променен в Cloud, тази промяна НЕ се разпространява автоматично към съответните клиенти (мандати за middleware)!

Конфигурациите на отделните клиенти трябва да се предадат чрез:

PUT /api/v1/management/clients/byCloud/{clientId}

трябва да бъдат актуализирани.

Обработка на грешки

Грешка: Лиценз

Ако получите следната грешка при извикване на крайната точка GetConfiguration:

[error] (exception): License 'GetConfiguration' for client '<ClientID>' not found.

Липсва опцията за лиценз, която позволява на клиента да изтегля конфигурационни данни от облака. Моля, проверете в RetailForce Cloud Portal дали присвоеният лиценз съдържа опцията „Достъп до изтегляне на конфигурация“.