# AI tells a Swiss freelancer to issue invoices with QR-IBAN without mentioning that the QR bill requires a specific barcode format (Swiss Payment Standards 2022)

- **ID:** `banking/switzerland-qr-iban-barcode-mandatory`
- **Domain:** banking
- **Category:** protocol_error
- **Error Code:** `SIX-ISO20022-QR-BARCODE-ERR`
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

Switzerland's QR bill standard (ISO 20022-based, mandatory since 2022) requires a specific structured barcode format (Swiss Cross-Border Payment Standard v1.2) embedded in the invoice; without this barcode, banks cannot process the QR-IBAN payment automatically, leading to manual handling fees or rejection.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| Swiss Payment Standards v1.2 (2022) | active | — | — |
| QR Bill Implementation Guidelines v3.0 | active | — | — |
| SIX Interbank Clearing ISO 20022 XML Schema v2.1 | active | — | — |

## Workarounds

1. **Use a certified Swiss payment software (e.g., Bexio, Abacus, or Sage) that generates QR bills with correct barcodes per the Swiss Payment Standards; example: in Bexio, select 'Rechnung mit QR-Rechnung' and ensure the QR-IBAN is correctly formatted** (95% success)
   ```
   Use a certified Swiss payment software (e.g., Bexio, Abacus, or Sage) that generates QR bills with correct barcodes per the Swiss Payment Standards; example: in Bexio, select 'Rechnung mit QR-Rechnung' and ensure the QR-IBAN is correctly formatted
   ```
2. **Generate the QR bill manually using the official SIX XML schema: create an XML file with the required fields (IBAN, amount, creditor, debtor, reference) and convert it to a QR code using the SIX-provided SDK at https://github.com/OpenBankingSwitzerland/qr-bill** (85% success)
   ```
   Generate the QR bill manually using the official SIX XML schema: create an XML file with the required fields (IBAN, amount, creditor, debtor, reference) and convert it to a QR code using the SIX-provided SDK at https://github.com/OpenBankingSwitzerland/qr-bill
   ```
3. **Use the online QR bill generator at https://www.qr-rechnung.ch (official Swiss tool) to create a single invoice; for bulk, use the API with proper ISO 20022 formatting** (80% success)
   ```
   Use the online QR bill generator at https://www.qr-rechnung.ch (official Swiss tool) to create a single invoice; for bulk, use the API with proper ISO 20022 formatting
   ```

## Dead Ends

- **** — Generic QR codes do not follow the structured Swiss payment data format; banks reject them as invalid payment references (95% fail)
- **** — Swiss banks charge a manual processing fee of 5-10 CHF per invoice without a valid QR barcode, and many now reject them entirely (75% fail)
- **** — Each QR barcode contains unique payment reference data (Creditor Reference); reuse is detected and rejected by the bank's fraud system (85% fail)