Miten ALV- / verotunnisteet validoidaan kassalla?
AI Commerce tarkistaa verotunnisteet maakohtaisilla säännöillä ja näyttää virheet heti – vähemmän korjauksia, nopeampi laskutus.
Written by Petro Mäntylä
Updated at September 30th, 2025
Sisällysluettelo
Tässä ohjeessa kuvataan AI Commerce Cloud ‑kassan laajennettu ALV/verotunnisteen validointi. Hyötynä saat laadukkaammat verotiedot, vähemmän virhekirjauksia ja sujuvamman laskutuksen. Ominaisuus kattaa kaikki EU‑maat sekä yleisesti käytetyt globaalit muodot (mm. UK ja USA:n EIN) ja ilmoittaa virheet reaaliajassa.
Mitä uutta ja miksi tämä on tärkeää
- Maatietoiset rakennemääritykset: jokaisen maan tunniste tarkistetaan erikseen, mukaan lukien vaaditut etuliitteet (esim. AT‑tunnuksissa U‑alku).
- Älykäs varmuusvalidaatio: maihin, joille ei ole erillistä sääntöä, sovelletaan vähimmäissääntöä – vähintään 5 merkkiä ja vähintään 2 numeroa – mikä karsii roskapostia ja paikanvaraustietueita.
- Reaaliaikainen virheiden tunnistus: väärät tai puutteelliset muodot merkitään heti kassalla, mikä vähentää manuaalisia korjauksia kirjanpidossa ja veroilmoituksissa.
Miten validointi toimii kassalla
- Asiakas valitsee maan. Järjestelmä luokittelee ostajan maan suhteessa kaupan maahan: “store”, “eu” tai “other” (EU‑jäsenlista alla).
- Tarkistuksessa syöte puhdistetaan. Välilyönnit ja viivat poistetaan, kirjaimet muutetaan isoiksi ja mahdollinen maatunnus alussa (esim. FI, SE, AT) tunnistetaan ja käsitellään automaattisesti.
- Muototarkistus. Jos maalle on määritelty sääntö, tarkistus tehdään sen mukaan. Muutoin käytetään vähimmäissääntöä (≥5 merkkiä ja ≥2 numeroa).
- Palaute heti. Virheellinen muoto näyttää selkeän virheilmoituksen; oikea muoto hyväksytään ja tilausta voi jatkaa.
- Laadukkaat tiedot. Hyväksytyt tunnisteet tallentuvat tilaukselle ja laskulle tarkastusta varten.
Pikaesimerkit (hyväksyttävät muodot)
| Maa | Esimerkkimuoto | Huomio |
|---|---|---|
| Itävalta (AT) | ATU12345678 tai U12345678 | U‑etuliite vaaditaan; AT‑maatunnus voi olla mukana tai pois. |
| Ruotsi (SE) | SE123456789012 tai 123456789012 | 12 numeroa. |
| Suomi (FI) | FI12345678, 12345678 tai 1234567-8 | 8 numeroa; viivan ja välilyöntien käyttö sallittu syötössä. |
Sallitut muodot maittain (EU + UK)
Alla olevat säännöt kuvaavat, millainen ALV‑/verotunniste kassalla hyväksytään kussakin maassa. Maatunnus alussa (esim. FR, NL, GB) on valinnainen; järjestelmä käsittelee sen automaattisesti. Kreikan verotunniste käyttää etuliitettä EL.
| Maatunnus | Sääntö (kirjain/numero) | Esimerkki |
|---|---|---|
| AT (Itävalta) | U + 8 numeroa | ATU12345678 |
| BE (Belgia) | 10 numeroa | 1234567890 |
| BG (Bulgaria) | 9–10 numeroa | 123456789 |
| CY (Kypros) | 8 numeroa + kirjain | 12345678X |
| CZ (Tšekki) | 8–10 numeroa | 1234567890 |
| DE (Saksa) | 9 numeroa | 123456789 |
| DK (Tanska) | 8 numeroa | 12345678 |
| EE (Viro) | 9 numeroa | 123456789 |
| EL (Kreikka) | 9 numeroa | 123456789 |
| ES (Espanja) | kirjain/numero + 7 numeroa + kirjain/numero | X1234567X |
| FI (Suomi) | 8 numeroa | 12345678 |
| FR (Ranska) | 2 merkkiä (A–Z tai 0–9) + 9 numeroa | AB123456789 |
| HR (Kroatia) | 11 numeroa | 12345678901 |
| HU (Unkari) | 8 numeroa | 12345678 |
| IE (Irlanti) | 7 numeroa + kirjain (+ mahdollinen toinen kirjain) | 1234567T tai 1234567TW |
| IT (Italia) | 11 numeroa | 12345678901 |
| LT (Liettua) | 9 tai 12 numeroa | 123456789 tai 123456789012 |
| LU (Luxemburg) | 8 numeroa | 12345678 |
| LV (Latvia) | 9 numeroa | 123456789 |
| MT (Malta) | 8 numeroa | 12345678 |
| NL (Alankomaat) | 9 numeroa + B + 2 numeroa | 123456789B01 |
| PL (Puola) | 10 numeroa | 1234567890 |
| PT (Portugali) | 9 numeroa | 123456789 |
| RO (Romania) | 2–10 numeroa | 12 tai 1234567890 |
| SE (Ruotsi) | 12 numeroa | 123456789012 |
| SI (Slovenia) | 8 numeroa | 12345678 |
| SK (Slovakia) | 10 numeroa | 1234567890 |
| GB (Yhdistynyt kuningaskunta) | GD/HA + 3 numeroa TAI 9 numeroa (+ valinnainen 3 numeroa) | GD123, HA321, 123456789, 123456789000 |
Muut maat ja globaalit tunnisteet
- USA (EIN): 9 numeroa. Viivat ja välilyönnit voidaan syöttää; ne poistetaan tarkistuksessa.
- Muut maat: vähimmäissääntö – tunnisteen on oltava vähintään 5 merkkiä pitkä ja sisällettävä vähintään 2 numeroa.
- Yleistä: syötteen alussa oleva maatunnus (esim. FI, FR, GB) on valinnainen; välilyönnit ja viivat ohitetaan tarkistuksessa.
EU‑alueen luokittelu verosääntöjä varten
Kaupan logiikka käyttää EU‑jäsenlistaa (15.5.2025) maaluokituksiin: AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE. Huomio: Kreikan verotunnisteen etuliite on EL, vaikka maakoodeissa käytetään GR.
Vinkkejä onnistuneeseen käyttöön
- Näytä kassakentässä esimerkkimuotoja (esim. “NL123456789B01”, “FI12345678”) vähentääksesi hylkäyksiä.
- Jos myyt B2C:lle, pidä verotunniste valinnaisena; B2B‑tilauksille suositellaan pakolliseksi maissa, joissa se on arjen käytäntö.
- UK‑kaupoissa huomioi sekä GD/HA‑tunnukset että 9/12‑numeroiset muodot.
- USA‑tilauksille voit käyttää EIN‑tunnusta; syötä se ilman/viivalla – järjestelmä hyväksyy molemmat.
Yhteenveto ja seuraava askel
Laajennettu validointi varmistaa, että kassalla kerätyt verotunnisteet ovat muodoltaan oikein maakohtaisten sääntöjen mukaan. Suositus: testaa muutama tyypillinen tunniste markkinamaissasi yllä olevan taulukon avulla ja varmista, että mahdolliset ohjetekstit kassalla kertovat oikean syöttömuodon.
Avainsanat
- ALV‑tunnus
- verotunniste
- VAT ID
- EIN
- kassaprosessi
- AI Commerce Cloud
- EU‑verosäännöt
- UK VAT
- kenttien pituusrajat
- laskutus ja verotus