Általános információk a konfigurációról – RetailForce

Ez a cikk általános információkat tartalmaz a RetailForce Fiscal Middleware konfigurációs objektumának felhőben történő létrehozásáról. A konfigurációkat az adóügyi kliensek az inicializálás során töltik le és alkalmazzák a ConfigClient byCloud segítségével (PUT /api/v1/management/clients/byCloud). További információkért lásd az inicializálásról szóló cikket.

A RetailForce portalon a konfigurációk a szervezeti struktúrában lefelé örökölhetők. Ez azt jelenti, hogy egy konfiguráció egyszerre több terminálon is használható, és nem szükséges minden terminálhoz külön létrehozni. Lehetőség van bizonyos konfigurációk felülírására az örökölt objektumban is.

Példa:

Az alábbi példában az A konfigurációs objektumot az „XYZ Holding GmbH” szervezethez rendelték. A konfigurációt a szervezeti struktúra összes alárendelt egysége örökli. A „099” számú pénztárgép (terminal) a B konfigurációs objektumot kapja meg, és így felülírja az örökölt A konfigurációs objektumot.

A konfigurációs objektum mindig független a törzsadat-objektumtól, például a szervezettől stb.

A konfigurációs objektumot az öröklődés bármely szintjére át lehet helyezni. A konfigurációs objektum minden szinten (szervezet, vállalat, üzletek és terminálok) átvihető.

Fontos: Egy konfigurációs objektumot nem lehet különböző szervezetek között megosztani. Minden szervezethez külön konfigurációs objektumot kell létrehozni. Kivétel: Főszervezet

Cloud adatöröklési struktúra:

Szervezet
- Vállalat – opcionális
  - Üzlet
    - Terminal

Példa:

Szervezete 13 üzletből áll Németországban, és most egy új fiókot tervez Ausztriában. A POS-rendszer hardvere Németországban és Ausztriában is azonos.

Szüksége lesz:

Egy Németországban székhellyel rendelkező szervezet (fiscalCountry = Germany)
Egy további, opcionális, Ausztriában bejegyzett vállalat (fiscalCountry = Austria)
13, a szervezethez kapcsolódó üzlet/fiók
1 fiók, amely kapcsolódik a szervezethez ÉS az osztrák vállalathoz

2 konfigurációs objektumot kell definiálnia:

egy konfigurációs objektumot, amely tartalmazza a Németországhoz szükséges összes konfigurációt
- a teljes hardverkonfigurációt a Németországra vonatkozó konfigurációs objektumban határozhatja meg
egy konfigurációs objektumot, amely tartalmazza az Ausztriához szükséges összes konfigurációt
- az osztrák konfigurációban nem kell megadnia a hardverkonfigurációt
- az osztrák konfigurációban felül kell írnia a fiscalCountry-t és az országspecifikus konfigurációt

Konfigurációk hozzárendelése

A konfigurációs objektum hozzárendelése a RetailForce portalon történik, az egyes entitások (szervezeti objektumok: Szervezet, Vállalat, Áruház, Terminal) részletei között.

Ehhez válassza ki a megfelelő konfigurációt a Konfiguráció területen a legördülő menüből, majd kattintson a „Mentés” gombra.

Megjegyzés: Ha a kiválasztási listában nem jelenik meg konfigurációs objektum, akkor vagy még nem hoztak létre konfigurációt, vagy a létrehozott konfiguráció nem egyezik meg az entitás beállított adóügyi országával. Konfigurációk csak akkor rendelhetők hozzá, ha az entitás (pl. a vállalat) adóügyi országa megegyezik a konfigurációéval.

Az „Új konfiguráció” menüpont segítségével megadható, hogy egy új konfiguráció egy bizonyos dátumtól („Érvényes tól”) legyen érvényes.

Konfiguráció frissítése

Figyelem: Ha egy konfigurációs objektumot a Cloudban módosítanak, ez a módosítás NEM kerül automatikusan továbbításra az érintett clientshez (middleware-mandátumok)!

Az egyes kliensek konfigurációit a következő útvonalon kell továbbítani:

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

frissíteni kell.

Hibakezelés

Hiba: Licenc

Ha a GetConfiguration végpont meghívásakor a következő hibaüzenet jelenik meg:

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

Hiányzik az a licencopció, amely lehetővé teszi a client számára a konfigurációs adatok letöltését a felhőből. Kérjük, ellenőrizze a RetailForce Cloud Portalon, hogy a hozzárendelt licenc tartalmazza-e az „Access configuration download” (Konfiguráció letöltése) opciót.