Aller au contenu principal

Directives de mise en œuvre

Harald Krondorfer
  • Mise à jour

RetailForce développe des logiciels permettant de se conformer aux réglementations relatives à la fiscalisation des systèmes d’enregistrement électroniques dans différents pays. Ce logiciel est appelé « Fiscal Middleware ».

Le présent document fournit un aperçu de la procédure d’intégration du RetailForce Middleware. L’architecture du système amont qui envoie et reçoit des données du RetailForce Middleware, ainsi que les exigences et fonctions spécifiques de ce système, peuvent nécessiter de s’écarter de la description fournie ici.

1. Principes de base

Vous trouverez ci-après la liste des étapes à suivre avant de commencer l’intégration. Ces étapes sont également abordées en détail lors de la session d’intégration.

1.1 Aperçu des variantes d’intégration

Avant de commencer l’intégration, familiarisez-vous avec les différentes variantes d’intégration disponibles. Ces variantes sont décrites dans l’article suivant : Aperçu de la fiscalisation avec RetailForce – RetailForce Software GmbH (= article de présentation).

Les sources à partir desquelles vous pouvez télécharger le RetailForce Middleware dans ses différentes variantes sont également indiquées dans l’article référencé.

Une fois le Fiscal Middleware téléchargé, procédez à son déploiement. Vous trouverez une description de la procédure de déploiement des différentes variantes dans l’article de présentation.

1.1.1 En ligne ou hors ligne

Le RetailForce Fiscal Middleware est, par nature, un système logiciel autonome. Toutefois, certaines fonctions ne sont disponibles que lorsque le middleware est connecté au RetailForce Cloud.

Le RetailForce Cloud fournit diverses fonctions d’administration, telles que la configuration à distance automatique du middleware, y compris la gestion des licences, ainsi que des fonctions d’archivage sécurisé à long terme.

Pour pouvoir utiliser les fonctionnalités du RetailForce Cloud, le Fiscal Middleware ou le client spécifique au sein de l’installation (client = instance unique du système d’enregistrement électronique) doit être connecté à un terminal du RetailForce Cloud.

Si le middleware doit être exploité sans établir de connexion au Cloud (système hors ligne), les étapes suivantes peuvent être ignorées. Passez au point 1.5.

Remarque : nous vous recommandons d’établir une connexion au Cloud (= système en ligne), car cela simplifie considérablement la mise en service d’un client et permet d’automatiser l’initialisation du matériel nécessaire.

1.2 Accéder au RetailForce portal

Toutes les fonctionnalités du RetailForce Cloud sont accessibles via

L’auto-inscription sur le RetailForce Portal n’est pas autorisée pour des raisons de sécurité. Pour accéder au portail, vous devez recevoir un lien d’invitation de la part d’un utilisateur déjà autorisé. La procédure d’inscription qui s’ensuit est décrite dans l’article suivant : Inscription sur le RetailForce Portal – RetailForce Software GmbH.

1.3 Structure organisationnelle

Une structure organisationnelle doit d’abord être créée sur le portail. L’article « Création d’une structure organisationnelle dans RetailForce Cloud – RetailForce Software GmbH » vous donne un aperçu des fonctionnalités disponibles à cet effet.

1.4 Configuration

Une fois la structure organisationnelle mise en place et après avoir créé au moins une organisation (= client), un magasin (= succursale) et un terminal (= caisse), un objet de configuration doit être préparé dans le Cloud et attribué à une entité (organisation, entreprise, magasin ou terminal). Vous trouverez une description de ce processus sous : Informations générales sur la configuration – RetailForce Software GmbH.

1.5 Initialisation

Si les étapes précédentes ont été menées à bien, le Fiscal Middleware peut être mis en service. Les étapes nécessaires à la mise en service (avec ou sans établissement de la connexion au Cloud) sont expliquées plus en détail dans l’article Initialisation (généralités) – RetailForce Software GmbH.

Remarque : veuillez noter que l’article susmentionné décrit également à nouveau les processus « Créer une structure organisationnelle » et « Créer une configuration ».

À l’issue du processus de mise en service/initialisation, le client fiscal doit

  • être entièrement configuré,
    • soit via un objet de configuration préparé dans le Cloud, soit
    • « manuellement » par le système d’enregistrement électronique,
  • et disposer d’un ID de client unique.

2. Intégration

Une fois la mise en service d’un client (« caisse enregistreuse ») effectuée avec succès, l’intégration peut être lancée.

Cette section fournit des indications sur le processus de transfert de documents entre la caisse enregistreuse (système d’enregistrement électronique) et le client concerné.

2.1 Service Web REST

L’article suivant vous aide à vous lancer dans l’intégration de l’interface du service Web REST, qui est utilisée pour

  • le service Windows ainsi que
  • le conteneur Docker.

Premiers pas avec le service fiscal – RetailForce Software GmbH

2.2 Implémentation NuGet

Vous trouverez de l’aide concernant l’implémentation nuget (DLL) du middleware dans l’article suivant : Premiers pas dans l’implémentation nuget – RetailForce Software GmbH.

2.3 Interface du système de fichiers

Outre les deux variantes d’implémentation mentionnées ci-dessus, à savoir le service Web REST et NuGet, le middleware peut également être accessible via une interface de système de fichiers. Vous trouverez de plus amples informations à ce sujet dans l’article : Interface de système de fichiers – RetailForce Software GmbH.

Remarque : veuillez noter que l’interface de système de fichiers n’est pas disponible dans tous les pays. De plus, nous ne recommandons d’utiliser l’interface de système de fichiers que si, pour des raisons techniques, l’implémentation via le service Web REST et NuGet n’est pas possible.

2.4 Processus de transmission des documents

Une fois le middleware fiscal installé sur un ordinateur, sous la forme d’un service Windows, la description de l’API est accessible via http://localhost:7678/swagger/index.html.

En cas d’installation sur un hôte distant (par exemple, sur un réseau local), veuillez utiliser l’adresse IP du système sur lequel le middleware a été déployé à la place de « localhost ».

Tous les points de terminaison du middleware sont décrits dans Swagger. Les points de terminaison de la section « Transactions » sont essentiels pour la transmission de documents (par exemple, les pièces de caisse).

La transmission de documents s’effectue toujours en deux étapes, qui débutent par

  1. « createDocument » et se termine soit par
  2. « storeDocument » ou par « cancelDocument », en cas d’annulation du document.

API-transactions.png

Le processus de transfert des documents est décrit en détail ici : Processus de base de transfert de documents – RetailForce Software GmbH.

2.5 Fiscal Service Client Sample

RetailForce met à disposition un exemple de programme, le Fiscal Service Client Sample. Celui-ci fournit des indications sur la manière de créer la structure JSON dans laquelle les documents sont envoyés au service fiscal.

L’outil Fiscal Service Client Sample permet de générer des exemples de différents types de documents et de cas d’utilisation.

La documentation complète de ce programme est disponible à l’adresse suivante : Fiscal Service Client Sample – RetailForce Software GmbH.

Vous trouverez également des exemples de différents documents et cas d’utilisation dans le Centre de solutions à l’adresse suivante : Transactions commerciales – RetailForce Software GmbH.

Remarque : veuillez noter que les cas d’utilisation répertoriés ici peuvent reposer sur un modèle de document plus ancien. Nous vous recommandons d’utiliser le Fiscal Service Client Sample.

2.6 Liste des points de terminaison

Les points de terminaison (endpoints) qui doivent impérativement être implémentés sont décrits ci-après.

Point de terminaison Description
PUT /api/va/management/clients Nécessaire uniquement si la configuration du client doit être effectuée à partir du logiciel de point de vente et non à partir du système Cloud. Alternative : PUT /api/v1/management/clients/byCloud
PUT /api/v1/management/clients/byCloud Nécessaire si la configuration du client doit être effectuée à partir du système cloud. Alternative : PUT /api/va/management/clients
POST /api/v1/management/cloud/connect établit la connexion au cloud d’un client. Doit être effectuée après chaque redémarrage de l’ordinateur (système). Les données requises pour établir la connexion au cloud (clé API et API Secret) doivent être stockées par le système d’enregistrement électronique.
POST /api/v1/management/clients/initialize Initialise le client ou tout matériel fiscal nécessaire (dispositif technique de sécurité, unité de création de signature, imprimante, etc.). Un document de démarrage est requis pour l’initialisation. Celui-ci peut être généré soit par le système d’enregistrement électronique, soit automatiquement via le middleware à l’aide du point de terminaison GET /api/v1/transactions/document/{clientId}/start.
GET /api/v1/transactions/document/{clientId}/start Recommandé. Crée un document dit « de démarrage » pour le client concerné, en vue de son initialisation.
PUT /api/v1/transactions/createDocument Cette méthode ne crée pas de document en soi ; elle se contente de lancer le processus, par exemple sur le TSE (dispositif technique de sécurité) en Allemagne. (Obligatoire dans tous les pays !)
POST /api/v1/transactions/storeDocument Enregistre le document correspondant
POST /api/v1/transactions/cancelDocument Annule un document au niveau de l’unité de fiscalisation.

 

 

Cet article a été traduit automatiquement.

Articles associés

Commentaires

0 commentaire

Vous devez vous connecter pour laisser un commentaire.

Réalisé par Zendesk