Informations générales sur la configuration – RetailForce

Cet article fournit des informations générales sur la création d’un objet de configuration pour RetailForce Fiscal Middleware dans le cloud. Les configurations sont téléchargées et appliquées par les clients fiscaux lors de l’initialisation, via ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Pour plus d’informations, consultez l’article consacré à l’initialisation.

Dans le RetailForce portal, la configuration peut être héritée vers le bas au sein de la structure organisationnelle. Cela signifie qu’une configuration peut être utilisée pour plusieurs terminaux à la fois et qu’il n’est pas nécessaire de la créer pour chaque terminal. Il est également possible de remplacer certaines configurations dans l’objet hérité.

Exemple :

Dans l’exemple ci-dessous, l’objet de configuration A est attribué à l’organisation « XYZ Holding GmbH ». La configuration est héritée par toutes les unités subordonnées au sein de la structure organisationnelle. La caisse « 099 » (terminal) se voit attribuer l’objet de configuration B et remplace ainsi l’objet de configuration A hérité.

L’objet de configuration demeure toujours indépendant de l’objet de données de base, tel que l’organisation, etc.

Il est possible de transférer un objet de configuration à n’importe quel niveau de l’héritage. Un objet de configuration peut être transféré à chaque niveau (organisation, société, magasins et terminaux).

Important : il n’est pas possible de partager un objet de configuration entre différentes organisations. Un objet de configuration distinct doit être créé pour chaque organisation. Exception : l’organisation mère

Structure d’héritage des données dans le Cloud :

Organisation
- Société – facultatif
  - Magasin
    - Terminal

Exemple :

Votre organisation compte 13 magasins en Allemagne et prévoit désormais d’ouvrir une nouvelle succursale en Autriche. Le matériel utilisé pour le système de point de vente (POS) est identique en Allemagne et en Autriche.

Vous aurez besoin de :

Une organisation basée en Allemagne (fiscalCountry = Allemagne)
Une société supplémentaire facultative établie en Autriche (fiscalCountry = Autriche)
13 magasins/succursales rattachés à l’organisation
1 succursale reliée à l’organisation ET à la société en Autriche

Vous devez définir 2 objets de configuration :

un objet de configuration regroupant l’ensemble des paramètres requis pour l’Allemagne
- vous pouvez définir l’intégralité de la configuration matérielle dans l’objet de configuration pour l’Allemagne
un objet de configuration regroupant l’ensemble des paramètres requis pour l’Autriche
- vous n’avez pas besoin de définir la configuration matérielle dans l’objet de configuration pour l’Autriche
- Remplacez le paramètre « fiscalCountry » et la configuration spécifique au pays dans la configuration destinée à l’Autriche.

Affectation des configurations

L’affectation d’un objet de configuration s’effectue dans le RetailForce portal, via les détails des entités concernées (objets d’organisation : Organisation, Société, Magasin, Terminal).

Pour ce faire, sélectionnez la configuration appropriée dans la zone « Configuration » à l’aide du menu déroulant, puis cliquez sur « Enregistrer ».

Remarque : si aucun objet de configuration n’apparaît dans la liste de sélection, cela signifie soit qu’aucune configuration n’a encore été créée, soit que la configuration créée ne correspond pas au pays fiscal défini pour l’entité. Les configurations ne peuvent être attribuées que si le pays fiscal de l’entité (par exemple, la société) correspond à celui de la configuration.

L’option de menu « Nouvelle configuration » permet de préciser qu’une nouvelle configuration est valable à partir d’une date donnée (« Valable à partir du »).

Mise à jour de la configuration

Attention : si un objet de configuration est modifié dans le Cloud, cette modification n’est PAS automatiquement répercutée sur les clients concernés (mandats middleware) !

Les configurations des différents clients doivent être propagées via :

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

doivent être mises à jour.

Gestion des erreurs

Erreur : licence

Si vous recevez l'erreur suivante lors de l'appel du point de terminaison GetConfiguration :

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

L'option de licence permettant au client de récupérer les données de configuration depuis le cloud est manquante. Veuillez vérifier dans le RetailForce Cloud Portal si la licence attribuée contient l'option « Accès au téléchargement de la configuration ».