Bendra informacija apie konfigūraciją – RetailForce

Šiame straipsnyje pateikiama bendroji informacija apie tai, kaip sukurti „RetailForce Fiscal Middleware“ konfigūracijos objektą debesyje. Konfigūracijas fiskaliniai klientai atsisiunčia ir taiko inicijavimo metu per „ConfigClient byCloud“ (PUT /api/v1/management/clients/byCloud). Daugiau informacijos rasite straipsnyje apie inicijavimą.

„RetailForce“ portalas konfigūracija gali būti paveldima žemyn organizacinėje struktūroje. Tai reiškia, kad viena konfigūracija gali būti naudojama keliuose terminaluose vienu metu ir jos nebūtina kurti kiekvienam terminalui atskirai. Taip pat galima perrašyti kai kurias paveldėto objekto konfigūracijas.

Pavyzdys:

Toliau pateiktame pavyzdyje konfigūracijos objektas A priskirtas organizacijai „XYZ Holding GmbH“. Konfigūraciją paveldi visi organizacinės struktūros pavaldūs padaliniai. Kasos aparatui „099“ (terminalui) priskirtas konfigūracijos objektas B, kuris perrašo 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 objektą galima perkelti kiekviename lygmenyje (organizacija, įmonė, parduotuvės ir terminalai).

Svarbu: Konfigūracijos objekto negalima bendrai naudoti skirtingose organizacijose. Kiekvienai organizacijai turi būti sukurtas atskiras konfigūracijos objektas. Išimtis: Pagrindinė organizacija

Cloud duomenų paveldėjimo struktūra:

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

Pavyzdys:

Jūsų organizacija turi 13 parduotuvių Vokietijoje ir dabar planuoja atidaryti naują filialą Austrijoje. Vokietijoje ir Austrijoje naudojama ta pati POS sistemos įranga.

Jums reikės:

Vokietijoje įsikūrusi organizacija (fiscalCountry = Vokietija)
Papildoma, neprivaloma įmonė, įsikūrusi Austrijoje (fiscalCountry = Austria)
13 parduotuvių/filialų, susijusių su organizacija
1 filialą, susijusį su organizacija IR su įmone Austrijoje

Turite apibrėžti 2 konfigūracijos objektus:

konfigūracijos objektą su visomis Vokietijai reikalingomis konfigūracijomis
- Vokietijai skirtame konfigūracijos objekte galite apibrėžti visą aparatinės įrangos konfigūraciją
konfigūracijos objektą su visomis Austrijai reikalingomis konfigūracijomis
- Austrijos konfigūracijoje nereikia apibrėžti aparatinės įrangos konfigūracijos
- Austrijos konfigūracijoje perrašykite „fiscalCountry“ ir šaliai būdingą konfigūraciją

Konfigūracijų priskyrimas

Konfigūracijos objekto priskyrimas atliekamas „RetailForce“ portale, naudojantis atitinkamų objektų (organizacijos objektai: „Organizacija“, „Įmonė“, „Parduotuvė“, „Terminal“) duomenimis.

Norėdami tai padaryti, srityje „Konfigūracija“ išskleidžiamajame meniu pasirinkite atitinkamą konfigūraciją ir spustelėkite „Išsaugoti“.

Pastaba: Jei pasirinkimo sąraše nerodomas joks konfigūracijos objektas, tai reiškia, kad konfigūracija dar nebuvo sukurta arba sukurta konfigūracija neatitinka subjekto nustatytos fiskalinės šalies. Konfigūracijas galima priskirti tik tuo atveju, jei subjekto (pvz., įmonės) fiskalinė šalis atitinka konfigūracijos fiskalinę šalį.

Meniu punktą „Nauja konfigūracija“ galima naudoti norint nurodyti, kad nauja konfigūracija galioja nuo tam tikros datos („Galioja nuo“).

Konfigūracijos atnaujinimas

Dėmesio: jei konfigūracijos objektas pakeičiamas Cloud, šis pakeitimas NĖRA automatiškai platinamas atitinkamiems klientams (middleware įgaliojimams)!

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

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

turi būti atnaujinta.

Klaidų tvarkymas

Klaida: Licencija

Jei, kreipdamiesi į „GetConfiguration“ galinį tašką, gaunate šią klaidą:

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

Trūksta licencijos parinkties, leidžiančios klientui atsisiųsti konfigūracijos duomenis iš debesies. Prašome patikrinti „RetailForce Cloud Portal“ portale, ar priskirtoje licencijoje yra parinktis „Prieiga prie konfigūracijos atsisiuntimo“.