Opće informacije o konfiguraciji – RetailForce

Ovaj članak sadrži opće informacije o tome kako kreirati konfiguracijski objekt za RetailForce Fiscal Middleware u oblaku. Konfiguracije preuzimaju i primjenjuju fiskalni klijenti tokom 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 koristiti za više terminala istovremeno i nije je potrebno kreirati za svaki terminal. Također je moguće prebrisati neke konfiguracije u naslijeđenom objektu.

Primjer:

U primjeru ispod, konfiguracijski objekt A je dodijeljen organizaciji "XYZ Holding GmbH". Konfiguracija se nasljeđuje od svih podređenih jedinica u organizacijskoj strukturi. Kasi "099" (terminalu) je dodijeljen konfiguracijski objekt B i time se prepravlja naslijeđeni konfiguracijski objekt A.

Objekt konfiguracije je uvijek nezavisan od objekta osnovnih podataka, kao što je organizacija, itd.

Moguće je prenijeti konfiguracijski objekt na bilo koji nivo nasljeđivanja. Konfiguracijski objekt se može prenijeti na svakom nivou (organizacija, kompanija, prodavnice i terminali).

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

Struktura nasljeđivanja podataka u oblaku:

Organizacija
- Kompanija - opcionalno
  - Prodavnica
    - Terminal

Primjer:

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

Trebat će vam:

Organizacija sa sjedištem u Njemačkoj (FiscalCountry = Njemačka)
Dodatna opcionalna kompanija sa sjedištem u Austriji (FiscalCountry = Austria)
13 prodavnica/filijala sa vezom za organizaciju
1 poslovnica povezana s organizacijom I s kompanijom u Austriji

Morate definirati 2 objekta konfiguracije:

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
- prepisati 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, Kompanija, Prodavnica, Terminal).

Da biste to učinili, odaberite odgovarajuću konfiguraciju u odjeljku Konfiguracija putem padajućeg menija i kliknite na "Sačuvaj".

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

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

Ažuriraj konfiguraciju

Pažnja: Ako se objekat konfiguracije promijeni u oblaku, ova promjena se NE distribuira automatski relevantnim klijentima (middleware mandati)!

Konfiguracije pojedinačnih klijenata moraju se prenijeti putem:

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

mora biti ažuriran.

Rukovanje greškama

Greška: Licenca

Ako dobijete sljedeću grešku prilikom pozivanja krajnje tačke GetConfiguration, dobit ćete:

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

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