# AI告诉瑞士自由职业者使用QR-IBAN开具发票，但未提及QR账单需要特定条码格式（瑞士QR码），这在大多数非瑞士会计软件中会失败

- **ID:** `banking/switzerland-postfinance-qr-iban-barcode`
- **领域:** banking
- **类别:** protocol_error
- **错误码:** `POSTFINANCE-QR-IBAN-001`
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

瑞士QR-IBAN发票（基于ISO 20022）需要结构化的瑞士QR码（2.0版），包含收款人参考、金额和IBAN；非瑞士会计工具（QuickBooks、Xero）生成的标准QR码会被PostFinance的eBill系统拒绝，因为它们缺少强制性的'Swiss'头部和验证规则。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| PostFinance eBill 2024 | active | — | — |
| Swiss QR Code v2.0 | active | — | — |
| ISO 20022 pain.002.001.10 | active | — | — |

## 解决方案

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.
   ```
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.
   ```
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.
   ```

## 无效尝试

- **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% 失败率)
- **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% 失败率)
- **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% 失败率)
