Skip to main content

Fiscal Devices

Overview

In Belgium (SCE 2.0), fiscalization is handled via a Fiscal Data Module (FDM).

The FDM is responsible for:

  • Receiving transaction data from EFR
  • Generating fiscal control data
  • Ensuring secure communication with FPS Finance
  • Guaranteeing data integrity and auditability

note

The FDM operates within a distributed system together with:

  • the POS system
  • the EFR
  • and the FPS Finance cloud services

FDM Configuration

General Requirements

  • The EFR requires an exclusive FDM per cash register
  • Each POS register must be paired with its own FDM
  • An FDM must not be shared across multiple registers

Important

If the FDM is not reachable, EFR will block fiscal receipt creation.

Connectivity

The FDM connects via network (Ethernet / Wi-Fi). No manual setup is typically required on the device. It can be accessed via:

  • IP address (recommended)
  • Hostname (usually the FDM serial, e.g. http://bmc08000048.local)

Zwartedoos

Use a fixed IP address instead of hostname to avoid DNS resolution delays and improve communication performance.

Zwartedoos FDM Behavior

  • Each FDM is configured by FPS Finance for specific POS serial number(s)
  • This configuration is transmitted automatically to the FDM
  • The FDM will only accept transactions from configured POS serials

Important

If the POS serial does not match the configuration, transactions will be rejected by the FDM.

Authentication (Shared Secret)

To retrieve the FDM authentication secret:

  1. Open the FDM configuration interface and navigate to "Users"
    FDM-Settings-Home

  2. Click on "POS" to view the shared secret
    FDM-Settings-SharedSecret

EFR Configuration

The FDM must be configured as the signature device in the EFR profile.

Required parameters — Sign_Cfg

ParameterDescription
hostURL of the FDM device. Example: http://bmc08000048.local
secretThe shared secret for FDM authentication

Example Sign_Cfg

host=http://bmc08000048.local
secret=ab********************XY

Environment variable example

EFSTA_EFR_PROFILE_CFG__DOT__001_1__DOT__Sign_Cfg="host=http://bmc08000048.local secret=ab********************XY"
Security Notice

The shared secret must be handled securely and only shared with authorized personnel.

Virtual FDM (SDK / Testing)

For development and testing, a virtual FDM can be used. Virtual FDMs are not restricted to specific POS serial numbers and are not valid for production use.

Access to the Zwartedoos SDK for the second-generation FDM is invitation-based. You will be asked to enter an invitation code, or alternatively your email address to receive one. If you have not received an invitation, please contact your partner manager.

Once you have access, retrieve connection details from Zwartedoos Devices:

  • Connectivity → URL
  • FDM → shared secret

Network & Firewall

Ensure outbound HTTPS (TCP 443) connectivity for:

  • FDM ↔ FPS Finance communication
  • Vendor services (if applicable)

Important

SCE 2.0 is an online-first system. Loss of connectivity may prevent fiscal operations.

FDM Activation (Commissioning)

Overview

Activation is the process of making the FDM operational for fiscal use. It includes:

  • Configuration in EFR
  • Registration in the FPS Finance system
  • Commissioning of the device

Registration & Linking

Before activation, ensure the installation (SCE) is registered with FPS Finance and the following are linked:

  • Enterprise (VAT number)
  • Establishment unit
  • POS system
  • FDM device

Commissioning Process

During commissioning, the FDM establishes a secure connection with FPS Finance, authenticates itself, receives its certificates and configuration, and becomes active for fiscal operation.

For the official commissioning process, see GKS 2.0 - geregistreerdkassasysteem.be.

Important

Activation is a regulated compliance process, not just a technical configuration.

Validation

After activation, verify:

  • EFR can reach the FDM
  • Transactions are successfully processed
  • No authentication or signature errors occur
  • Receipts contain fiscal control data
  • Data is transmitted to FPS Finance

FDM Operation

During normal operation, EFR sends transaction data to the FDM. The FDM then:

  • Validates the POS identity
  • Generates fiscal control data
  • Stores transaction information
  • Transmits data to FPS Finance

Important

If the FDM does not return valid fiscal data, EFR must reject the transaction.

FDM Deactivation

When Deactivation Is Required

Deactivation is required when:

  • The FDM is replaced
  • The POS installation changes
  • The business closes
  • The device must be unlinked

Technical Preparation

Before deactivation:

  • Stop fiscal operations and ensure no open transactions remain
  • Perform a final daily closing (Z-report), if applicable
  • Ensure all buffered data has been transmitted

Deregistration

  • Unlink the FDM from the installation in the FPS Finance system
  • Update device lifecycle status

Important

Deactivation must be handled as a compliance process, not by simply disconnecting the device.

Data Retention

Fiscal data must remain securely stored and available for audits. Deactivation must not result in data loss or break the audit trail.

Lifecycle Summary

PhaseDescription
ConfigurationSet up EFR ↔ FDM communication
ActivationRegister and commission the FDM
OperationProcess and transmit transactions
DeactivationSynchronize and deregister