Интерфейсът за съответствие с изискванията за Vat може да се използва за автоматично създаване на необходимата организационна структура в RetailForce portal.
За целта изходната система трябва да включва информацията, необходима за създаване на съответните обекти в payload-а на документа.
Предварителни условия
За да функционира автоматичното създаване на структурата, трябва да са изпълнени следните предварителни условия.
- Създадена организация,
- създадена е конфигурацията на сървъра,
- създадена е конфигурацията,
- лицензите са присвоени,
- конфигурацията е присвоена към организацията.
Организация
Организацията трябва вече да съществува в RetailForce Cloud Portal, тъй като payload-ът от източната система трябва да се позовава на съществуващ „OrganisationId“ при създаването на нова структура.
Забележка: не е възможно да се създават компании чрез този механизъм.
Конфигурация на сървъра
Трябва да се създаде конфигурация на сървъра, която използва правилния „Тип връзка“.
Конфигурация
Трябва да се създаде конфигурация, която:
- е свързана с конфигурацията на сървъра,
- има присвоени лицензи,
- е присвоена към съответната организация.
Payload от системата нагоре по веригата
Чрез payload-то от системата нагоре по веригата може да се създаде както нов магазин, така и нов terminal. За целта payload-то трябва да съдържа следната информация:
- "OrganisationId",
- Информация за магазина,
- Информация за терминала.
OrganisationId
„OrganisationId“ трябва да се отнася до организацията, създадена в RetailForce Cloud Portal. То се нарича още „LicenseConsumerId“ и може да бъде намерено в портала в свойствата на организацията.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Информация за магазина
Възможни свойства за създаване на нов магазин.
"Store": {
"StoreId": "00000000-0000-0000-0000-000000000000"
"OrganisationId": "00000000-0000-0000-0000-000000000000",
"CompanyId": null,
"StoreNumber": "003",
"Caption": "Teststore 003",
"FiscalRegion": null,
"Telephone": null,
"Fax": null,
"EMail": null,
"OpeningDate": null,
"ClosingDate": null,
"HiddenDate": null,
"UpdatedByPrincipalId": null,
"OpeningHoursMonday": null,
"OpeningHoursTuesday": null,
"OpeningHoursWednesday": null,
"OpeningHoursThursday": null,
"OpeningHoursFriday": null,
"OpeningHoursSaturday": null,
"OpeningHoursSunday": null,
"ClientConfigurationId": null,
"NewClientConfigurationId": null,
"NewClientConfigurationValidFrom": null,
"Street": "Av. Gustave Eiffel",
"StreetNumber": "-",
"PostalCode": "75007",
"City": "Paris",
"CountryCode": "FRA"
},Информация в колоната „Type“:
- M ... задължително („mandatory“)
- M* ... задължително в определени държави или при определени условия
- R ... препоръчително („препоръчително“)
- O ... по избор
| Елемент | Тип |
Описание | |
| Магазин |
|
Информация за магазина | |
| StoreId | M |
Ако трябва да се създаде нов магазин, използвайте „00000000-0000-0000-0000-000000000000“ в първия И във всички следващи payloads. | |
OrganisationId |
M |
ID на организацията, не е задължително, тъй като свойството „OrganisationId“ извън обекта „магазин“ вече се отнася за съответната организация. Винаги използвайте: „00000000-0000-0000-0000-000000000000“ |
|
CompanyId |
O |
не е задължително, може да се използва, ако под организацията е създадена фирма. | |
StoreNumber |
M |
Номер на магазина/филиала. | |
Caption |
М |
Наименование на магазина / клона. | |
Фискален регион |
M* |
Задължително само в държави, в които съществуват фискални региони (например Испания). | |
Телефон |
O |
Контактна информация за магазина: Телефонен номер. | |
| Факс | O |
Контактна информация за магазина: Номер на факса. | |
| Имейл | O |
Контактна информация за магазина: имейл адрес. | |
Дата на откриване |
М* |
Задължително само в държави, в които трябва да се посочи датата на откриване на магазина (например Словения). | |
| ClosingDate | O |
Не трябва да се посочва, тъй като представлява крайната дата на закриване на търговския обект (когато магазинът е бил затворен завинаги). | |
| Скрити данни | O |
Не трябва да се посочва, тъй като представлява датата, на която магазинът е бил скрит в портала, защото всички свързани с него терминали са били изведени от експлоатация. | |
UpdatedByPrincipalId |
|
Не трябва да се посочва. | |
РаботноВремеПонеделник |
O |
Работно време в понеделник. | |
Работно време във вторник |
O |
Работно време вторник. | |
Работно време в сряда |
O |
Работно време в сряда. | |
Работно време в четвъртък |
O |
Работно време в четвъртък. | |
Работно време в петък |
O |
Работно време в петък. | |
Работно време в събота |
O |
Работно време събота. | |
Работно време неделя |
O |
Работно време неделя. | |
Идентификатор на конфигурацията на клиента |
O |
ID на конфигурацията, не е задължителен. | |
Идентификатор на новата конфигурация на клиента |
O |
ID на нова конфигурация, не е задължително. | |
NewClientConfigurationValidFrom |
O |
Дата, от която новата конфигурация влиза в сила. | |
Улица |
М |
Наименование на улицата, на която се намира магазинът/филиалът. | |
StreetNumber |
М |
Номер на улицата, на която се намира магазинът/филиалът. | |
PostalCode |
M |
Пощенски код на магазина/филиала. | |
Град |
М |
Град на магазина / клона. | |
CountryCode |
М |
Код на държавата (ISO 3166-1 Alpha-3). | |
Параметри на магазина
Могат да се зададат опционални параметри на магазина в страните, където това е възможно, например Франция, Словения, Хърватия и други.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Информация в колоната „Тип“:
- M ... задължително („задължително“)
- M* ... задължително в определени държави или при определени условия
- R ... препоръчително („препоръчително“)
- O ... по избор
| Елементи | Тип |
Описание | |
| StoreParameters |
|
||
| ParameterName | O |
Обозначение на параметъра. | |
| ParameterValue | O |
Стойност на параметъра. | |
| ParameterEncrypted | O |
Превключвател, показващ дали параметърът е криптиран. | |
| ParameterOnlyServer | O |
Превключва дали параметърът се използва само в конфигурацията на сървъра. | |
Информация за терминала
"Terminal": {
"TerminalId": "00000000-0000-0000-0000-000000000000",
"StoreId": "00000000-0000-0000-0000-000000000000",
"TerminalNumber": "009",
"FiscalCountry": null,
"Caption": "Testterminal 003/009",
"PlatformType": null,
"IsTest": true,
"IsDisabledGetConfigurationLimit": null,
"ArchiveDate": null,
"ClientConfigurationId": null,
"NewClientConfigurationId": null,
"NewClientConfigurationValidFrom": null,
"GlobalShortId": null,
"PurchaseDate": null,
"TerminalType": null,
"UpdatedByPrincipalId": null,
"CashRegisterId": null,
"CashRegisterBrand": null,
"CashRegisterModelname": null,
"CashRegisterSerialNumber": null,
"CashRegisterSoftwareBrand": null,
"CashRegisterSoftwareVersion": null,
"CashRegisterSoftwareCompany": null,
"CommissioningDate": null
},Информация в колоната „Тип“:
- M ... задължително („задължително“)
- M* ... задължително в определени държави или при определени условия
- R ... препоръчително („препоръчително“)
- O ... по избор
| Елементи | Тип |
Описание | |
| Terminal |
|
Информация за терминала | |
terminalId |
M |
Ако трябва да се създаде нов terminal, използвайте „00000000-0000-0000-0000-000000000000“ в първия И във всички следващи payloads. | |
StoreId |
M |
Винаги използвайте „00000000-0000-0000-0000-000000000000“. | |
terminalNumber |
M |
Номер на касовия апарат в магазина. | |
FiscalCountry |
O |
не се изисква. | |
Caption |
R |
Означение на касовия апарат. | |
Тип платформа |
M* |
Задължително само в определени държави (например Германия). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Възможно само за тестови терминали („IsTest“: true). | |
ArchiveDate |
O |
Не се посочва; показва кога терминалът е изведен от експлоатация и архивиран. | |
ClientConfigurationId |
O |
ID на конфигурацията, не е задължително. | |
NewClientConfigurationId |
O |
ID на нова конфигурация, не е задължително. | |
NewClientConfigurationValidFrom |
O |
Дата, от която новата конфигурация влиза в сила. | |
GlobalShortId |
|
Глобален кратък ID на терминала, не може да се задава, присвоява се от RF-System. | |
PurchaseDate |
M* |
Задължително само в определени държави (например Германия) | |
Тип на терминала |
M* |
Задължително само в определени държави (например Германия) | |
UpdatedByPrincipalId |
|
Не трябва да се посочва. | |
CashRegisterId |
M* |
Задължително само в някои държави (например Германия) | |
CashRegisterBrand |
M* |
Задължително само в някои държави (например Германия) | |
Име на модела на касовия апарат |
M* |
Задължително само в някои държави (например Германия) | |
Сериен номер на касовия апарат |
M* |
Задължително само в някои държави (например Германия) | |
Марка на софтуера за касовия апарат |
M* |
Задължително само в определени държави (например Германия) | |
Версия на софтуера за касови апарати |
M* |
Задължително само в определени държави (например Германия) | |
Фирма на софтуера за касови апарати |
M* |
Задължително само в определени държави (например Германия) | |
Дата на въвеждане в експлоатация |
|
Не трябва да се задава! | |
Тази статия е преведена автоматично.
Коментари
0 коментара
Влезте в услугата, за да оставите коментар.