QR-BILL-BARCODE-MISSING-001 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) to be processed

ID: banking/swiss-qr-iban-barcode

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

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.

generic

中文

瑞士 QR-IBAN 是 QR 账单标准（ISO 20022）的一部分，要求发票包含瑞士 QR 码（一种二维条码），其中包含结构化支付数据（IBAN、金额、参考号、收款人信息）；没有此条码，银行无法处理发票进行自动支付，手动输入容易出错。

Official Documentation

https://www.six-group.com/en/products-services/banking-services/payments/qr-bill.html

Workarounds

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

中文步骤

  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')"`
  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)
  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

Dead Ends

Common approaches that don't work:

  1. 92% fail

    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

  2. 95% 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

  3. 70% 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