Dans cet article, vous découvrirez les étapes à suivre après vous être reconnecté au FiskalService.

Les mêmes étapes doivent être suivies pour l’intégration .NET ;

Prérequis

• Le service fiscal est installé et l’URL est connue / l’intégration de la bibliothèque .NET est terminée à ce stade
• Vous disposez d’un accès à RetailForce Cloud au moyen d’une ApiKey cloud et d’un secret API (apiSecret)
• Vous récupérez la configuration en la téléchargeant depuis le Cloud
• Vous disposez du numéro d’identification fiscale (UID) / numéro fiscal de l’organisation du système de point de vente
• Vous disposez du numéro de magasin et du numéro de terminal.

Procédure

Afin de minimiser la persistance des données au niveau du système de point de vente, procédez comme suit. Vous êtes responsable de la conservation des états au sein du système de caisse, mais vous devez les mettre à jour régulièrement.

Vérifiez si la configuration client existe déjà

Une fois cette étape terminée, vous recevrez l’uniqueClientId du module fiscal correspondant à la caisse demandée. (L’uniqueClientId correspond au terminalId dans RetailForce Cloud).

Service fiscal

Pour déterminer si la configuration du client existe déjà dans le FiskalService, vous devez exécuter deux méthodes :

• GET management/clients/LicenseConsumerId
• GET management/clients/ID

Pour plus d’informations sur les fonctionnalités, veuillez vous reporter à la documentation Swagger du client Fiscalservice.

Intégration .NET

Grâce à l’intégration .NET, vous pouvez utiliser la classe FiscalModuleManagement et la méthode GetClients() pour interroger tous les clients disponibles dans la configuration.

Si le client n’existe pas encore dans la configuration

Si le client existe déjà dans la configuration et que vous avez reçu un « uniqueClientId », vous pouvez ignorer cette étape.

Téléchargez la configuration du terminal depuis le Cloud ; pour obtenir des instructions, consultez l’article :

Initialisation (générale)

Connexion au Cloud

Service fiscal

Le module fiscal ne stocke pas les données d’accès au Cloud (ApiKey/apiSecret). Par conséquent, ces données d’accès doivent être transmises au service / module fiscal à chaque nouvelle connexion.

Ces données peuvent être transmises à l’aide de la méthode suivante :

• POST management/Cloud/connect

Intégration .NET

Dans le cadre de l’intégration .NET, les identifiants d’accès au Cloud doivent être transmis lors de la création du module fiscal (paramètre de la méthode CreateFiscalModuleForClient).

Il est recommandé d’initialiser et de charger le module fiscal au démarrage du logiciel de point de vente lors de l’intégration .NET, car dans certains pays, les étapes d’initialisation peuvent prendre un peu plus de temps.

Vérifier si le FiskalClient est déjà initialisé

Pour déterminer si l’initialisation du FiskalClient a déjà été effectuée, vous pouvez interroger l’état du FiskalClient :

• GET /api/v1/information/client/{clientId}/status
• Intégration .NET : propriété FiscalClientStatus du module fiscal

La propriété « State » peut prendre les valeurs suivantes :

• NotInitialized
• Initialisé
• Mise hors service

Initialisation du client fiscal

Si le FiskalClient est déjà initialisé, vous pouvez ignorer cette étape.

Vous trouverez une description détaillée de la procédure d’initialisation dans l’article suivant :

Initialisation (généralités)

Terminer

Une fois ces étapes accomplies, le FiskalClient est prêt à recevoir les premières pièces justificatives.

Cet article a été traduit automatiquement.