Mandatory fields and technical requirements
| Field | What goes in it |
|---|---|
| Account | QR-IBAN or normal IBAN; sets the reference type |
| Address | Structured fields, mandatory since 21/11/2025 |
| Payment data | Amount and currency (CHF or EUR only) |
| Reference | QRR, SCOR or none (NON) |
QR code size. 46 × 46 mm with a 7 × 7 mm Swiss cross; a stretched or blurry code won't scan.
Reference formats. The QR-reference only works with a QR-IBAN (bank clearing number 30000 to 31999); a normal IBAN combined with a QR-reference makes the document invalid. More under QR-IBAN example.
QR-bill example: what a correct invoice looks like
A fictional graphic designer in Bern invoices a bakery in Thun CHF 1,232.34. She has no QR-IBAN, so like most freelancers she uses "IBAN without reference".
| Field | Example |
|---|---|
| Issuer | Lea Brunner Grafikdesign, Kramgasse 12, 3011 Bern |
| Recipient | Bäckerei Frei GmbH, Thun |
| Invoice no. | 2026-041, due 8 October 2026 |
| Service | Flyer and menu, 12 h at CHF 95 |
| Amount | CHF 1,140.00 + 8.1% VAT = CHF 1,232.34 |
| Account | CH93 0076 2011 6238 5295 7 |
| Message | Invoice 2026-041 (no reference) |
Is the QR-bill mandatory?
If you include a payment slip, it must be the QR-bill. But you don't have to include a slip at all. Since 1 October 2022 no Swiss bank or post office processes orange or red slips. An invoice with your IBAN in plain text is still complete; your client then types the payment manually. eBill is a separate system that requires registration.
Looking for a payment slip (Einzahlungsschein)?
The payment part of the QR-bill is today's payment slip; the generator above creates it for free, with "QR Slip Only" even without the invoice part. How the old orange (ESR) and red (ES) slips differ: payment slip: from ESR to QR payment part (in German).
Check the QR-bill before you send it
- Scan it with your own banking app. Open the PDF, choose "Scan QR code" and compare recipient, IBAN, amount, currency and reference with the printed payment part. If anything differs, don't send it.
- Validate templates at SIX. For templates you reuse, or after switching software, upload the code in the SIX validation portal. You get an error log covering structure, version and mandatory fields.
Read more: adding a QR code to an existing PDF invoice, writing an invoice in Switzerland, Swiss invoice template, VAT for freelancers, VAT management, invoicing software for Switzerland, Bexio alternative, data security and Magic Heidi pricing.
Last updated: 23 September 2026. Reviewed by the Magic Heidi team. For VAT or accounting questions, ask a fiduciary or the FTA. This page is general information, not tax or legal advice.


