RetailForce provides a so-called "Fiscal Middleware". The integration of this Fiscal Middleware into an electronic recording system via the standardised, country-independent interface enables the legally compliant operation of electronic recording systems ("cash registers", POS systems, etc.) in many countries.

Integration

An overview on supported operating systems can be found in the linked article.

Variants

The integration of the Fiscal Middleware into an electronic recording system can be done in several ways:

REST-Webservice

The connection via the REST interface of the middleware is used most frequently. For this purpose we provide:

• a Windows service (REST web service). We publish the current version of the REST web service in the download area of our website: https://www.retailforce.cloud/downloads/.
• For Linux systems, we provide a Docker container, which you can find on Docker Hub at: https://hub.docker.com/u/retailforce finden.
• Furthermore, a version of the middleware hosted in the RetailForce cloud is available at https://fiscalisation.retailforce.cloud/swagger/index.html (=Cloud Fiscalisation Service).

DLL-Integration

In addition to the web service connection, it is possible to integrate the middleware as dynamic link libraries (DLLs) into the electronic recording system (method call).

For this variant, we provide nuget packages at https://www.nuget.org/profiles/RetailForceDevelopment. 

This integration variant is also used for android and iOS POS systems, provided they were developed in .NET.

Documentation

All information for the implementation of RetailForce Fiskal Middleware in your POS system can be found here in our Solution Center (https://support.retailforce.cloud).

Especially the section "Developer Information" is relevant for this. The "Technical Information" provides a general overview of technical aspects in different countries.

A full description of the RetailForce Document Object Model (DOM) can be found in the Downloads directory of the RetailForce website in the respective version directory.

Special characteristics REST integration

Information on first steps with the REST web service can be found in the linked article

After installing the Fiskal Middleware (as a REST web service) on a computer, you can access the API description via http://localhost:7678/swagger. 

Docker-Container

Instructions on how to start up the Docker Container under Linux can be found in the linked article.

Special characteristics DLL-Integration

For information on nuget implementation, see the linked article.

Commissioning

To be able to start the Fiscal Service, a so-called "client" must be initialised in the middleware.

A client is always connected / assigned to one cash register (to an independent electronic recording system). One instance of the Fiscal Middleware can contain several clients. The different variants of the use of the fiscal middleware are described below:

The general steps for initializing the middleware are described in the linked article.