Bendra informacija apie konfigūraciją – RetailForce

Šiame straipsnyje pateikiama bendroji informacija apie konfigūracijos objekto kūrimą „RetailForce Fiskal“ tarpinės programinės įrangos debesyje. Konfigūracijas fiskaliniai klientai atsisiunčia ir taiko inicijavimo metu per „ConfigClient byCloud“ (PUT /api/v1/management/clients/byCloud). Daugiau informacijos apie tai rasite straipsnyje apie paleidimą.

„RetailForce“ portale konfigūracijos gali būti perduodamos žemyn organizacijos struktūroje. Tai reiškia, kad viena konfigūracija gali būti naudojama keliems terminalams vienu metu ir jos nereikia kurti kiekvienam terminalui atskirai. Taip pat galima perrašyti konfigūracijas paveldėtame objekte.

Pavyzdys:

Toliau pateiktame pavyzdyje konfigūracijos objektas A priskiriamas organizacijai „XYZ Holding GmbH“. Konfigūracija perduodama visoms žemiau esančioms organizacijos struktūros vienetams. Kasai „099“ (terminalui) priskiriamas konfigūracijos objektas B, taip perrašant paveldėtą konfigūracijos objektą A.

Konfigūracijos objektas visada yra nepriklausomas nuo pagrindinių duomenų objekto, pvz., organizacijos ir pan.

Konfigūracijos objektą galima perkelti į bet kurį paveldėjimo lygį. Konfigūracijos objektas gali būti priskirtas kiekviename lygmenyje (organizacija, įmonė, parduotuvės ir terminalai).

Svarbu: neįmanoma dalytis konfigūracijos objektu tarp skirtingų organizacijų. Kiekvienai organizacijai turi būti sukurtas atskiras konfigūracijos objektas. Išimtis: pagrindinė organizacija

Debesų duomenų paveldėjimo struktūra:

Organizacija
- Įmonė – pasirinktinai
  - Parduotuvė
    - Terminalas

Pavyzdys:

Jūsų organizacija turi 13 parduotuvių Vokietijoje ir dabar planuoja atidaryti naują filialą Austrijoje. Kasos sistemos naudojama įranga Vokietijoje ir Austrijoje yra vienoda.

Jums reikės:

Organizacijos, kurios buveinė yra Vokietijoje. (FiskalLand = Vokietija, FiscalCountry = Germany)
Papildomą pasirinktinę įmonę, įsikūrusią Austrijoje. (FiskalLand = Austrija, FiscalCountry = Austria)
13 parduotuvių/filialų, susijusių su organizacija
1 filialą, susijusį su organizacija IR su įmone Austrijoje

Jūs apibrėžiate 2 konfigūracijos objektus:

konfigūracijos objektą su visomis konfigūracijomis, reikalingomis Vokietijai
- Visą aparatinės įrangos konfigūraciją galite apibrėžti konfigūracijos objekte, skirtame Vokietijai.
konfigūracijos objektą su visomis konfigūracijomis, reikalingomis Austrijai
- Jums nereikia apibrėžti aparatinės įrangos konfigūracijos Austrijos konfigūracijoje.
- Perrašykite fiskalinę šalį (FiscalCountry) ir šaliai būdingą konfigūraciją Austrijos konfigūracijai.

Konfigūracijos priskyrimas

Konfigūracijos objekto priskyrimas atliekamas „RetailForce“ portale, per atitinkamų subjektų (organizacijos objektų: organizacija, įmonė, parduotuvė, terminalas) duomenis.
Tam srityje „Configuration“ išskleidžiamajame meniu pasirinkite atitinkamą konfigūraciją ir spustelėkite „Save“.

Pastaba: jei pasirinkime nerodomas joks konfigūracijos objektas, tai reiškia, kad konfigūracija dar nebuvo sukurta arba sukurta konfigūracija neatitinka nustatytos subjekto fiskalinės šalies. Konfigūracijos gali būti priskirtos tik tuomet, jei subjekto (pvz., įmonės) fiskalinė šalis sutampa su konfigūracijos fiskaline šalimi.

Meniu punktu „New Config“ galima nustatyti, kad nauja konfigūracija įsigalios nuo tam tikros datos („New valid from“).

Konfigūracijos atnaujinimas

Dėmesio: jei konfigūracijos objektas keičiamas debesyje, šis pakeitimas NEBUS automatiškai perkeltas į atitinkamus klientus (tarpinės programinės įrangos mandatus)!

Atskirų klientų konfigūracijos turi būti atnaujinamos per:

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

Klaidų tvarkymas

Klaida: Licencija

Jei atidarius galinį tašką GetConfiguration pasirodo ši klaida:

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

tai reiškia, kad trūksta licencijos teisių, leidžiančių klientui gauti konfigūracijos duomenis iš debesies. Prašome patikrinti „RetailForce Cloud Portal“ portale, ar atitinkamai konfigūracijai priskirtoje licencijoje yra parinktis „Access configuration download“.