Všeobecné informácie o konfigurácii – RetailForce

Tento článok obsahuje všeobecné informácie o tom, ako vytvoriť konfiguračný objekt pre RetailForce Fiscal Middleware v cloude. Konfigurácie si daňové klienty stiahnu a aplikujú počas inicializácie prostredníctvom ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Ďalšie informácie nájdete v článku o inicializácii.

V RetailForce portal sa konfigurácia môže dediť smerom nadol v rámci organizačnej štruktúry. To znamená, že jednu konfiguráciu je možné použiť pre viacero terminálov súčasne a nie je potrebné ju vytvárať pre každý terminál zvlášť. Niektoré konfigurácie v zdedenom objekte je možné aj prepísať.

Príklad:

V nižšie uvedenom príklade je konfiguračný objekt A priradený k organizácii „XYZ Holding GmbH“. Konfiguráciu zdedia všetky podriadené jednotky v organizačnej štruktúre. Pokladničný terminal „099“ má priradený konfiguračný objekt B, čím prepisuje zdedený konfiguračný objekt A.

Konfiguračný objekt je vždy nezávislý od objektu kmeňových údajov, ako je organizácia atď.

Konfiguračný objekt je možné preniesť na ľubovoľnú úroveň dedičnosti. Konfiguračný objekt je možné preniesť na každej úrovni (organizácia, spoločnosť, predajne a terminály).

Dôležité: Nie je možné zdieľať konfiguračný objekt medzi rôznymi organizáciami. Pre každú organizáciu sa musí vytvoriť samostatný konfiguračný objekt. Výnimka: Hlavná organizácia

Štruktúra dedičnosti údajov v Cloud:

Organizácia
- Spoločnosť – voliteľné
  - Predajňa
    - Terminal

Príklad:

Vaša organizácia pozostáva z 13 predajní v Nemecku a teraz plánuje otvorenie novej pobočky v Rakúsku. Hardvér POS systému je v Nemecku aj v Rakúsku rovnaký.

Budete potrebovať:

Organizáciu so sídlom v Nemecku (fiscalCountry = Germany)
Ďalšiu voliteľnú spoločnosť so sídlom v Rakúsku (fiscalCountry = Austria)
13 predajní/pobočiek prepojených s organizáciou
1 pobočku prepojenú s organizáciou A so spoločnosťou v Rakúsku

Musíte definovať 2 konfiguračné objekty:

konfiguračný objekt so všetkými konfiguráciami potrebnými pre Nemecko
- v konfiguračnom objekte pre Nemecko môžete definovať celú hardvérovú konfiguráciu
konfiguračný objekt so všetkými konfiguráciami potrebnými pre Rakúsko
- v konfigurácii pre Rakúsko nemusíte definovať hardvérovú konfiguráciu
- prepisujte políčko fiscalCountry a konfiguráciu špecifickú pre danú krajinu v konfigurácii pre Rakúsko

Priradenie konfigurácií

Priradenie konfiguračného objektu sa vykonáva v RetailForce portal prostredníctvom podrobností príslušných entít (organizačné objekty: Organizácia, Spoločnosť, Predajňa, Terminal).

Na to vyberte príslušnú konfiguráciu v oblasti Konfigurácia z roletového menu a kliknite na „Uložiť“.

Poznámka: Ak sa vo výbere nezobrazuje žiadny konfiguračný objekt, buď ešte nebola vytvorená žiadna konfigurácia, alebo vytvorená konfigurácia nezodpovedá nastavenému daňovému štátu entity. Konfigurácie je možné priradiť len vtedy, ak daňový štát entity (napr. spoločnosti) zodpovedá daňovému štátu konfigurácie.

Pomocou položky ponuky „Nová konfigurácia“ môžete určiť, že nová konfigurácia je platná od určitého dátumu („Platná od“).

Aktualizácia konfigurácie

Upozornenie: Ak sa objekt konfigurácie zmení v Cloudu, táto zmena sa automaticky NEPRENESIE do príslušných klientov (mandátov middleware)!

Konfigurácie jednotlivých klientov je potrebné odoslať prostredníctvom:

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

musí byť aktualizovaná.

Spracovanie chýb

Chyba: Licencia

Ak sa pri volaní koncového bodu GetConfiguration zobrazí nasledujúca chyba:

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

Chýba licenčná možnosť, ktorá klientovi umožňuje načítať konfiguračné údaje z cloudu. Skontrolujte prosím v RetailForce Cloud Portal, či pridelená licencia obsahuje možnosť „Prístup k stiahnutiu konfigurácie“.