Der RetailForce Fiskalservice ist eine Fiskalmiddleware basierend auf Microsoft .net für Deutschland und alle andere Länder.

Installation

Sie können eine Kopie des Fiskalservices für Windows mit dem folgenden Link herunterladen:

http://www.retailforce.cloud/downloads

Bitte achten Sie darauf, die aktuellste Version der Software herunterzuladen.

Das Setup kann leicht, ohne weitere Informationen zu benötigen, installiert werden.

Nach dem Setup wird der Service als ein REST-WebService (Json) mit der Portnumber 7678 (HTTP) als localhost zur Verfügung gestellt.

Alternativen

Alternativ zur REST-Webservice Installation steht die RetailForce Fiskal Middleware auch als:

• Docker-Container - als Download auf Docker-Hub https://hub.docker.com/u/retailforce, sowie
• nuget-Packages - Download der Pakete unter: https://www.nuget.org/profiles/RetailForceDevelopment

zur Verfügung.

Informationen zu diesen Installations- / Integrationsvarianten finden sich in den folgenden Artikeln:

• Docker-Container: Linux - Trusted Fiscal Service als Docker Container
• nuget-Pakete: Erste Schritte in der nuget Implementierung

Beispiel Applikation

Im Downloadverzeichnis finden Sie ebenfalls eine Beispiel Applikation (Fiscal Service Client Sample).

In der Beispiel Applikation ist der gesamte Source Code für einfaches Buchen und Signieren in c# inkludiert.

Zur Nutzung der Beispiel Applikation können Sie auch den folgenden Client-guid nutzen:

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

Sie können diesen client guid für die ersten Tests problemlos nutzen. Für weitere Tests, auch mit Cloud Integration, müssen Sie Ihren eigenen Test Client mit der RetailForce cloud erstellen.

Sollten Sie auf Probleme mit fehlenden DLL's stoßen, werfen Sie bitte einen Blick auf den bin/debug Folder des Projektes in der Beispiel Applikation.

Dokument Validierung / Prüfung

Um Ihnen bei der Integration Ihrer Software zu helfen, haben wir eine Funktion entwickelt, um das document object model zu überprüfen, dass Sie an das Fiskalmodul senden möchten.

Wenn Sie die ValidateDocument Methode über das erstellte TrustedFiscalModul oder dem Fiskal Web Service (abhängig von der Integration) aufrufen, werden Ihnen die Fehler (und Warnungen) des Dokuments sofort zurückgegeben (alle). Somit ist es viel einfacher die Calling Prozedur anzupassen, um den Integrationsprozess zu beenden.

Zusatzinformationen

Die Integration der Middleware kann auf folgende Arten erfolgen:

• Integration über Web Service (windows, REST)
• Integration über Web Service (mit Fiskalclient in .net standard, nuget)
• Integration über Web Service (mit Fiskalclient in .net Framework 2.0, nuget)
• Integration über Web Service (als COM-DLL/Active X, verfügbar auf Anfrage)
• Integration als AAR package auf Androidgeräte (für java) (Verfügbar abhängig von den Pläne von Microsoft)

Weitere technische Informationen

• Die gesamte Entwicklung erfolgte als testgetriebene Entwicklung.
• Alle Tests erfolgten während des Entstehungsprozesses bei der Erstellung einer neuen Version.
• Lösungsentwicklung über nuget packages oder auch als download im windows setup.

Betriebssysteme

Bisher haben wir folgende Betriebssysteme getestet:

• Windows 7
• Windows 10
• Android (ab Version 8) (als nuget package integration)
• Linux (für Web Service)

Bitte beziehen Sie sich ebenso auf die Dokumentation des Sicherheitssystem, wenn das gewählte Sicherheitssystem (tse, hsm, etc) des jeweiligen Landes Sie unterstützt.

Folgende Betriebssysteme haben wir derzeit noch nicht getestet und sind nicht supported, sollten aber auch funktionieren:

• iOs (als nuget package integration

Fiskalclientmanagement

Unserer Erfahrung nach, ist das Management von Fisalclients manchmal sehr mühsam und aufwendig.

Aus diesem Grund haben wir folgende Zusatzservices entwickelt:

• Automatische Client Konfiguration über die RetailForce Cloud, ohne Aufwand für den Kassenbetreiber.
• RetailForce Cloud Management api zum Verwalten von zusätzlichen Firmen, Geschäften und Terminals und allen weiteren Masterdaten die Sie benötigen.

Weitere Dokumentation / Service Dokumentation

Weitere Informationen finden Sie hier:

Vollständige Leistungsbeschreibung des Web Service

• http://localhost:7678/swagger

Vollständige Dokumentation des Fiskalservice (Objektmodell)

Dokumentationsfolder im Download Unterorder der Installationsdokumente.

Diese Dokumentation wird bald verfügbar sein unter: http://docs.retailforce.cloud

Ländereigenschaften (FiscalCountryProperties)