# AI tells a Swiss freelancer to issue invoices with QR-IBAN without mentioning that the QR bill requires a specific barcode format (Swiss QR Code) that fails in most non-Swiss accounting software

- **ID:** `banking/switzerland-postfinance-qr-iban-barcode`
- **Domain:** banking
- **Category:** protocol_error
- **Error Code:** `POSTFINANCE-QR-IBAN-001`
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

Swiss QR-IBAN invoices (ISO 20022-based) require a structured Swiss QR Code (version 2.0) containing creditor reference, amount, and IBAN; non-Swiss accounting tools (QuickBooks, Xero) generate standard QR codes that PostFinance's eBill system rejects because they lack the mandatory 'Swiss' header and validation rules.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| PostFinance eBill 2024 | active | — | — |
| Swiss QR Code v2.0 | active | — | — |
| ISO 20022 pain.002.001.10 | active | — | — |

## Workarounds

1. **Use the official Swiss QR Code generator from SIX Group (https://www.paymentstandards.ch/) to create a compliant QR code. Paste the JSON payload into your invoice template.** (90% success)
   ```
   Use the official Swiss QR Code generator from SIX Group (https://www.paymentstandards.ch/) to create a compliant QR code. Paste the JSON payload into your invoice template.
   ```
2. **Install the 'Swiss QR Bill' plugin for QuickBooks or Xero (available via app marketplace) that auto-generates compliant QR codes with the correct 'SPC' header.** (85% success)
   ```
   Install the 'Swiss QR Bill' plugin for QuickBooks or Xero (available via app marketplace) that auto-generates compliant QR codes with the correct 'SPC' header.
   ```
3. **Generate a PDF invoice using the `swiss-qr-bill` npm package (Node.js) that outputs a compliant QR code and embeds it in a PDF.** (80% success)
   ```
   Generate a PDF invoice using the `swiss-qr-bill` npm package (Node.js) that outputs a compliant QR code and embeds it in a PDF.
   ```

## Dead Ends

- **Generate a standard QR code using a free online tool and attach it to the invoice** — Standard QR codes lack the 'SPC' (Swiss Payments Code) prefix and mandatory data fields; PostFinance's scanner will reject them with 'QR code not recognized' error (90% fail)
- **Use the IBAN directly without the QR code** — QR-IBAN invoices require a QR code for automated processing; manual IBAN entry triggers a surcharge (CHF 2-5 per transaction) from PostFinance (75% fail)
- **Switch to a Swiss accounting software like Bexio or Abacus** — While this works, it requires migrating all client data and learning a new tool; the issue is the QR code format, not the software (50% fail)