Splošne informacije o konfiguraciji – RetailForce

Ta članek vsebuje splošne informacije o tem, kako ustvariti konfiguracijski objekt za RetailForce Fiscal Middleware v oblaku. Konfiguracije fiskalni odjemalci prenesejo in uporabijo med inicializacijo prek ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Za več informacij glejte članek o inicializaciji.

V RetailForce portalu se konfiguracija lahko deduje navzdol znotraj organizacijske strukture. To pomeni, da se konfiguracija lahko uporablja za več terminalov hkrati in da je ni treba ustvarjati za vsak terminal posebej. Prav tako je mogoče nekatere konfiguracije v podedovanem objektu prepisati.

Primer:

V spodnjem primeru je konfiguracijski objekt A dodeljen organizaciji »XYZ Holding GmbH«. Konfiguracijo podedujejo vse podrejene enote v organizacijski strukturi. Blagajni »099« (terminal) je dodeljen konfiguracijski objekt B, ki s tem prepiše podedovani konfiguracijski objekt A.

Konfiguracijski objekt je vedno neodvisen od objekta glavnih podatkov, kot je organizacija itd.

Konfiguracijski objekt je mogoče prenesti na katero koli raven dedovanja. Konfiguracijski objekt se lahko prenese na vsaki ravni (organizacija, podjetje, trgovine in terminali).

Pomembno: Konfiguracijskega objekta ni mogoče deliti med različnimi organizacijami. Za vsako organizacijo je treba ustvariti ločen konfiguracijski objekt. Izjema: Glavna organizacija

Struktura dedovanja podatkov v Cloud:

Organizacija
- Podjetje – neobvezno
  - Trgovina
    - Terminal

Primer:

Vaša organizacija obsega 13 trgovin v Nemčiji in zdaj načrtuje odprtje nove podružnice v Avstriji. Strojna oprema POS-sistema je enaka v Nemčiji in Avstriji.

Potrebovali boste:

Organizacijo s sedežem v Nemčiji (fiscalCountry = Germany)
Dodatno, po želji, podjetje s sedežem v Avstriji (fiscalCountry = Austria)
13 trgovin/podružnic, povezanih z organizacijo
1 podružnico, povezano z organizacijo IN s podjetjem v Avstriji

Opredeliti morate 2 konfiguracijska objekta:

konfiguracijski objekt z vsemi konfiguracijami, potrebnimi za Nemčijo
- v konfiguracijskem objektu za Nemčijo lahko opredelite celotno konfiguracijo strojne opreme
konfiguracijski objekt z vsemi konfiguracijami, potrebnimi za Avstrijo
- v konfiguraciji za Avstrijo vam ni treba opredeliti strojne konfiguracije
- v konfiguraciji za Avstrijo prepisati polje fiscalCountry in konfiguracijo, specifično za to državo

Dodeljevanje konfiguracij

Dodelitev konfiguracijskega objekta se izvede v RetailForce portalu prek podrobnosti posameznih entitet (organizacijski objekti: Organizacija, Podjetje, Trgovina, Terminal).

Za to v področju Konfiguracija prek spustnega menija izberite ustrezno konfiguracijo in kliknite »Shrani«.

Opomba: Če se v izbirnem meniju ne prikaže noben konfiguracijski objekt, to pomeni, da konfiguracija še ni bila ustvarjena ali da ustvarjena konfiguracija ne ustreza nastavljeni davčni državi entitete. Konfiguracije je mogoče dodeliti le, če davčna država entitete (npr. podjetja) ustreza davčni državi konfiguracije.

Z menijsko postavko »Nova konfiguracija« lahko določite, da nova konfiguracija velja od določenega datuma (»Velja od«).

Posodobitev konfiguracije

Pozor: Če se objekt konfiguracije spremeni v Cloudu, se ta sprememba NE posreduje samodejno ustreznim strankam (mandatom middleware)!

Konfiguracije posameznih klientov je treba posredovati prek:

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

je treba posodobiti.

Obravnavanje napak

Napaka: Licenca

Če pri klicu končne točke GetConfiguration prejmete naslednjo napako:

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

Manjka licenčna možnost, ki omogoča stranki pridobivanje konfiguracijskih podatkov iz oblaka. V RetailForce Cloud Portal preverite, ali dodeljena licenca vsebuje možnost »Dostop do prenosa konfiguracije«.