Aller au contenu principal

Premiers pas avec le service fiscal

DEVELOPMENT
  • Mise à jour

Le service de fiscalisation RetailForce est un middleware de fiscalisation basé sur .NET destiné à l’Allemagne et à tous les autres pays.

Installation

Vous pouvez télécharger une copie du service de fiscalisation pour Windows à l’aide du lien suivant :

http://www.retailforce.cloud/downloads

Veuillez télécharger la version la plus récente du logiciel.

Le programme d’installation est simple à exécuter ; aucune information supplémentaire n’est requise.

Une fois l’installation terminée, le service est exposé en tant que service Web REST (JSON) sur le port 7678 (HTTPS) en localhost.

Alternatives

En alternative à l’installation du service Web REST, le RetailForce Fiskal middleware est également disponible sous la forme :

Vous trouverez des informations sur ces différentes variantes d’installation et d’intégration dans les articles suivants :

Exemple d’application

Vous trouverez également une application d’exemple dans le répertoire de téléchargement ci-dessus, dans le sous-dossier « Samples » (Fiscal Service Client Sample). Cette application d’exemple contient l’intégralité du code source permettant d’effectuer une simple comptabilisation et une signature en C#.

Pour utiliser l’application d’exemple, vous pouvez utiliser le GUID client suivant :

{c1062c55-57c4-4ed2-9c53-aff1762326a4}

Vous pouvez utiliser ce GUID client sans problème pour vos premiers tests. Pour des tests plus approfondis, notamment avec l’intégration au Cloud, vous devrez créer votre propre client de test avec RetailForce Cloud.

Si des erreurs liées à des DLL manquantes surviennent, veuillez consulter le dossier « bin/debug » du projet dans l’application d’exemple.

Validation des documents

Afin de vous aider à intégrer votre logiciel, nous avons mis en place une fonction permettant de valider le modèle d’objet du document que vous enverrez au module de fiscalisation.

Lorsque vous appelez la méthode ValidateDocument sur un TrustedFiscalModule créé ou au niveau du service web de fiscalisation (selon votre intégration), vous obtiendrez d’un seul coup toutes les erreurs (et tous les avertissements) concernant le document. Il est ainsi beaucoup plus facile d’adapter la procédure d’appel pour mener à bien le processus d’intégration.

Informations complémentaires

L’intégration du middleware peut s’effectuer de la manière suivante

 

  • Intégration via un service web (Windows, REST)
  • Intégration via un service web (avec Fiskalclient sous .NET Standard, NuGet)
  • Intégration via un service web (avec Fiskalclient sous .NET Framework 2.0, nuget)
  • Intégration via un service web (sous forme de DLL COM/ActiveX, disponible sur demande)
  • Intégration sous forme de package AAR sur un appareil Android (pour Java) (disponibilité dépendant des projets de Microsoft)

Quelques informations supplémentaires concernant les aspects techniques

  • L'ensemble du développement est réalisé selon une approche de développement piloté par les tests
  • Tous les tests sont exécutés lors du processus de compilation, à la création d’une nouvelle version
  • Déploiement de la solution via des paquets nuget-packages ou par téléchargement du programme d’installation Windows.

Systèmes d’exploitation

Le middleware RetailForce Fiscal a été testé à ce jour sur les systèmes d’exploitation suivants :

  • Windows 7
  • Windows 10
  • Android (à partir de la version 8) (sous forme d’intégration via un package nuget)
  • Linux (pour le service)

Veuillez également vous reporter à la documentation relative au système de sécurité afin de vérifier si le dispositif de sécurité choisi (TSE, HSM, etc.) dans le pays concerné prend en charge votre système d’exploitation.

À ce jour, cette configuration n’a pas été validée ni supportée, mais elle devrait fonctionner :

  • iOS (sous forme d’intégration via un package NuGet)

Gestion des clients fiscaux

D’après notre expérience, la gestion des clients fiscaux peut parfois s’avérer chronophage et fastidieuse.

C’est pourquoi nous avons mis en place les services supplémentaires suivants :

  • Configuration automatique des clients via le RetailForce Cloud, afin de réduire la maintenance du client fiscal installé
  • API de gestion RetailForce Cloud permettant d’administrer des sociétés, des magasins et des terminaux supplémentaires, ainsi que l’ensemble des autres données de référence nécessaires.

Documentation complémentaire / documentation des services

Vous trouverez ici de la documentation supplémentaire :

Description complète du service web

Documentation complète (modèle d’objet) du service fiscal

Documentation disponible dans le sous-dossier « download » des fichiers d’installation (lien vers la section « Installation »)

Cette documentation sera prochainement disponible sur http://docs.RetailForce Cloud.

Caractéristiques des pays (fiscalCountryProperties)

Cet article a été traduit automatiquement.

Articles associés

Commentaires

0 commentaire

Vous devez vous connecter pour laisser un commentaire.

Réalisé par Zendesk