Swiss QR-bill

Swiss QR-billは2020年7月にスイスのオレンジ・赤の振込用紙を置き換えました。スイスのすべての銀行が受け入れ、他のものは受け入れません。中央に必須のスイスクロスオーバーレイが付いたQRにレンダリングされたISO 20022顧客振込依頼（pain.001）ペイロードです。

正式仕様:SIX Swiss Implementation Guidelines for the QR-bill v2.3（2024-04）。
ISO基盤: ISO 20022 pain.001顧客振込依頼。
必須日: 2020年7月1日。レガシーオレンジ・赤の振込用紙は2022年9月30日に廃止。

概要

ペイロードは改行（CRLF）区切りの32フィールドのリストで、7つのブロックに配置されています:

QRType         → 常に"SPC"
Version        → 0200 (v2.3)
Coding         → 1 (Latin-1)
[受取人情報]            ← 7フィールド（IBAN + 住所）
[最終受取人]            ← 7フィールド（オプション、通常空白）
[支払金額情報]          ← 3フィールド（金額、通貨、期日）
[最終債務者]            ← 7フィールド（オプション）
[支払参照]              ← 2フィールド（参照タイプ + 参照）
[追加情報]              ← 2フィールド（非構造化メッセージ + 請求情報）
[代替手続き]            ← 2フィールド（オプション、ほとんど使用されない）

QRはインボイスの下3分の1の「支払い部分」ブロック内に配置されます。すべてのスイス銀行アプリ（UBS、ZKB、PostFinance、Raiffeisen、Neon、Yuh、Revolut CH）がネイティブで読み取れます。

QR-IBANと通常IBANの違い

「QR-IBAN」は5桁の銀行コード範囲が30000〜31999の特別なスイスIBANです。QR-IBANには構造化QR参照（QRR、27桁、mod-10チェック）が必要です。通常のスイスIBANは債権者参照（SCOR、RFC 8905）または参照なし（NON）を受け入れます。

債権者IBANタイプ	有効な参照タイプ	備考
QR-IBAN（銀行コード30000〜31999）	QRR（27桁、mod-10）	必須。SCORとNONは無効。
通常IBAN（CHまたはLI）	SCORまたはNON	QRRは無効, QR-IBANのみ。

標準テストベクター

ケース	入力	参照タイプ
最小（通常IBAN、金額なし、参照なし）	`iban=CH9300762011623852957 name=Acme AG street=Bahnhofstrasse 1 postal=8001 city=Zürich country=CH`	NON
金額 + 非構造化メッセージ付き通常IBAN	（上記と同様） `amount=100.00 message=Invoice 1234`	NON
QRR参照付きQR-IBAN	`iban=CH4431999123000889012 name=Acme AG street=Bahnhofstrasse 1 postal=8001 city=Zürich country=CH amount=250.00 reference=210000000003139471430009017`	QRR
リヒテンシュタインIBAN	`iban=LI0508800000021904015 name=Beispiel AG city=Vaduz country=LI`	NON

ライブスイスIBANバリデーター

以下のバリデーターは3つのスイス固有のルールをチェックします: (1) 国コードがCHまたはLI、(2) 長さが正確に21、(3) ISO 7064 mod-97チェックサムが通過。貼り付けた入力は正規化されます（大小文字、スペースを除去）。

スイスまたはリヒテンシュタインのIBAN

CHまたはLIのIBANを入力して確認してください。

よくある落とし穴

IBANタイプに対して間違った参照タイプ。 NONまたはSCOR参照を持つQR-IBANは銀行で拒否されます。QRR参照を持つ通常のIBANも拒否されます。Abunderaは正しいタイプを自動選択しますが、手動で作成したエンコーダーはしばしばここで間違えます。
スイスクロスオーバーレイの欠如。 QR-billの仕様では7mm×7mmのスイス国旗（赤地に白十字、1mm白ボーダー付き）をQRの中央に配置することが必須です。これはオプションではなく、銀行のOCRパイプラインがQR-billの署名として使用します。Abunderaは自動的にオーバーレイします。
QRモジュールのエラー訂正レベル。 仕様ではECCレベルMが必要です。より高いまたは低いECCレベルは見た目は正しいが銀行で拒否されるQRを生成します。
住所フィールドの長さ。 債権者名、通り、郵便番号、市区町村, 各最大70 Latin-1文字。一部のエンコーダーは超過文字列を静かに切り詰め、調整が壊れます。
通貨はCHFまたはEURのみ。 QR-billは2種類の通貨のみサポートします。それ以外の通貨はすべて拒否されます。
参照 mod-10 vs mod-97。 QRR参照はmod-10再帰チェックサム（Luhnバリアント）を使用します。IBAN mod-97チェックサムと混同しないでください。手動で作成した参照ジェネレーターは間違った方法でLuhnチェックを行うことがよくあります。
Latin-1、UTF-8ではありません。 フィールド Coding は「1」= Latin-1です。Latin-1以外の文字（ä/ö/üは使える；キリル/漢字は使えない）は古い銀行アプリを壊します。

スキャナー互換性

リーダー	サポート	備考
UBS Mobile / PostFinance / ZKBアプリ	ネイティブ	すべてのスイス銀行アプリがQR-billをネイティブで読み取ります。
Neon / Yuh / Revolut CH	ネイティブ	ネオバンクは完全なpain.001ペイロードを処理します。
iOSカメラ	なし	iOSはQR-billを生の文字列として扱います。ユーザーは銀行アプリを開く必要があります。
Androidカメラ / Google Lens	なし	同様, ネイティブ解析なし。
商業OCR（請求書支払いサービスなど）	あり	銀行グレードのOCRツールはQR-billをAP/ARパイプラインに読み込みます。