Swiss QR-bill
Swiss QR-bill zastąpił szwajcarskie pomarańczowe i czerwone przekazy w lipcu 2020 roku. To ISO 20022 Customer Credit Transfer Initiation (pain.001) wyrenderowany jako QR z obowiązkową nakładką szwajcarskiego krzyża w centrum. Każdy szwajcarski bank go akceptuje; nic innego nie jest akceptowane.
Podstawa ISO: ISO 20022
pain.001. Obowiązkowy od: 1 lipca 2020. Stare przekazy wycofane 30 września 2022.
Czym to jest
Payload to lista 32 pól (separator CRLF) w siedmiu blokach. Wynikowy QR zajmuje dolną trzecią faktury. Każda szwajcarska aplikacja bankowa (UBS, ZKB, PostFinance, Raiffeisen, Neon, Yuh, Revolut CH) odczytuje go natywnie.
QRType → Zawsze "SPC" Version → 0200 (v2.3) Coding → 1 (Latin-1) [Creditor Information] ← 7 pól (IBAN + adres) [Ultimate Creditor] ← 7 pól (opcjonalne) [Payment Amount Information] ← 3 pola (kwota, waluta, termin) [Ultimate Debtor] ← 7 pól (opcjonalne) [Payment Reference] ← 2 pola (typ + numer referencji) [Additional Information] ← 2 pola (wiadomość + info o rachunku) [Alternative Procedures] ← 2 pola (opcjonalne)
QR-IBAN vs zwykły IBAN
«QR-IBAN» to specjalny szwajcarski IBAN, gdzie zakres 5-cyfrowego kodu banku wynosi 30000–31999. QR-IBAN wymaga strukturyzowanej referencji QR (QRR, 27 cyfr, mod-10). Zwykłe szwajcarskie IBAN akceptują referencję wierzyciela (SCOR) lub brak referencji.
| Typ IBAN wierzyciela | Dopuszczalne typy referencji | Uwagi |
|---|---|---|
| QR-IBAN (kod banku 30000–31999) | QRR (27 cyfr, mod-10) | Wymagane. SCOR i NON są nieprawidłowe. |
| Zwykły IBAN (CH lub LI) | SCOR lub NON | QRR jest nieprawidłowy, tylko dla QR-IBAN. |
Kanoniczne wektory testowe
| Przypadek | Dane wejściowe | Typ referencji |
|---|---|---|
| Minimalny (zwykły IBAN, bez kwoty, bez referencji) | iban=CH9300762011623852957 | NON |
| Zwykły IBAN z kwotą + nieustrukturyzowaną wiadomością | (jw.)amount=100.00 | NON |
| QR-IBAN z referencją QRR | iban=CH4431999123000889012 | QRR |
| IBAN Liechtensteinu | iban=LI0508800000021904015 | NON |
Walidator szwajcarskiego IBAN
Poniższy walidator sprawdza trzy szwajcarskie reguły: (1) kod kraju CH lub LI, (2) długość dokładnie 21, (3) suma kontrolna ISO 7064 mod-97 poprawna.
Typowe pułapki
- Zły typ referencji dla typu IBAN. QR-IBAN z referencją NON lub SCOR jest odrzucany przez bank. Abundera automatycznie wybiera właściwy typ.
- Brak nakładki szwajcarskiego krzyża. Specyfikacja wymaga flagi Szwajcarii 7 mm × 7 mm na środku QR. Abundera nakłada ją automatycznie.
- Poziom korekcji błędów modułu QR. Specyfikacja wymaga ECC poziomu M.
- Długość pól adresowych. Imię wierzyciela, ulica, kod pocztowy, miasto, każde ograniczone do 70 znaków Latin-1.
- Tylko CHF lub EUR. QR-bill obsługuje tylko dwie waluty.
- Mod-10 vs mod-97. Referencje QRR używają mod-10 (wariant Luhna), nie mod-97 IBAN.
- Latin-1, nie UTF-8. ä/ö/ü działają; cyrylica/chiński nie.
Kompatybilność skanerów
| Czytnik | Obsługa | Uwagi |
|---|---|---|
| UBS Mobile / PostFinance / ZKB app | Natywna | Każda szwajcarska aplikacja bankowa odczytuje QR-bill natywnie. |
| Neon / Yuh / Revolut CH | Natywna | Neobanki obsługują pełny payload pain.001. |
| Kamera iOS | Nie | iOS traktuje QR-bill jako surowy ciąg, bez parsowania. Użytkownik musi otworzyć aplikację bankową. |
| Kamera Android / Google Lens | Nie | Tak samo, brak natywnego parsowania. |
| Komercyjny OCR | Tak | Narzędzia OCR klasy bankowej odczytują QR-bill do potoków AP/AR. |
Zobacz też
- /swiss-qr-bill-generator/, generator z walidacją IBAN.
- /standards/, powrót do indeksu standardów.