Swiss QR-bill for Dolibarr

This module adds support for generating Swiss QR-bill (DE: QR-Rechnung, FR: QR-facture,IT: QR-fattura) invoices within Dolibarr ERP/CRM. It provides an additional invoice template that complies with the Swiss QR-bill standard, making it easier to issue valid invoices in Switzerland.

For more information: https://www.six-group.com/en/products-services/banking-services/payment-standardization/standards/qr-bill.html

Features

• Supports both QR-IBAN and standard IBAN payment methods.
• Generates QR codes according to the official Swiss standard.
• Seamlessly integrates with Dolibarr’s invoice system.
• Produces ready-to-use invoices in PDF format, including the payment slip.
• Based on Swiss QR Bill PHP library https://github.com/sprain/php-swiss-qr-bill/

Requirements

• PHP ≥ 8.1
• Dolibarr ≥ 18, compatible up to 23

Installation

1. Dowload the module from the Github repository
2. Make sure the maximum size of uploaded files is greater than 3,000 KB
3. Use the upload function in Setup -> Modules/Applications -> Deploy/install external app/module
4. Activate the Swiss QR module
5. Activate the model in Setup -> Modules/Applications -> Invoices
6. You need to configure a bank account with an IBAN or QR-IBAN (reference number).

7. For QR-IBAN payments, configure the BESR-ID in Setup → Other Setup using the variable SI_SWISSQR_REF.

   The BESR-ID is provided by your bank and is required to generate the QR payment reference.

   You can configure a BESR-ID for each bank account using the variable SI_SWISSQR_REF_{ACCOUNT_REF}, where {ACCOUNT_REF} is the reference of the bank account in Dolibarr.

   • Account-specific configuration (SI_SWISSQR_REF_{ACCOUNT_REF}) takes priority.
   • If no account-specific value is configured, the global SI_SWISSQR_REF value is used as a fallback.
   • For PostFinance, use 00000 as the BESR-ID.

   Note: A valid BESR-ID configuration is mandatory for QR-IBAN payments.

About Us

Sinabe is a Swiss company specializing in the integration of web solutions and open-source management software for small and medium-sized businesses. Based in La Chaux-de-Fonds, it supports companies in their digital transformation by prioritizing data sovereignty, transparency, and independence from proprietary solutions. Its expertise includes ERP, CRM, collaboration tools, and web infrastructure hosted in Switzerland.