Generelle oplysninger om konfiguration – RetailForce

Denne artikel indeholder generelle oplysninger om, hvordan man opretter et konfigurationsobjekt til RetailForce Fiscal Middleware i skyen. Konfigurationer downloades og anvendes af skatteklienter under initialiseringen via ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Se artiklen om initialisering for yderligere oplysninger.

I RetailForce portalen kan konfigurationen arves nedad i organisationsstrukturen. Det betyder, at en konfiguration kan bruges til flere terminaler på samme tid, og at det ikke er nødvendigt at oprette den for hver enkelt terminal. Det er også muligt at overskrive visse konfigurationer i det arvede objekt.

Eksempel:

I eksemplet nedenfor er konfigurationsobjekt A tildelt organisationen "XYZ Holding GmbH". Konfigurationen arves af alle underordnede enheder i organisationsstrukturen. Kasseapparatet "099" (terminal) er tildelt konfigurationsobjekt B og overskriver dermed det arvede konfigurationsobjekt A.

Konfigurationsobjektet er altid uafhængigt af stamdataobjektet, såsom organisationen osv.

Det er muligt at overføre et konfigurationsobjekt til ethvert arveniveau. Et konfigurationsobjekt kan overføres på hvert niveau (organisation, virksomhed, butikker og terminaler).

Vigtigt: Det er ikke muligt at dele et konfigurationsobjekt mellem forskellige organisationer. Der skal oprettes et separat konfigurationsobjekt for hver organisation. Undtagelse: Hovedorganisation

Arvstruktur för clouddata:

Organisation
- Virksomhed – valgfrit
  - Butik
    - Terminal

Eksempel:

Din organisation består af 13 butikker i Tyskland og planlægger nu at åbne en ny filial i Østrig. Den anvendte POS-systemhardware er den samme i Tyskland og Østrig.

Du skal bruge:

En organisation med hjemsted i Tyskland (fiscalCountry = Tyskland)
Et yderligere valgfrit selskab med hjemsted i Østrig (fiscalCountry = Østrig)
13 butikker/filialer med tilknytning til organisationen
1 filial med tilknytning til organisationen OG til selskabet i Østrig

Du skal definere 2 konfigurationsobjekter:

et konfigurationsobjekt med alle de konfigurationer, der er nødvendige for Tyskland
- Du kan definere hele hardwarekonfigurationen i konfigurationsobjektet for Tyskland
et konfigurationsobjekt med alle de konfigurationer, der er nødvendige for Østrig
- Du behøver ikke at definere hardwarekonfigurationen i konfigurationen for Østrig
- overskriv fiscalCountry og den landespecifikke konfiguration i konfigurationen for Østrig

Tildeling af konfigurationer

Tildelingen af et konfigurationsobjekt foretages i RetailForce portalen via detaljerne for de respektive enheder (organisationsobjekter: Organisation, Virksomhed, Butik, Terminal).

For at gøre dette skal du vælge den relevante konfiguration i området Konfiguration via rullemenuen og klikke på "Gem".

Bemærk: Hvis der ikke vises noget konfigurationsobjekt i udvælgelsen, er der enten endnu ikke oprettet nogen konfiguration, eller også stemmer den oprettede konfiguration ikke overens med den enheds indstillede skatteland. Konfigurationer kan kun tildeles, hvis enhedens skatteland (f.eks. virksomheden) stemmer overens med konfigurationens.

Menupunktet »Ny konfiguration« kan bruges til at angive, at en ny konfiguration er gyldig fra en bestemt dato (»Ny gyldig fra«).

Opdater konfiguration

OBS: Hvis et konfigurationsobjekt ændres i Cloud, distribueres denne ændring IKKE automatisk til de relevante klienter (middleware-mandater)!

Konfigurationerne for de enkelte klienter skal overføres via:

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

skal opdateres.

Fejlhåndtering

Fejl: Licens

Hvis du modtager følgende fejl, når du kalder GetConfiguration-endpointet, får du følgende besked:

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

Den licensindstilling, der giver clienten mulighed for at hente konfigurationsdata fra skyen, mangler. Kontroller venligst i RetailForce Cloud Portal, om den tildelte licens indeholder indstillingen "Adgang til konfigurationsdownload".