Swiss QR-bill
Swiss QR-bill korvasi sveitsiläiset oranssin ja punaisen tilisiirtolomakkeen heinäkuussa 2020. Se on ISO 20022 Customer Credit Transfer Initiation (pain.001) -hyötykuorma, joka on esitetty QR-koodina pakollisella sveitsiläisellä ristillä keskellä. Jokainen sveitsiläinen pankki hyväksyy sen; mikään sveitsiläinen pankki ei hyväksy mitään muuta.
ISO-perusta: ISO 20022
pain.001 Customer Credit Transfer Initiation. Pakollinen alkaen: 1. heinäkuuta 2020. Vanhat oranssi/punaiset tilisiirtolomakkeet poistuivat käytöstä 30. syyskuuta 2022.
Mitä se on
Hyötykuorma on rivinvaihdolla (CRLF) eroteltu lista 32 kentästä jaettuna seitsemään lohkoon:
QRType → Aina "SPC" Version → 0200 (v2.3) Coding → 1 (Latin-1) [Creditor Information] ← 7 kenttää (IBAN + osoite) [Ultimate Creditor] ← 7 kenttää (valinnainen, yleensä tyhjä) [Payment Amount Information] ← 3 kenttää (summa, valuutta, eräpäivä) [Ultimate Debtor] ← 7 kenttää (valinnainen) [Payment Reference] ← 2 kenttää (viitetyyppi + viite) [Additional Information] ← 2 kenttää (jäsentämätön viesti + laskutieto) [Alternative Procedures] ← 2 kenttää (valinnainen, harvoin käytetty)
Tuloksena oleva QR sijaitsee laskun alimmassa kolmanneksessa olevassa maksuosa-lohkossa. Jokainen sveitsiläinen pankkisovellus (UBS, ZKB, PostFinance, Raiffeisen, Neon, Yuh, Revolut CH) lukee sen natiivisti.
QR-IBAN vs. tavallinen IBAN
"QR-IBAN" on erityinen sveitsiläinen IBAN, jossa 5-numeroinen pankkikoodiväli on 30000–31999. QR-IBANit vaativat jäsennellyn QR-viitteen (QRR, 27 numeroa, mod-10). Tavalliset sveitsiläiset IBANit hyväksyvät velkojaviitteen (SCOR, RFC 8905) tai ei viitettä.
| Velkojan IBAN-tyyppi | Kelvolliset viitetyypit | Huomiot |
|---|---|---|
| QR-IBAN (pankkikoodi 30000–31999) | QRR (27-numeroinen, mod-10) | Pakollinen. SCOR ja NON ovat virheellisiä. |
| Tavallinen IBAN (CH tai LI) | SCOR tai NON | QRR on virheellinen, vain QR-IBAN. |
Kanoniset testvektorit
| Tapaus | Syötteet | Viitetyyppi |
|---|---|---|
| Minimaalinen (tavallinen IBAN, ei summaa, ei viitettä) | iban=CH9300762011623852957 | NON |
| Tavallinen IBAN summalla + jäsentämätön viesti | (sama kuin yllä)amount=100.00 | NON |
| QR-IBAN QRR-viitteellä | iban=CH4431999123000889012 | QRR |
| Liechtensteinin IBAN | iban=LI0508800000021904015 | NON |
Live sveitsiläinen IBAN-validaattori
Alla oleva validaattori tarkistaa kolme Sveitsi-kohtaista sääntöä: (1) maakoodi on CH tai LI, (2) pituus on täsmälleen 21, (3) ISO 7064 mod-97-tarkistussumma hyväksytään. Liitetty syöte normalisoidaan (kirjainkoko ja välilyönnit poistetaan).
Yleiset sudenkuopat
- Väärä viitetyyppi IBAN-tyypille. QR-IBAN, jossa on NON- tai SCOR-viite, hylätään pankissa. Tavallinen IBAN QRR-viitteellä hylätään myös. Abundera valitsee oikean tyypin automaattisesti; käsinrakennetut koodarit menevät usein tässä vikaan.
- Puuttuva sveitsiläinen risti -päällystys. QR-laskun spesifikaatio vaatii 7 mm × 7 mm sveitsiläisen lipun (valkoinen risti punaisella, 1 mm valkoinen reunus) keskitettynä QR:ään. Tämä ei ole valinnainen, pankin OCR-pipeline käyttää sitä QR-laskun tunnuksena. Abundera lisää sen automaattisesti.
- QR-moduulin virheenkorjaustaso. Spesifikaatio vaatii ECC-tason M. Korkeammat tai matalammat ECC-tasot tuottavat QR:n, joka näyttää oikealta mutta hylätään pankissa.
- Osoitekentän pituus. Velkojan nimi, katu, postinumero, kaupunki, kukin rajoitettu 70 Latin-1-merkkiin. Liian pitkät merkkijonot katkaistaan hiljaisesti joissakin koodareissa, mikä rikkoo täsmäytyksen.
- Valuutta vain CHF tai EUR. Swiss QR-bill tukee vain kahta valuuttaa. Kaikki muut valuutat hylätään.
- Viite mod-10 vs. mod-97. QRR-viitteet käyttävät mod-10-rekursiivista tarkistussummaa (Luhn-variantti). Älä sekoita mod-97 IBAN-tarkistussummaan. Käsinrakennetut viitegeneraattorit tekevät usein Luhn-tarkistuksen väärin.
- Latin-1, ei UTF-8. Kenttä
Codingon "1" = Latin-1. Ei-Latin-1-merkit (ä/ö/ü selviävät; kyrilliset/kiinalaiset eivät) rikkovat joitakin vanhempia pankkisovelluksia.
Skanneryhteensopivuus
| Lukija | Tuki | Huomiot |
|---|---|---|
| UBS Mobile / PostFinance / ZKB-sovellus | Natiivisti | Jokainen sveitsiläinen pankkisovellus lukee QR-laskut natiivisti. |
| Neon / Yuh / Revolut CH | Natiivisti | Neopankit käsittelevät täydellisen pain.001-hyötykuorman. |
| iOS-kamera | Ei | iOS käsittelee QR-laskun raakana merkkijonona, ei jäsentämistä. Käyttäjän on avattava pankkisovellus. |
| Android-kamera / Google Lens | Ei | Sama, ei natiivijäsentämistä. |
| Kaupallinen OCR (esim. laskupalvelut) | Kyllä | Pankkilaatuiset OCR-työkalut lukevat QR-laskut AP/AR-putkistoihin. |
Katso myös
- /swiss-qr-bill-generator/, generaattori IBAN-validoinnilla sisäänrakennettuna.
- /standards/, takaisin standardien hakemistoon.
- SIX Implementation Guidelines, auktoritatiivinen spesifikaatio.