If you have a registered office and a bank account in Switzerland, you are obliged to issue your invoices with the Swiss QR Code according to the Swiss standard. The payment part and receipt as well as the QR code are attached to the invoice.
Note
The QR-bill with Swiss QR code replaces the traditional payment slip and enables simple, error-free payments via banking apps or e-banking.
Xentral supports the creation of structured Swiss QR codes in accordance with Swiss standards.
Since November 2025, structured QR codes have been mandatory, requiring clearly separated and correctly structured address and payment data.
A regular IBAN or a QR-IBAN is required to be able to use the QR invoice in Switzerland.
The Swiss QR Code consists of a payment part and a receipt and is printed on every invoice that has Switzerland set as the billing address. The delivery address is not analysed for the Swiss QR invoice.
Note
Swiss QR Code – How It Works:
The Swiss QR code contains all relevant payment information in a structured format, including:
-
Payment recipient (creditor)
-
CH IBAN
-
Amount and currency
-
Payment reference (depending on the mode)
-
Structured address data
The QR code is automatically generated on the invoice PDF once the invoice is approved and all requirements are met.
Tip
Use Cases & Benefits of the Swiss QR Code Settings:
-
Project-based Swiss QR codes: Enable different payment details per project and ensure a clear separation of billing scenarios.
-
Multiple IBANs in parallel: Facilitate the mapping of company structures or bank changes without interrupting invoice processing.
-
Time-controlled payment data: Allow planned changes to take effect on a specific date without manual adjustments during ongoing operations.
-
Structured address data: Ensure compliance with regulatory requirements and improve data quality on invoices.
Steps:
-
Go to Settings > Accounting > E-Invoice & Swiss QR Code > General Settings. Here, the Swiss QR code is managed as a plugin alongside other e-invoicing formats.
-
Click “New setting”.
-
Select the "Swiss QR-Code" Plugin.
-
Set the project to “Apply to all projects” to print the Swiss QR Code globally on invoices, or select a specific project (e.g. “Standard”) to apply the Swiss QR Code only to that project.
-
Select "No Aktion", NON, SCOR or QRR:
-
NON: No Reference will be printed on payment part and receipt.
-
SCOR: A 25-digit reference starting with RF is printed. If you select SCOR, you will need your regular IBAN.
-
QRR: A 27-digit reference is printed. If you select QRR, you will need a QR-IBAN.
-
-
Enter the valid from period to activate the code; the valid from / valid until period defines the timeframe in which the configuration is active, and outside of this period the Swiss QR Code is not used.
-
Enter your address data; structured address data is required to generate a valid Swiss QR Code.
-
Optional: Choose page without letterhead or limit the use to the payment method “Invoice.”
-
Click Save.
|
Field name |
Description |
|---|---|
|
Plugin |
Swiss QR Code |
|
Project |
Defines which projects the plugin activation applies to. Select "Apply to all projects" or a specific project, e.g. "Standard". |
|
Settings |
Select the mode. The mode determines what is printed on the QR code:
|
|
Valid from |
Defines the date from which the activation is valid. |
|
Valid until |
Defines the date until which the activation is valid. |
|
Name |
Specifies the name of your own company for the Swiss QR Code. |
|
Street |
Specifies the street of your company address. |
|
House number |
Specifies the house number of your company address. |
|
Postal code |
Specifies the postal code of your company address. |
|
City |
Specifies the city of your company address. |
|
IBAN |
Specifies the IBAN of your company for the Swiss QR Code. (CH IBAN required) |
|
Page without letterhead |
Creates the QR code page without a letterhead. |
|
Only for invoice payment method |
Activates the Swiss QR Code only for invoices with the payment method “Invoice”. |
Note
Managing the settings:
Swiss QR Code entries are managed like other e-invoice plugins and can be created, edited, or deactivated by setting a “valid until” date.
Multiple configurations per project are possible, for example in the case of IBAN changes or organizational changes, which are controlled via the respective validity periods.
Caution
For Xentral versions up to the end of 2025, the existing Swiss QR Code settings continue to apply, while from version 2026 onwards the configuration is located in the E-Invoicing area and has been expanded with additional features such as project settings and validity periods.
Steps:
-
Go to Smart-Search Swiss QR or Settings > Accounting > Payments & Bank Accounts > Swiss QR Code .
-
Select a Mode. This determines what will be printed on the QR code:
NON: No Reference will be printed on payment part and receipt.
SCOR: A 25-digit reference starting with RF is printed. If you select SCOR, you will need your regular IBAN.
QRR: A 27-digit reference is printed. If you select QRR, you will need a QR-IBAN.
-
Own IBAN: Enter your own IBAN or QR-IBAN, depending on the module you selected above.
-
Optional: Enter your BESR ID. The BESR ID is your 6-digit individual bank customer number.
-
Click Save.
Note
-
If you want to hide the footer of your letterhead on the last page, select Page Without letterhead.
-
If you want to print the Swiss QR code only on documents with the payment method Invoice, check the box Only for invoice payment mode.
The Swiss QR Code is printed on the last page of the invoice if Switzerland is specified as the country in the invoice - i.e. if the billing address or the deviating billing address is Switzerland (CH). The Swiss QR Code is printed at the bottom of the last page of the invoice so that your customer can detach the code and the receipt from the invoice.
Note
The QR Code is not displayed in draft mode! In order for the QR code to be displayed, the invoice must have an invoice number, i.e. the invoice must be approved.