SIX-QR-BARCODE-MISSING banking config_error ai_generated true

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

Also available as: JSON · Markdown · 中文
85%Fix Rate
87%Confidence
1Evidence
2024-03-05First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
Swiss QR Code v2.0 active — — —
ISO 20022 pain.001.001.09 active — — —
SIX Interbank Clearing QR-IBAN rules 2024 active — — —

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

generic

中文

瑞士QR-IBAN发票必须包含瑞士QR码（ISO 20022），带有结构化的收款人和付款人数据；省略条码或使用标准QR码会导致银行拒绝付款参考，造成手动处理延迟

Official Documentation

https://www.six-group.com/en/products-services/banking-services/swiss-qr-code.html

Workarounds

  1. 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})' 
    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. 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 
    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. 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 
    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

中文步骤

  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})'
  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
  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

Dead Ends

Common approaches that don't work:

  1. 90% fail

    Standard QR codes lack the required ISO 20022 data structure; the bank's OCR system cannot parse the payment details

  2. 80% fail

    ESR barcodes are deprecated for QR-IBAN since 2022; banks may reject or charge extra for processing

  3. 85% fail

    Manual payment entry increases error risk and delays; the QR-IBAN reference is not captured, causing reconciliation failures