# 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) for automated processing

- **ID:** `banking/qr-iban-barcode-missing`
- **Domain:** banking
- **Category:** config_error
- **Error Code:** `SIX-QR-BARCODE-MISSING`
- **Verification:** ai_generated
- **Fix Rate:** 85%

## Root Cause

Swiss QR-IBAN invoices must include a Swiss QR Code (ISO 20022) with structured creditor and debtor data; omitting the barcode or using a standard QR code causes banks to reject the payment reference, leading to manual processing delays

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| Swiss QR Code v2.0 | active | — | — |
| ISO 20022 pain.001.001.09 | active | — | — |
| SIX Interbank Clearing QR-IBAN rules 2024 | active | — | — |

## Workarounds

1. **Use a Swiss QR bill generator library (e.g., 'npm install swiss-qr-bill') to produce a compliant QR code with embedded payment data in JSON format: 'qrBill.generate({creditor: {name: "Freelancer AG", iban: "CH4431999123456789012"}, debtor: {name: "Client", address: "..."}, amount: 1500.00})'** (92% success)
   ```
   Use a Swiss QR bill generator library (e.g., 'npm install swiss-qr-bill') to produce a compliant QR code with embedded payment data in JSON format: 'qrBill.generate({creditor: {name: "Freelancer AG", iban: "CH4431999123456789012"}, debtor: {name: "Client", address: "..."}, amount: 1500.00})'
   ```
2. **Integrate with a Swiss bank's e-billing API (e.g., PostFinance BillPay) that automatically generates the QR code and validates the format before issuing the invoice** (88% success)
   ```
   Integrate with a Swiss bank's e-billing API (e.g., PostFinance BillPay) that automatically generates the QR code and validates the format before issuing the invoice
   ```
3. **Manually create the QR code using SIX's online validator tool (https://www.swiss-qr-code.org/validator) to ensure compliance, then embed it in the invoice PDF** (80% success)
   ```
   Manually create the QR code using SIX's online validator tool (https://www.swiss-qr-code.org/validator) to ensure compliance, then embed it in the invoice PDF
   ```

## Dead Ends

- **** — Standard QR codes lack the required ISO 20022 data structure; the bank's OCR system cannot parse the payment details (90% fail)
- **** — ESR barcodes are deprecated for QR-IBAN since 2022; banks may reject or charge extra for processing (80% fail)
- **** — Manual payment entry increases error risk and delays; the QR-IBAN reference is not captured, causing reconciliation failures (85% fail)