Aperçu des étapes nécessaires à la mise en service d’un client :

1. Création de la structure organisationnelle
2. Configuration
3. Établissement de la connexion au Cloud
4. Initialisation du client

1. Création de la structure organisationnelle

La première étape de la mise en service consiste à créer la structure organisationnelle de l’entreprise exploitant les caisses enregistreuses dans le RetailForce Cloud. Vous trouverez plus de détails à ce sujet dans l’article lié.

Cette étape peut être ignorée pour les systèmes destinés à fonctionner entièrement hors ligne et qui n’établissent à aucun moment de connexion avec le RetailForce Cloud.

2. Configuration

La configuration d’un client de middleware fiscal peut en principe s’effectuer de deux manières différentes (en fonction des paramètres et des accords conclus entre le fabricant du logiciel de caisse et l’entreprise exploitant les caisses) :

1. Configuration via RetailForce Cloud, ou bien
2. Configuration via le logiciel de point de vente (système de caisse, système d’enregistrement électronique)

1. Configuration via RetailForce Cloud

Dans cette variante, le client télécharge localement un objet de configuration préparé dans RetailForce Cloud. Cette approche peut être considérée comme une configuration automatique. La création d’objets de configuration est décrite dans l’article référencé.

Lors de la configuration d’une unité fiscale via le cloud, toutes les données requises par le système sont déjà configurées dans le cloud (instructions et informations générales sur la création d’une configuration). Ces données sont chargées depuis le Cloud au moyen d’un appel émis par le client fiscal (CreateClientByCloud).

Les paramètres de l’appel sont les suivants :

• Identifiant de l’entreprise (companyIdentification), généralement le numéro d’identification TVA (VatNumber). Selon le pays d’imposition, il peut s’avérer nécessaire de saisir d’autres identifiants à la place ou en complément (!). Toutefois, le numéro d’identification TVA est recommandé pour la mise en service.
• Numéro de magasin / de succursale
• Numéro de caisse
• cloudApiKey
• cloudApiSecret

Si la fonction PUT api/v1/management/clients/byCloud s’exécute sans erreur, la configuration du client fiscal est terminée. Le GUID du module fiscal (=clientId) est transmis en tant que valeur de retour.

2. Configuration via le logiciel de point de vente

Au lieu d’une configuration automatique du client via le RetailForce Cloud system, l’objet de configuration peut également être préparé par le logiciel de caisse. Ce type de configuration est utilisé pour les systèmes qui ne disposent pas d’une connexion au RetailForce Cloud. Le point de terminaison PUT /api/v1/management/clients est utilisé à cet effet.

Lors de la configuration du logiciel de caisse, deux méthodes permettent de démarrer correctement le module :

1. Module sans connexion au Cloud, avec stockage et exportation des données en local
2. Module avec connexion au Cloud, avec stockage et exportation des données en local et dans le Cloud

Dans tous les cas, il est indispensable que les paramètres de configuration requis soient correctement définis, conformément à la documentation.

La variante 2 (avec connexion au Cloud) peut également être activée ultérieurement ; il est donc possible de créer une configuration fiscale sans connexion au Cloud, puis de la synchroniser avec le Cloud.

Il convient de noter que la création d’un client dans le Cloud doit être activée par l’éditeur du logiciel de point de vente et/ou l’organisation dans les paramètres du Cloud. La procédure standard consiste à créer d’abord un objet de configuration dans le Cloud.

3. Établissement de la connexion au Cloud

L’étape suivante consiste à connecter le client au RetailForce Cloud (pour les systèmes hors ligne, sans connexion au cloud, cette étape peut être ignorée). Cette opération s’effectue via la fonction :

• POST /api/v1/management/cloud/connect .

Paramètres de l’appel :

• clientId : l’identifiant client unique (GUID) attribué à la caisse lors de sa configuration via le RetailForce Cloud.
• cloudApiKey
• cloudApiSecret

4. Initialisation du client

En appelant la fonction InitializeClient (POST /api/v1/management/clients/initialize), avec le paramètre (document de démarrage), la routine d’initialisation du pays concerné est lancée ; tous les composants de sécurité sont également initialisés au cours de ce processus (si nécessaire).
Pour les questions spécifiques à un pays et/ou à un matériel, veuillez vous reporter à la documentation correspondante.

Le document de démarrage peut être demandé au service en exécutant la fonction :

• GET /api/v1/transactions/document/{clientId}/start
  (paramètre : clientId, facultatif : BookDate).

Si le FiscalClient est utilisé sans fiscalisation (NoFiscalisation), par exemple si seuls des reçus numériques ou des données d’archive sont transmis au client, l’initialisation n’est pas nécessaire.

• Appel de la fonction d’initialisation (InitializeClient - POST /api/v1/management/clients/initialize)

L’initialisation de l’unité fiscale s’effectue ensuite à l’aide de l’appel InitializeClient.

Un NullReceipt est transmis à la fonction InitializeClient ; vous trouverez un exemple ci-dessous :

{
    "modelVersion": "1.5.2",
    "uniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
    "additionalFields": {},
    "documentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
    "documentId": "1",
    "createDate": "2025-05-02T07:08:17.8334419+02:00",
    "bookDate": "2025-05-02T07:08:17.8335535+02:00",
    "documentNumber": "1",
    "documentType": 1000,
    "documentTypeCaption": "Startbeleg",
    "user": {
        "id": "1",
        "caption": "User 1",
        "firstName": "1",
        "lastName": "User",
        "dateOfEntry": "2025-05-02T07:08:17.833596+02:00"
    },
    "allocationGroups": [],
    "positionCount": 0,
    "fiscalDocumentNumber": 1,            
    "fiscalDocumentRevision": 1,          
    "positions": [],
    "Payments": [],
    "additionalHeader": [],
    "additionalFooter": [],
    "fiscalAdditionalFields": {}
}

Le processus d’initialisation est spécifique à chaque pays, mais l’appel de la méthode demeure identique pour tous les pays. Pour plus de détails sur les initialisations spécifiques à chaque pays, veuillez vous reporter à la documentation du pays concerné.

Mise en service en bref

Les fonctions suivantes sont appelées dans l’ordre indiqué ci-dessous pour mettre en service un client :

Articles connexes

Initialisation en Allemagne

Gestion des erreurs

Erreur : GetConfiguration pour le client <clientid> introuvable</clientid>

Cet article a été traduit automatiquement.