{
  "id": "banking/switzerland-postfinance-qr-iban-barcode",
  "signature": "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",
  "signature_zh": "AI告诉瑞士自由职业者使用QR-IBAN开具发票，但未提及QR账单需要特定条码格式（瑞士QR码），这在大多数非瑞士会计软件中会失败",
  "regex": "QR.*Code.*invalid.*Swiss|QR-IBAN.*rejected|PostFinance.*eBill.*error",
  "domain": "banking",
  "category": "protocol_error",
  "subcategory": null,
  "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.",
  "root_cause_type": "generic",
  "root_cause_zh": "瑞士QR-IBAN发票（基于ISO 20022）需要结构化的瑞士QR码（2.0版），包含收款人参考、金额和IBAN；非瑞士会计工具（QuickBooks、Xero）生成的标准QR码会被PostFinance的eBill系统拒绝，因为它们缺少强制性的'Swiss'头部和验证规则。",
  "versions": [
    {
      "version": "PostFinance eBill 2024",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Swiss QR Code v2.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "ISO 20022 pain.002.001.10",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Generate a standard QR code using a free online tool and attach it to the invoice",
      "why_fails": "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",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "Use the IBAN directly without the QR code",
      "why_fails": "QR-IBAN invoices require a QR code for automated processing; manual IBAN entry triggers a surcharge (CHF 2-5 per transaction) from PostFinance",
      "fail_rate": 0.75,
      "condition": "",
      "sources": []
    },
    {
      "action": "Switch to a Swiss accounting software like Bexio or Abacus",
      "why_fails": "While this works, it requires migrating all client data and learning a new tool; the issue is the QR code format, not the software",
      "fail_rate": 0.5,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "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.",
      "success_rate": 0.9,
      "how": "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.",
      "condition": "",
      "sources": []
    },
    {
      "action": "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.",
      "success_rate": 0.85,
      "how": "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.",
      "condition": "",
      "sources": []
    },
    {
      "action": "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.",
      "success_rate": 0.8,
      "how": "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.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "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.",
    "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.",
    "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."
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://www.paymentstandards.ch/en/home",
  "official_doc_section": null,
  "error_code": "POSTFINANCE-QR-IBAN-001",
  "verification_tier": "ai_generated",
  "confidence": 0.87,
  "fix_success_rate": 0.8,
  "resolvable": "true",
  "first_seen": "2024-01-22",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}