Allmän information om konfiguration – RetailForce

Den här artikeln innehåller allmän information om hur man skapar ett konfigurationsobjekt för RetailForce Fiscal Middleware i molnet. Konfigurationerna hämtas och tillämpas av skatteklienter under initialiseringen via ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). För mer information, se artikeln om initialisering.

I RetailForce portalen kan konfigurationen ärvas nedåt inom organisationsstrukturen. Detta innebär att en konfiguration kan användas för flera terminaler samtidigt och att det inte är nödvändigt att skapa den för varje terminal. Det är också möjligt att skriva över vissa konfigurationer i det ärvda objektet.

Exempel:

I exemplet nedan tilldelas konfigurationsobjekt A organisationen ”XYZ Holding GmbH”. Konfigurationen ärvs av alla underordnade enheter i organisationsstrukturen. Kassan ”099” (terminal) tilldelas konfigurationsobjekt B och skriver därmed över det ärvda konfigurationsobjektet A.

Konfigurationsobjektet är alltid oberoende av stamdataobjektet, såsom organisationen etc.

Det är möjligt att överföra ett konfigurationsobjekt till vilken arvnivå som helst. Ett konfigurationsobjekt kan överföras på varje nivå (organisation, företag, butiker och terminaler).

Viktigt: Det går inte att dela ett konfigurationsobjekt mellan olika organisationer. Ett separat konfigurationsobjekt måste skapas för varje organisation. Undantag: Huvudorganisation

Arvsstruktur för Cloud-data:

Organisation
- Företag – valfritt
  - Butik
    - Terminal

Exempel:

Din organisation består av 13 butiker i Tyskland och planerar nu att öppna en ny filial i Österrike. Hårdvaran för kassasystemet är densamma i både Tyskland och Österrike.

Du behöver:

En organisation med säte i Tyskland (fiscalCountry = Tyskland)
Ett ytterligare valfritt företag med säte i Österrike (fiscalCountry = Austria)
13 butiker/filialer med koppling till organisationen
1 filial med koppling till organisationen OCH till företaget i Österrike

Du måste definiera två konfigurationsobjekt:

ett konfigurationsobjekt med alla konfigurationer som behövs för Tyskland
- Du kan definiera hela hårdvarukonfigurationen i konfigurationsobjektet för Tyskland
ett konfigurationsobjekt med alla konfigurationer som behövs för Österrike
- Du behöver inte definiera hårdvarukonfigurationen i konfigurationen för Österrike
- skriv över fiscalCountry och den landspecifika konfigurationen i konfigurationen för Österrike

Tilldela konfigurationer

Tilldelningen av ett konfigurationsobjekt sker i RetailForce portal via detaljerna för respektive enhet (organisationsobjekt: Organisation, Företag, Butik, Terminal).

För att göra detta väljer du den relevanta konfigurationen i området Konfiguration via rullgardinsmenyn och klickar på ”Spara”.

Obs: Om inget konfigurationsobjekt visas i urvalet har antingen ingen konfiguration skapats ännu eller så stämmer den skapade konfigurationen inte överens med enhetens inställda skatteland. Konfigurationer kan endast tilldelas om enhetens skatteland (t.ex. företaget) stämmer överens med konfigurationens.

Menyalternativet ”Ny konfiguration” kan användas för att ange att en ny konfiguration gäller från ett visst datum (”Gäller från”).

Uppdatera konfiguration

Observera: Om ett konfigurationsobjekt ändras i Cloud distribueras denna ändring INTE automatiskt till de berörda klienterna (middleware-mandat)!

Konfigurationerna för de enskilda klienterna måste överföras via:

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

måste uppdateras.

Felhantering

Fel: Licens

Om du får följande felmeddelande när du anropar GetConfiguration-ändpunkten:

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

Licensalternativet som gör det möjligt för klienten att hämta konfigurationsdata från molnet saknas. Kontrollera i RetailForce Cloud Portal om den tilldelade licensen innehåller alternativet ”Åtkomst till nedladdning av konfiguration”.