Obecné informace o konfiguraci – RetailForce

Tento článek obsahuje obecné informace o tom, jak vytvořit konfigurační objekt pro RetailForce Fiscal Middleware v Cloudu. Konfigurace jsou stahovány a aplikovány fiskálními klienty během inicializace prostřednictvím ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Další informace naleznete v článku o inicializaci.

V portálu RetailForce lze konfiguraci dědit směrem dolů v rámci organizační struktury. To znamená, že jednu konfiguraci lze použít pro více terminálů současně a není nutné ji vytvářet pro každý terminál zvlášť. V zděděném objektu je také možné některé konfigurace přepsat.

Příklad:

V níže uvedeném příkladu je konfigurační objekt A přiřazen organizaci „XYZ Holding GmbH“. Konfiguraci zdědí všechny podřízené jednotky v organizační struktuře. Pokladně „099“ (terminálu) je přiřazen konfigurační objekt B, který tak přepíše zděděný konfigurační objekt A.

Konfigurační objekt je vždy nezávislý na objektu kmenových dat, jako je organizace atd.

Konfigurační objekt lze převést na libovolnou úroveň dědičnosti. Konfigurační objekt lze převést na každé úrovni (organizace, společnost, prodejny a terminály).

Důležité: Není možné sdílet konfigurační objekt mezi různými organizacemi. Pro každou organizaci musí být vytvořen samostatný konfigurační objekt. Výjimka: Hlavní organizace

Struktura dědičnosti dat v Cloudu:

Organizace
- Společnost – volitelné
  - Prodejna
    - Terminál

Příklad:

Vaše organizace se skládá z 13 prodejen v Německu a nyní plánuje otevření nové pobočky v Rakousku. Hardware pokladního systému je v Německu i v Rakousku stejný.

Budete potřebovat:

Organizaci se sídlem v Německu (FiscalCountry = Germany)
Další volitelnou společnost se sídlem v Rakousku (FiscalCountry = Austria)
13 prodejen/poboček napojených na organizaci
1 pobočku propojenou s organizací A se společností v Rakousku

Musíte definovat 2 konfigurační objekty:

konfigurační objekt se všemi konfiguracemi potřebnými pro Německo
- v konfiguračním objektu pro Německo můžete definovat celou hardwarovou konfiguraci
konfigurační objekt se všemi konfiguracemi potřebnými pro Rakousko
- v konfiguraci pro Rakousko nemusíte definovat hardwarovou konfiguraci
- v konfiguraci pro Rakousko přepište pole FiscalCountry a konfiguraci specifickou pro danou zemi

Přiřazení konfigurací

Přiřazení konfiguračního objektu se provádí v portálu RetailForce prostřednictvím detailů příslušných entit (organizační objekty: Organizace, Společnost, Prodejna, Terminál).

K tomu vyberte v oblasti Konfigurace z rozbalovacího menu příslušnou konfiguraci a klikněte na „Uložit“.

Poznámka: Pokud se ve výběru nezobrazuje žádný konfigurační objekt, znamená to, že buď ještě nebyla vytvořena žádná konfigurace, nebo že vytvořená konfigurace neodpovídá nastavené daňové zemi entity. Konfigurace lze přiřadit pouze v případě, že daňová země entity (např. společnosti) odpovídá daňové zemi konfigurace.

Pomocí položky nabídky „Nová konfigurace“ lze určit, že nová konfigurace je platná od určitého data („Nová platná od“).

Aktualizace konfigurace

Upozornění: Pokud dojde ke změně konfiguračního objektu v Cloudu, tato změna se NEDISTRIBUJE automaticky do příslušných klientů (mandátů middlewaru)!

Konfigurace jednotlivých klientů je nutné přenést pomocí:

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

musí být aktualizovány.

Zpracování chyb

Chyba: Licence

Pokud se při volání koncového bodu GetConfiguration zobrazí následující chyba:

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

Chybí možnost licence, která klientovi umožňuje načítat konfigurační data z Cloudu. Zkontrolujte prosím v portálu RetailForce Cloud, zda přidělená licence obsahuje možnost „Přístup ke stažení konfigurace“.