Opće informacije o konfiguraciji – RetailForce

Ovaj članak sadrži opće informacije o tome kako stvoriti konfiguracijski objekt za RetailForce Fiscal Middleware u oblaku. Konfiguracije preuzimaju i primjenjuju fiskalni klijenti tijekom inicijalizacije, putem ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Za više informacija pogledajte članak o inicijalizaciji.

U RetailForce portalu konfiguracija se može nasljeđivati prema dolje unutar organizacijske strukture. To znači da se konfiguracija može istovremeno koristiti za više terminala i nije je potrebno izraditi za svaki terminal pojedinačno. Također je moguće prebrisati neke konfiguracije u naslijeđenom objektu.

Primjer:

U primjeru u nastavku konfiguracijski objekt A dodijeljen je organizaciji "XYZ Holding GmbH". Konfiguracija se nasljeđuje na sve podređene jedinice u organizacijskoj strukturi. Blagajni "099" (terminalu) dodijeljen je konfiguracijski objekt B i time se prepravlja naslijeđeni konfiguracijski objekt A.

Objekt konfiguracije uvijek je neovisan o objektu osnovnih podataka, kao što je organizacija itd.

Moguće je prenijeti konfiguracijski objekt na bilo koju razinu nasljeđivanja. Konfiguracijski objekt može se prenijeti na svakoj razini (organizacija, tvrtka, trgovine i terminali).

Važno: Nije moguće dijeliti konfiguracijski objekt između različitih organizacija. Za svaku organizaciju mora se stvoriti zaseban konfiguracijski objekt. Iznimka: Glavna organizacija

Struktura nasljeđivanja podataka u oblaku:

Organizacija
- Tvrtka - opcionalno
  - Trgovina
    - Terminal

Primjer:

Vaša organizacija se sastoji od 13 trgovina u Njemačkoj i sada planira novu poslovnicu u Austriji. Hardver POS sustava koji se koristi isti je u Njemačkoj i Austriji.

Trebat će vam:

Organizacija sa sjedištem u Njemačkoj (FiscalCountry = Njemačka)
Dodatna opcionalna tvrtka sa sjedištem u Austriji (FiscalCountry = Austria)
13 trgovina/poslovnica povezanih s organizacijom
1 podružnica povezana s organizacijom I s tvrtkom u Austriji

Morate definirati 2 konfiguracijska objekta:

objekt konfiguracije sa svim konfiguracijama potrebnim za Njemačku
- možete definirati cijelu hardversku konfiguraciju u konfiguracijskom objektu za Njemačku
objekt konfiguracije sa svim konfiguracijama potrebnim za Austriju
- ne morate definirati hardversku konfiguraciju u konfiguraciji za Austriju
- nadpisati FiscalCountry i konfiguraciju specifičnu za zemlju za konfiguraciju za Austriju

Dodjeljivanje konfiguracija

Dodjela konfiguracijskog objekta vrši se u RetailForce portalu, putem detalja odgovarajućih entiteta (objekti organizacije: Organizacija, Tvrtka, Trgovina, Terminal).

Za to odaberite odgovarajuću konfiguraciju u području Konfiguracija putem padajućeg izbornika i kliknite "Spremi".

Napomena: Ako se u odabiru ne prikazuje nijedan objekt konfiguracije, to znači da konfiguracija još nije stvorena ili da stvorena konfiguracija ne odgovara postavljenoj fiskalnoj zemlji entiteta. Konfiguracije se mogu dodijeliti samo ako fiskalna zemlja entiteta (npr. tvrtke) odgovara zemlji konfiguracije.

Stavku izbornika "Nova konfiguracija" možete koristiti za navođenje da nova konfiguracija vrijedi od određenog datuma ("Nova vrijedna od").

Ažuriraj konfiguraciju

Obratite pažnju: Ako se objekt konfiguracije promijeni u oblaku, ta se promjena NE distribuira automatski relevantnim klijentima (middleware mandate)!

Konfiguracije pojedinih klijenata moraju se prenijeti putem:

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

mora se ažurirati.

Rukovanje pogreškama

Greška: Licenca

Ako pri pozivanju krajnje točke GetConfiguration dobijete sljedeću pogrešku, primit ćete:

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

Fali opcija licence koja klijentu omogućuje preuzimanje konfiguracijskih podataka iz oblaka. Molimo provjerite u RetailForce Cloud Portalu sadrži li dodijeljena licenca opciju "Pristup preuzimanju konfiguracije".