Allgemeine Information zur Konfiguration – RetailForce Software GmbH

Dieser Artikel enthält allgemeine Informationen zur Erstellung eines Konfigurationsobjekts für die RetailForce Fiskal Middleware in der Cloud. Konfigurationen werden von Fiskalclients bei der Initialisierung, über ConfigClient byCloud (PUT /api/v1/management/clients/byCloud) heruntergeladen und angewendet. Weitere Informationen dazu finden Sie im Artikel zur Inbetriebnahme.

Im RetailForce Portal können Konfiguration innerhalb der Organisationsstruktur nach unten weitervererbt werden. Dies bedeutet, eine Konfiguration kann für eine Reihe von Terminals gleichzeitig verwendet werden und es ist nicht erforderlich diese für jedes Terminal zu erstellen. Es ist auch möglich, Konfigurationen im geerbten Objekt zu überschreiben.

Beispiel:

Im Beispiel weiter unten, wird das Konfigurationsobjekt A der Organisation "XYZ Holding GmbH" zugewiesen. Die Konfiguration wird auf alle darunterliegenden Einheiten in der Organisationsstruktur weitervererbt. Der Kasse "099" (Terminal) wird das Konfigurationsobjekt B zugewiesen und somit das geerbte Konfigurationsobjekt A überschrieben.

Das Konfigurationsobjekt ist immer unabhängig vom Stammdatenobjekt, wie Organisation etc.

Es ist möglich ein Konfigurationsobjekt auf jede Stufe der Vererbung zu übertragen. Auf jeder Ebene (Organisation, Company, Stores und Terminals) kann ein Konfigurationsobjekt zugewiesen werden.

Wichtig: Es ist nicht möglich eine Konfigurationsobjekt zwischen verschiedene Organisationen zu teilen. Für jede Organisation muss ein eigenes Konfigurationsobjekt erstellt werden. Ausnahme: Masterorganisation

Cloud Daten Vererbungsstruktur:

Organisation
- Company - optional
  - Store
    - Terminal

Beispiel:

Ihre Organisation besteht aus 13 Shops in Deutschland und plant nun eine neue Filiale in Österreich. Die verwendete Hardware des Kassensystems ist in Deutschland und Österreich gleich.

Sie benötigen:

Eine Organisation mit Sitz in Deutschland. (FiskalLand = Deutschland, FiscalCountry = Germany)
Ein zusätzliche optionale Firma, die in Österreich ansässig ist. (FiskalLand = Österreich, FiscalCountry = Austria)
13 Geschäfte/Filialen mit Verbindung zur Organisation
1 Filiale mit Verbindung zur Organisation UND zur Firma in Österreich

Sie definieren 2 Konfigurationsobjekte:

ein Konfigurationsobjekt mit allen Konfigurationen, welche für Deutschland benötigt werden
- Sie können die gesamte Hardwarekonfiguration im Konfigurationsobjekt für Deutschland definieren.
ein Konfigurationsobjekt mit allen Konfigurationen, welche für Österreich benötigt werden
- Sie müssen die Hardwarekonfiguration nicht in der Konfiguration für Österreich definieren.
- Überschreiben Sie das FiskalLand (FiscalCountry) und die länderspezifische Konfiguration für die Konfiguration für Österreich.

Zuweisung Konfiguration

Die Zuweisung eines Konfigurationsobjektes erfolgt im RetailForce Portal, über die Details der jeweiligen Entitäten (Organisationsobjekte: Organisation, Company, Store, Terminal).
Wählen Sie dazu im Bereich Configuration, über das Drop-Down Menü, die entsprechende Konfiguration aus und klicken Sie "Save".

Hinweis: Wird in der Auswahl kein Konfigurationsobjekt angezeigt, so wurde entweder noch keine Konfiguration erstellt, oder die erstellte Konfiguration passt nicht zum eingestellten Fiskalland der Entität. Konfigurationen können nur zugewiesen werden, wenn das Fiskalland der Entität (z.B. der Company) mit dem der Konfiguration übereinstimmt.

Über den Menüpunkt "New Config" kann festgelegt werden, dass eine neue Konfiguration ab einem bestimmten Datum ("New valid from") gültig wird.

Update Konfiguration

Achtung: Wird ein Konfigurationsobjekt in der Cloud verändert so wird diese Änderung NICHT automatisch an die betreffenden Clients (Middleware-Mandaten) ausgespielt!

Die Konfigurationen der einzelnen Clients muss über:

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

aktualisiert werden.

Fehlerbehandlung

Error: License

Sollten Sie beim Aufrufen des Endpunktes GetConfiguration den folgenden Fehler erhalten:

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

so fehlt die Lizenz-Berechtigung, welche den Client erlaubt Konfigurationsdaten aus der Cloud abzurufen. Bitte prüfen Sie im RetailForce Cloud Portal, ob in den der jeweiligen Konfiguration zugeordneten Lizenz die Option "Access configuration download" enthalten ist.