POSTFINANCE-QR-IBAN-001 banking protocol_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) that fails in most non-Swiss accounting software

ID: banking/switzerland-postfinance-qr-iban-barcode

Also available as: JSON · Markdown · 中文
80%Fix Rate
87%Confidence
1Evidence
2024-01-22First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
PostFinance eBill 2024 active — — —
Swiss QR Code v2.0 active — — —
ISO 20022 pain.002.001.10 active — — —

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.

generic

中文

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

Official Documentation

https://www.paymentstandards.ch/en/home

Workarounds

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

中文步骤

  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.

Dead Ends

Common approaches that don't work:

  1. Generate a standard QR code using a free online tool and attach it to the invoice 90% fail

    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

  2. Use the IBAN directly without the QR code 75% fail

    QR-IBAN invoices require a QR code for automated processing; manual IBAN entry triggers a surcharge (CHF 2-5 per transaction) from PostFinance

  3. Switch to a Swiss accounting software like Bexio or Abacus 50% fail

    While this works, it requires migrating all client data and learning a new tool; the issue is the QR code format, not the software