# 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) to be processed

- **ID:** `banking/swiss-qr-iban-barcode`
- **Domain:** banking
- **Category:** config_error
- **Error Code:** `QR-BILL-BARCODE-MISSING-001`
- **Verification:** ai_generated
- **Fix Rate:** 90%

## Root Cause

Swiss QR-IBANs are part of the QR-bill standard (ISO 20022) that requires invoices to include a Swiss QR Code (a 2D barcode) containing structured payment data (IBAN, amount, reference, creditor info); without this barcode, the invoice cannot be processed by banks for automated payment, and manual entry is error-prone.

## Workarounds

1. **Use a certified QR-bill software (e.g., Swiss QR Bill Generator from SIX, or online tools like bill.com) to generate invoices with the correct Swiss QR Code. Example command using the official Python library: `pip install swiss-qr-bill` then generate with `python -c "from swiss_qr_bill import QRBill; bill = QRBill(account='CH4431999123000889012', creditor={'name': 'Your Name', 'address': 'Street', 'city': 'City'}, amount=100.00); bill.save('invoice.pdf')"`** (95% success)
   ```
   Use a certified QR-bill software (e.g., Swiss QR Bill Generator from SIX, or online tools like bill.com) to generate invoices with the correct Swiss QR Code. Example command using the official Python library: `pip install swiss-qr-bill` then generate with `python -c "from swiss_qr_bill import QRBill; bill = QRBill(account='CH4431999123000889012', creditor={'name': 'Your Name', 'address': 'Street', 'city': 'City'}, amount=100.00); bill.save('invoice.pdf')"`
   ```
2. **If using accounting software (e.g., Bexio, Klara), enable the QR-bill module which automatically generates the barcode; verify that the output includes the Swiss QR Code in the correct format (ISO 20022 XML embedded in the barcode)** (90% success)
   ```
   If using accounting software (e.g., Bexio, Klara), enable the QR-bill module which automatically generates the barcode; verify that the output includes the Swiss QR Code in the correct format (ISO 20022 XML embedded in the barcode)
   ```
3. **For one-off invoices, use the free online QR-bill generator from SIX (https://www.swiss-qr-bill.org/) to create a compliant invoice; download the PDF and include it in your billing process** (88% success)
   ```
   For one-off invoices, use the free online QR-bill generator from SIX (https://www.swiss-qr-bill.org/) to create a compliant invoice; download the PDF and include it in your billing process
   ```

## Dead Ends

- **** — Swiss banks (e.g., UBS, Credit Suisse, PostFinance) require the Swiss QR Code for automated processing; invoices without it are treated as non-standard and may be rejected or delayed, causing payment failures (92% fail)
- **** — The Swiss QR Code has a specific data structure (defined by SIX Group) that includes mandatory fields like creditor address, reference type, and additional information; generic QR codes lack this structure and will not be parsed by bank systems (95% fail)
- **** — Manual entry defeats the purpose of QR-IBAN and increases error risk; banks may still reject manual payments if the QR-IBAN is not linked to a valid QR-bill reference (70% fail)