Structure of Fiscal Middleware - REST service

The structure of the RetailForce Fiskal middleware as a REST service is described below.

Communication interface and country modules

The RetailForce Fiscal Middleware is composed of different modules,

• the "Trusted Fiscal Module" (TFM) - provides the input interface, among other things
• the different "Trusted Fiscal Country Modules" (TFCM) - the respective country module is responsible for processing the input data based on the regulations in the respective fiscal country.

By separating the TFM and the various TFCMs, further country implementations can be added and existing ones adapted without changing the other country implementations.

This means that there are also different versions of the individual modules.

Schematic illustration

Fiscal Clients

Each individual POS (= client in middleware and terminal in the RetailForce Cloud) is represented by a so-called ClientId ("uniqueClientId"). This corresponds to the terminal ID in the RetailForce Cloud (when using automatic configuration).

It is recommended to install the Fiskal middleware directly on the electronic recording system (in the "cash register"). The ClientId is used to identify the assigned cash register, as shown in the following illustration.

Illustration: Single-slient system

However, several different "cash registers" (terminals) can be connected in parallel with one installation of the middleware (= instance) if the middleware is installed in a cash register network on the (branch) server, for example, as shown in the following illustration.

The displayed cash registers represent logical units with their own cash register number, document number ranges, etc.

Illustration: Multi-client system

When the Fiskal middleware is installed, some test clients are automatically created.

Data management

All data relating to a specific cash register is stored locally in the so-called client directory (for Windows installations, for example C:\ProgramData\RetailForce\Fiscal Webservice\<clientId>). This applies to both single and multi-client systems. Log files are always stored centrally for all clients in the log directory (Windows: C:\ProgramData\RetailForce\Fiscal Webservice\log).