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 s’exécute de manière autonome ; aucune information supplémentaire n’est requise.

Une fois l’installation terminée, le service est exposé sous forme de service Web REST (JSON) sur le port 7678 (HTTP). Le service écoute sur toutes les interfaces réseau de la machine, et non pas uniquement sur localhost. Pour une communication chiffrée (HTTPS sur le port 7677), veuillez consulter la section « Activation du protocole HTTPS pour une communication API plus sécurisée ».

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 variantes d’installation/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 écriture comptable 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 développé 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
  • Le déploiement de la solution s’effectue au moyen de paquets NuGet ou par téléchargement du programme d’installation Windows.

Systèmes d’exploitation

Le RetailForce Middleware 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 de package nuget)
  • Linux (pour le service)

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

À ce jour, ces plateformes n’ont pas été validées ni officiellement prises en charge, mais elles devraient fonctionner :

  • iOS (sous forme d'intégration de package nuget)

Gestion des clients fiscaux

D’après notre expérience, l’administration 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 d’éliminer toute maintenance du client fiscal installé
  • RetailForce Cloud API permettant de gérer des sociétés, des magasins et des terminaux supplémentaires, ainsi que toutes les autres données de référence dont vous aurez besoin.

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 le chapitre « Installation »)

Cette documentation sera prochainement accessible sur http://docs.retailforce.cloud.

Caractéristiques du 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