Examples how to use fiskaltrust.interface.
fiskaltrust offers a legal compliant cash register security mechanism.
Per now we published our release candidate interface, version 1.0.nnn. This interface is included in the Nuget Package fiskaltrust.interface and fiskaltrust.interface.utlities version 1.0.16298.1022-rc. The WSDL description file here at Github in the tools directory changed as well.
The detailed documentation for Austria is available from fiskaltrust-portal and for France is available from fiskaltrust-portal when after you activate the role possystem-creator (Registrierkassenhersteller).
To speed up development we also deliver a nuget-package with the packageId fiskaltrust.interface.
As a base technology in communication WCF is used. For local internal communication between queues, signature creation units and custom modules the net.pipe protocoll is the best choice. For multi platform communication the basic http protocol may be the best choice.
SOAP comes with the http protocol from WCF communication. To get the WSDL file you can use these debug-build and goto the http-address configured, here "http://localhost:1200/0b09d163-82a1-4349-83ed-7081398df504" is used. Another option is to use the file from the folder tools/wsdl.
REST is available in both, in XML and JSON. There are helpers which can be loaded to keep the base service lightweight.
Native stream based communication with a defined protocoll format is provided by helpers.
With the helper topology it is possible to solve every scenario.
For usage on Linux and MacOS we use mono to run the fiskaltrust service on it.
For production use it is possible to run it as a daemon.
For test and development, the command-line parameter -test can be used. (You can find details in the developer documentation.)
Prerequisites beside mono-complete 3.x / 4.x are also SQLite and PCSClite if you want to use an USB-based signature creation unit in Austria. If you use the service local in France the same prerequisites are valid.
Typical commands to run:
sudo apt-get update
sudo apt-get install mono-complete
sudo apt-get install sqlite
sudo apt-get install pcsclite
cd fiskaltrust-mono
sudo mono fiskaltrust.mono.exe -caschboxid=0d1269dc-e2ae-42e3-9c57-b686d7832683 -useoffline=true -test
The launcher (fiskaltrust.exe) is constructed to act as an Microsoft Windows service in a production environment. For this also automated installation is supported by command-line parameter. (You can find details in the developer documentation.)
For test and develop the command-line parameter -test can be used to run the service.
The only prerequisites for running the service on a Windows-based machine is .net4.
Typical commands to run:
(open command-line with administration permission)
cd fiskaltrust-net40
fiskaltrust -cashboxid=0d1269dc-e2ae-42e3-9c57-b686d7832683 -test
The same interface and service definition is served as an cloud service. You can use SOAP and REST interface designed for local service to seamless switch over to the cloud service.
The launcher uses the file configuration.json from its execution directory to make up its basic configuration. In production use this is done in the fiskaltrust-portal and the launcher tries to read it from the upload-server, related to the CashboxID and an generated AccessToken. For offline use this configuration is stored in the execution directory. Once the configuration is readed from the execution directory or from upload-server, it is stored localy in the service-folder. The default service-foler is for Microsoft Windows %ProgramData%\fiskaltrust or on Linux /usr/shared/fiskaltrust.
In this folder also the database file and the executeables are stored, to completly reset the service delete this directory.
In the tools\cardtest folder is a tool to test card and readers online and offline. See the README.md included there. The usage of so called cards (a SignatureCreation Unit) is only obligatory when using the service for Austria.
Due to security reasons, the fiskaltrust.securitymechanism does not return anything (null) if the provided CashboxID is wrong.
The fiskaltrust service is under permanent development, so feel free to discuss here your wishes and our bugs with the github-issues feature.
For further documentation on existing modules, follow these hyperlinks:
Testing receipts and SCU for Austria
Journals and exports for all markets
Testing receipts for France
Lemböckgasse 49/1B/6.OG, 1230 Wien
[email protected]
www.fiskaltrust.at
Beispiel, wie man das fiskaltrust.Interface nutzt.
fiskaltrust bietet eine gesetzeskonforme Sicherheitseinrichtung für Registrierkassen an.
Ab sofort gibt es ein neues Interface (unseren Release Candidate), Version 1.0.nnn. Dieses Interface ist im Nuget Package fiskaltrust.interface und fiskaltrust.interface.utlities Version 1.0.16298.1022-rc enthalten. Ebenfalls geändert hat sich dadurch die WSDL Datei hier in den Tools.
Die detaillierte Dokumentation ist für Österreich auf dem fiskaltrust.Portal und für Frankreich auf dem fiskaltrust.Portal nach der Registrierung und Aktivierung der Rolle als Registrierkassenhersteller (in der Übersicht) verfügbar.
Um Ihnen die Entwicklung zu erleichtern, stellen wir auch ein nuget-package mit der packageId fiskaltrust.interface zur Verfügung.
Als Basis-Technologie zur Kommunikation wird WCF verwendet. Zur lokalen, internen Kommunikation zwischen queues, signature creation units (Signaturerstellungseinheiten) und benutzerspezifischen Modulen (Sonstigen Modulen) wird am besten das net.pipe Protokoll verwendet. Zur Kommunikation zwischen verschiedenen Plattformen wird am besten das Protokoll basic http verwendet.
SOAP wird mit dem http-Protokoll der WCF-Kommunikation ausgeliefert. Um die WSDL-Datei zu erhalten, kann man diesen Debug-Build verwenden und auf die konfigurierte http-Adresse gehen. Hierbei wird "http://localhost:1200/0b09d163-82a1-4349-83ed-7081398df504" verwendet. Als weitere Option kann die Datei aus dem Ordner tools/wsdl verwendet werden.
REST steht sowohl in XML als auch in JSON zur Verfügung. Es stehen benutzerspezifische Module zur Verfügung, die zusätzlich geladen werden können. Damit werden die Basis-Services möglichest schlank gehalten.
Nativen Stream-basierte Kommunikation mit einem definierten Protokoll-Format werden als benutzerspezifische Module zur Verfügung gestellt.
Mit der Topologie der benutzerspezifischen Module ist es möglich, jedes technische Szenario zu lösen.
Um den fiskaltrust Service auf Linux und MacOS laufen zu lassen, wird mono verwendet. Für den produktiven Einsatz ist es möglich, ihn als daemon zu betreiben.
Für Test und Entwicklung kann der command-line Parameter -test verwendet werden. Details sind in der Entwickler-Dokumentation zu finden.
Neben Mono-complete 3.x / 4.x ist auch SQLite und PCSClite Voraussetzung, wenn in Österreich eine USB-basierte Signaturerstellungseinheit verwendet werden soll. Wird der Service in Frankreich lokal betrieben gelten dieselben Voraussetzungen.
Typisch ausführbare Befehle:
sudo apt-get update
sudo apt-get install mono-complete
sudo apt-get install sqlite
sudo apt-get install pcsclite
cd fiskaltrust-mono
sudo mono fiskaltrust.mono.exe -caschboxid=0d1269dc-e2ae-42e3-9c57-b686d7832683 -useoffline=true -test
Der Launcher (fiskaltrust.exe) ist als Windows-Dienst für die Produktionsumgebung entwickelt. Es wird auch die Möglichkeit einer automatisierte Installation durch Befehlszeilenparameter unterstützt. Details sind in der Entwickler-Dokumentation zu finden.
Für die Entwicklung und Prüfung kann der Befehlszeilenparameter -test verwendet werden, um den Dienst auszuführen.
Die Installation unter Microsoft Windows hat nur .net4 als Voraussetzung.
Typisch ausführbare Befehle:
(command-line mit Administrationsrechten starten)
cd fiskaltrust-net40
fiskaltrust -cashboxid=0d1269dc-e2ae-42e3-9c57-b686d7832683 -test
Die gleiche Schnittstellen- und Service-Definitionen werden als Cloud-Service unterstützt. Das als lokaler Service entwickelte SOAP- und REST-Interface kann nahtlos zu einen Cloud-Service gewechselt werden.
Der Launcher verwendet die Datei configuration.json von seinem Ausführungsverzeichnis, um die Basiskonfiguration aufzubauen. Im Produktionsbetrieb wird diese Konfiguration im fiskaltrust-Portal vorgenommen und der Launcher versucht, diese vom Upload-Server zu lesen um die CashboxId und den spezifischen AccessToken zu beziehen. Zur Offline-Nutzung wird diese Konfiguration im Ausführungsverzeichnis gespeichert. Sobald die Konfiguration aus dem Ausführungsverzeichnis oder von Upload-Server ausgelesen wird, wird es im lokalen Service-Ordner gespeichert. Der Standard-Service-Ordner ist unter Microsoft Windows %Programdata%\fiskaltrust oder in Linux /usr/shared/fiskaltrust. In diesem Ordner werden auch die Datenbankdatei und die ausführbaren Dateien gespeichert.
Um den Dienst vollständig zurückzusetzen, kann das komplette Verzeichnis gelöscht werden.
Im Verzeichnis Tools\cardtest ist ein Werkzeug zum Testen von Karten und Readern, online und offline. Dort befindet sich auch eine README.md mit einer Beschreibung. Der Einsatz von sogenannten Karten (einer SignatureCreationUnit) ist verpflichtend, falls der Service in Österreich betrieben wird.
Aus Sicherheitsgründen reagiert die fiskaltrust.Sicherheitseinrichtung nur mit einer gültigen Antwort, wenn eine korrekte CashboxID in den Daten übergeben wurde. Wenn eine unbekannte ID übergeben wird, wird keine Antwort (null) generiert.
Der fiskaltrust Service wird ständig weiterentwickelt. Nutzen Sie bitte die Möglichkeit, durch Github-Fragen Ihre Wünsche und Fehler zu diskutieren.
Für die Dokumentation der vorhandenen Module, folgen Sie diesen Links:
Belegtests und SCU-Test für Österreich
Journale und Exports für alle Märkte
Belegtests für Frankreich
Lemböckgasse 49/1B/6.OG, 1230 Wien
[email protected]
www.fiskaltrust.at
Exemple d'utilisation de la fiskaltrust.Interface.
fiskaltrust offre un dispositif de sécurité conforme aux lois et certifier pour les caisses enregistreuses.
Dé maintenant, il y a une nouvelle interface (notre Release Candidate), version 1.0.nnn. Cette interface est incluse dans le Nuget Package fiskaltrust.interface et fiskaltrust.interface.utlities version 1.0.16298.1022-rc. En outre, cela a changé le fichier WSDL ici dans les outils.
La documentation détaillée est pour l'Autriche sur le fiskaltrust.Portal et pour la France sur fiskaltrust.Portal après l'enregistrement et l'activation du rôle de fabricant de caisse enregistreuse (dans la vue d'ensemble) disponible.
Pour faciliter le développement, nous fournissons également un nuget-package avec le packageId fiskaltrust.interface.
WCF est la technologie de communication de base. Pour la communication interne locale entre les files d'attente, les unités de création de signature et les modules spécifiques à l'utilisateur (autres modules), le protocole net.pipe est le mieux utilisé. La meilleure façon de communiquer entre différentes plates-formes est d'utiliser le protocole basic http.
SOAP est livré avec le protocole http de la communication WCF. Pour obtenir le fichier WSDL, vous pouvez utiliser cette version de débogage et accéder à l'adresse http configurée. Cela utilisera "http://localhost:1200/0b09d163-82a1-4349-83ed-7081398df504". Une autre option consiste à utiliser le fichier du dossier tools/wsdl.
REST est disponible en XML et JSON. Des modules spécifiques à l'utilisateur sont disponibles, qui peuvent être chargés en plus. Cela permettra de garder les services de base aussi légeres que possible.
Une communication native basée sur les flux avec un format de protocole défini est fournie en tant que modules spécifiques à l'utilisateur.
Avec la topologie des modules spécifiques à l'utilisateur, il est possible de résoudre n'importe quel scénario technique.
Pour exécuter le service fiskaltrust sur Linux et MacOS, mono est utilisé. Pour une utilisation productive, il est possible de l'utiliser comme daemon.
Pour le test et le développement, le paramètre de ligne de commande -test peut être utilisé. Les détails peuvent être trouvés dans la documentation du développeur.
En plus de Mono-complete 3.x / 4.x, SQLite et PCSClite sont également requis si une dispositif de création de signature USB être utilisée en Autriche. Si le service est exploité localement en France, les mêmes conditions s'appliquent.
Commandes exécutables typiques:
sudo apt-get update
sudo apt-get install mono-complete
sudo apt-get install sqlite
sudo apt-get install pcsclite
cd fiskaltrust-mono
sudo mono fiskaltrust.mono.exe -caschboxid=0d1269dc-e2ae-42e3-9c57-b686d7832683 -useoffline=true -test
Le lanceur (fiskaltrust.exe) est conçu comme un service Windows pour l'environnement de production. Il prend également en charge la possibilité d'une installation automatisée via les paramètres de ligne de commande. Les détails peuvent être trouvés dans la documentation du développeur. Pour le test et le développement, le paramètre de ligne de commande -test peut être utilisé. Les détails peuvent être trouvés dans la documentation du développeur.
L'installation sous Microsoft Windows requiert uniquement .net4 comme prérequis.
Commandes exécutables typiques:
(démarrer la ligne de commande avec les droits d'administration)
cd fiskaltrust-net40
fiskaltrust -cashboxid=0d1269dc-e2ae-42e3-9c57-b686d7832683 -test
Les mêmes définitions d'interface et de service sont prises en charge en tant que service cloud. L'interface SOAP et REST, développée en tant que service local, peut être basculée en toute transparence vers un service cloud.
Le lanceur utilise le fichier configuration.json depuis son répertoire d'exécution pour créer la configuration de base. En production, cette configuration est effectuée dans le portail fiskaltrust et le lanceur tente de le lire depuis le serveur de téléchargement pour obtenir le CashboxId et l'AccessToken spécifique. Pour une utilisation hors ligne, cette configuration est stockée dans le répertoire d'exécution. Dès que la configuration est lue dans le répertoire d'exécution ou le serveur de téléchargement, elle est enregistrée dans le dossier de service local. Dès que la configuration est lue dans le répertoire d'exécution ou le serveur de téléchargement, elle est enregistrée dans le dossier de service local. Le dossier de service par défaut est sous Microsoft Windows %Programdata%\fiskaltrust ou sous Linux /usr/shared/fiskaltrust. Ce dossier stocke également le fichier de base de données et les exécutables.
Pour réinitialiser complètement le service, le répertoire entier peut être supprimé.
Dans le répertoire Tools\cardtest est un outil pour tester les cartes et les lecteurs, en ligne et hors ligne. Il y a aussi un fichier README.md avec une description. L'utilisation de cartes (SignatureCreationUnit) est obligatoire si le service est exploité en Autriche.
Pour des raisons de sécurité, le fiskaltrust.securitymechanism répond uniquement avec une réponse valide si un CashboxID correct a été transmis dans les données. Si un identifiant inconnu est passé, aucune réponse (null) n'est générée.
Le service fiskaltrust est en constante évolution. S'il vous plaît profiter de l'occasion pour discuter de vos souhaits et des erreurs à travers des Questions-Github.
Pour la documentation des modules existants, suivez ces liens:
Test pour les justificatives et SCU en Autriche
Journaux et exports pour tous les marchés
Test des justificcatives pour la France
102 Avenue des Champs-Élysées, 75008 Paris
[email protected]
www.fiskaltrust.at