> For the complete documentation index, see [llms.txt](https://docs.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docbits.com/administration-and-setup/settings/document-processing/module/bar-code-qr-code-extraction/swiss-qr-code.md).

# Swiss QR Bill

## Overview

The **Swiss QR Bill** is the national payment-slip standard that has replaced the orange and red Swiss payment slips since 30 June 2020. Every domestic Swiss invoice — whether from a utility, an insurer, or a business partner — now carries a Swiss QR Bill QR code. DocBits decodes these codes automatically and makes every payment field available through the API response.

### Feature Overview

Swiss QR Bills follow the **ISO 20022** payment standard and are issued in two versions: **v1.0** (early roll-out) and **v2.0** (current). The DocBits extractor supports both. Recognised payloads decode into a full set of payment fields — creditor, debtor, IBAN / QR-IBAN, amount, currency, reference type (QRR, SCOR or NON), structured and unstructured messages, and alternative payment schemes.

<figure><img src="/files/mJJxDuFPWXEXXzMEOa5u" alt="QR Code Extraction Example"><figcaption></figcaption></figure>

#### Key Benefits

* **Zero manual entry** for Swiss invoices: IBAN, amount, reference and creditor flow directly into the document.
* **Both versions covered**: v1.0 and v2.0 are detected automatically.
* **Reference types preserved**: QRR, SCOR and NON are retained exactly as printed, which keeps downstream reconciliation working.

***

### Detection

* Magic prefix: `SPC\n0100` (v1.0) or `SPC\n0200` (v2.0)
* ISO 20022 compliant
* The parser also surfaces `alt-schemes` (alternative payment procedures) when present

### Extracted Fields

All fields use the `swissqr_` prefix:

| Field                                                                                                  | Description                                    |
| ------------------------------------------------------------------------------------------------------ | ---------------------------------------------- |
| `swissqr_account`                                                                                      | IBAN or QR-IBAN of the creditor                |
| `swissqr_creditor_name`                                                                                | Creditor name                                  |
| `swissqr_creditor_street`                                                                              | Creditor street / address line                 |
| `swissqr_creditor_city`                                                                                | Creditor city                                  |
| `swissqr_creditor_postal_code`                                                                         | Creditor postal code                           |
| `swissqr_creditor_country`                                                                             | Creditor country (ISO 3166 alpha-2)            |
| `swissqr_debtor_name`                                                                                  | Debtor name (if printed)                       |
| `swissqr_debtor_street`, `swissqr_debtor_city`, `swissqr_debtor_postal_code`, `swissqr_debtor_country` | Debtor address                                 |
| `swissqr_amount`                                                                                       | Amount (decimal)                               |
| `swissqr_currency`                                                                                     | Currency (ISO 4217) — typically `CHF` or `EUR` |
| `swissqr_reference`                                                                                    | Structured reference (QRR or SCOR)             |
| `swissqr_reference_type`                                                                               | `QRR`, `SCOR` or `NON`                         |
| `swissqr_unstructured_message`                                                                         | Free-text remittance                           |
| `swissqr_bill_information`                                                                             | Structured bill information (S1 / Swico)       |
| `swissqr_alt_schemes`                                                                                  | Alternative procedures (if present)            |

### Sample API Response

```json
{
  "swissqr_account": "CH4431999123000889012",
  "swissqr_creditor_name": "Robert Schneider AG",
  "swissqr_creditor_street": "Rue du Lac 1268",
  "swissqr_creditor_city": "Biel",
  "swissqr_creditor_postal_code": "2501",
  "swissqr_creditor_country": "CH",
  "swissqr_amount": 1949.75,
  "swissqr_currency": "CHF",
  "swissqr_reference": "210000000003139471430009017",
  "swissqr_reference_type": "QRR",
  "swissqr_unstructured_message": "Bill No. 3139 for services 2026"
}
```

***

### How to Enable

Swiss QR Bill parsing is covered by the general **Bar-Code / QR Code Extraction** module toggle — no standard-specific configuration is required.

1. **Navigate to Settings**:
   * From the Dashboard, go to **Settings**.
   * Select **Document Processing** and then choose **Module**.
2. **Enable the Feature**:
   * Scroll down to locate the **Bar-Code / QR Code Extraction** option.
   * Toggle the slider to enable it.

<figure><img src="/files/xGa8CIT7RCOSqnp6d9D8" alt="Barcode and QR Code Extraction Toggle"><figcaption></figcaption></figure>

For a full list of Payment QR Code standards, see the [Overview](/administration-and-setup/settings/document-processing/module/bar-code-qr-code-extraction.md) page.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.docbits.com/administration-and-setup/settings/document-processing/module/bar-code-qr-code-extraction/swiss-qr-code.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.