Informații generale privind configurarea – RetailForce

Acest articol conține informații generale despre modul de creare a unui obiect de configurare pentru RetailForce Fiscal Middleware în cloud. Configurațiile sunt descărcate și aplicate de clienții fiscali în timpul inițializării, prin intermediul ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Pentru mai multe informații, consultați articolul despre inițializare.

În RetailForce portal, configurația poate fi moștenită în jos în cadrul structurii organizaționale. Aceasta înseamnă că o configurație poate fi utilizată pentru mai multe terminale în același timp și nu este necesar să o creați pentru fiecare terminal în parte. De asemenea, este posibil să suprascrieți anumite configurații din obiectul moștenit.

Exemplu:

În exemplul de mai jos, obiectul de configurare A este atribuit organizației „XYZ Holding GmbH”. Configurația este moștenită de toate unitățile subordonate din structura organizațională. Casa de marcat „099” (terminal) are atribuit obiectul de configurare B și, astfel, suprascrie obiectul de configurare moștenit A.

Obiectul de configurare este întotdeauna independent de obiectul de date de bază, cum ar fi organizația etc.

Este posibil să se transfere un obiect de configurare la orice nivel de moștenire. Un obiect de configurare poate fi transferat la fiecare nivel (organizație, companie, magazine și terminale).

Important: Nu este posibilă partajarea unui obiect de configurare între organizații diferite. Pentru fiecare organizație trebuie creat un obiect de configurare separat. Excepție: Organizația principală

Structura de moștenire a datelor în Cloud:

Organizație
- Companie – opțional
  - Magazin
    - Terminal

Exemplu:

Organizația dumneavoastră are 13 magazine în Germania și planifică acum deschiderea unei noi filiale în Austria. Hardware-ul sistemului POS utilizat este același atât în Germania, cât și în Austria.

Veți avea nevoie de:

O organizație cu sediul în Germania (fiscalCountry = Germania)
O companie opțională suplimentară cu sediul în Austria (fiscalCountry = Austria)
13 magazine/filiale conectate la organizație
1 sucursală conectată atât la organizație, cât și la compania din Austria

Trebuie să definiți 2 obiecte de configurare:

un obiect de configurare cu toate configurațiile necesare pentru Germania
- puteți defini întreaga configurație hardware în obiectul de configurare pentru Germania
un obiect de configurare cu toate configurațiile necesare pentru Austria
- nu este necesar să definiți configurația hardware în configurația pentru Austria
- suprascrieți câmpul „fiscalCountry” și configurația specifică țării în configurația pentru Austria

Atribuirea configurațiilor

Atribuirea unui obiect de configurare se efectuează în RetailForce portal, prin intermediul detaliilor entităților respective (obiecte de organizare: Organizație, Companie, Magazin, Terminal).

Pentru aceasta, selectați configurația relevantă din zona Configurație prin meniul derulant și faceți clic pe „Salvare”.

Notă: Dacă nu este afișat niciun obiect de configurare în listă, înseamnă fie că nu a fost creată încă nicio configurare, fie că configurația creată nu corespunde țării fiscale setate pentru entitate. Configurațiile pot fi atribuite numai dacă țara fiscală a entității (de exemplu, a companiei) corespunde cu cea a configurației.

Opțiunea de meniu „Configurație nouă” poate fi utilizată pentru a specifica că o nouă configurație este valabilă începând cu o anumită dată („Valabilă începând cu”).

Actualizare configurație

Atenție: Dacă un obiect de configurare este modificat în Cloud, această modificare NU este distribuită automat către clienții relevanți (mandatele middleware)!

Configurațiile clienților individuali trebuie transmise prin:

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

trebuie actualizate.

Gestionarea erorilor

Eroare: Licență

Dacă primiți următoarea eroare la apelarea punctului final GetConfiguration:

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

Lipsește opțiunea de licență care permite clientului să preia date de configurare din cloud. Vă rugăm să verificați în RetailForce Cloud Portal dacă licența atribuită conține opțiunea „Acces la descărcarea configurației”.