Erota muototarkistus verotunnisteen voimassaolosta

ALV- ja verotunnisteiden rakenteellinen validointi kassalla tarkistaa tunnisteen muodon valitun maan perusteella. Se ei nykyisen koodin perusteella tee VIES-, verohallinto- tai muuta rekisterikyselyä eikä todista tunnisteen olevan voimassa tai kuuluvan asiakkaalle.

AI Commerce Cloud -kassan laajennettu muototarkistus voi antaa virheen heti kassalla, mutta se ei yksin takaa laadukkaampia verotietoja, vähemmän virhekirjauksia tai sujuvampaa laskutusta. EU-maiden, UK:n ja USA:n tunnisteet on arvioitava toteutuneen koodikattavuuden mukaan, ei yleisen globaalin kattavuuslupauksen perusteella.

Suomenkielinen storefront-kenttä on Y-Tunnus, ja virheilmoitus on Virheellinen y-tunnus. Kansainvälisessä B2B-verotuksessa sama tietokantakenttä voi kuitenkin sisältää EU:n ALV-tunnuksen. Päätä verokohtelu erillisellä hyväksytyllä verosäännöllä, älä pelkän regex-osuman perusteella.

Milloin kassa tarkistaa tunnisteen

ALV- ja verotunnisteiden rakenteellinen validointi kassalla käy läpi asiakas- ja laskutusosion. Tyhjä yritys ja tyhjä verotunniste hyväksytään. Jos jompikumpi on annettu, kenttien pituudet tarkistetaan. Varsinainen maakohtainen muototarkistus tehdään, kun legacySettings-asetus VALIDATE_CLIENT_VAT_ID on käytössä.

Verotunnisteen tietokantapituus on nykyisessä kenttösäännössä 0–14 merkkiä ennen muototarkistusta. Virhe pysäyttää etenemisen ja kohdistuu asiakas- tai laskutusosion verotunnistekenttään. Pakollisuus ei synny tästä validaattorista yksin, joten B2B/B2C-vaatimukset pitää määrittää erikseen.

Näin syöte normalisoidaan

ALV- ja verotunnisteiden rakenteellinen validointi kassalla muuttaa kirjaimet isoiksi sekä poistaa välilyönnit ja viivat. Jos normalisoitu tunniste alkaa valitun maan kaksikirjaimisella maakoodilla, sama etuliite poistetaan ennen maakohtaista tarkistusta.

Tämän vuoksi esimerkiksi Suomen FI12345678, 12345678 ja 1234567-8 päätyvät kahdeksan numeron muototarkistukseen. Etuliitteen käsittely perustuu asiakkaan valittuun maahan; toisen maan etuliitettä ei pidä käyttää keinona ohittaa sääntöä.

Maakohtaiset rakennesäännöt

ALV- ja verotunnisteiden rakenteellinen validointi kassalla käyttää seuraavia nykykoodin sääntöjä normalisoinnin jälkeen:

Ryhmät kattavat nykykoodissa Itävallan, Belgian, Bulgarian, Kyproksen, Tšekin, Saksan, Tanskan, Viron, Kreikan, Espanjan, Suomen, Ranskan, Kroatian, Unkarin, Irlannin, Italian, Liettuan, Luxemburgin, Latvian, Maltan, Alankomaat, Puolan, Portugalin, Romanian, Ruotsin, Slovenian, Slovakian ja Yhdistyneen kuningaskunnan. Maatunnus ja sille tarkoitettu sääntö luetaan yhdessä.

Taulukko kuvaa vain ohjelmiston nykyisen rakennemallin. Se ei vahvista viranomaisten tämänhetkisiä sääntöjä, tarkistusnumeroita, rekisteröintiä tai käännettyä verovelvollisuutta.

Muut maat ja USA:n EIN

ALV- ja verotunnisteiden rakenteellinen validointi kassalla käyttää muille maakoodeille yleissääntöä: vähintään 3 kirjainta tai numeroa, joista vähintään 2 on numeroita. Lähdeartikkelin viiden merkin vähimmäisraja ei vastaa nykyistä koodia.

USA:n EIN-tunnukselle ei löytynyt erillistä yhdeksän numeron sääntöä. USA käyttää samaa yleissääntöä, joten muodoltaan liian väljä tunniste voi läpäistä tarkistuksen. Älä julkaise väitettä EIN-validoinnista ennen erillistä sääntöä, testejä ja verotusomistajan hyväksyntää.

Huomioi Kreikan GR- ja EL-ristiriita

ALV- ja verotunnisteiden rakenteellinen validointi kassalla luokittelee Kreikan EU-maaksi koodilla GR, mutta regex-taulukossa yhdeksän numeron erityissääntö on avaimella EL. Etuliite poistetaan vain, jos se vastaa valittua maakoodia. Näin GR-maavalinta ja EL-verotunniste eivät muodosta yksiselitteistä nykyistä polkua.

Kreikan tunnisteiden julkaisuohje ja tuotantokäyttö ovat estettyjä, kunnes maakoodin normalisointi korjataan tai tarkoitettu sopimus todistetaan. Älä neuvo käyttäjää vaihtamaan maata tai etuliitettä kiertotieksi.

Testaa markkinamaat ja tallennus

ALV- ja verotunnisteiden rakenteellinen validointi kassalla testataan jokaiselle myyntimaalle hyväksytyllä, virheellisellä, liian lyhyellä ja liian pitkällä tunnisteella. Kokeile maakoodi mukana ja ilman, pienet kirjaimet, välilyönnit ja viivat sekä eri asiakas- ja laskutusmaat.

Varmista virheilmoitus, kassalla eteneminen ja tilaukselle tallentuva arvo. Tarkista erikseen lasku, ERP-vienti ja mahdollinen B2B-verokohtelu. Normalisointi tehdään tarkistusta varten; nykyinen funktio ei yksin todista, missä muodossa alkuperäinen arvo tallennetaan.

EU-luokittelu ja ylläpito

ALV- ja verotunnisteiden rakenteellinen validointi kassalla käyttää erillistä EU-jäsenlistaa maaluokitukseen store, eu tai other. Koodin lista on kommentoitu päivälle 15.5.2025 ja sisältää 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 ja SE.

Jäsenlista ja verotunnisteiden regexit ovat ylläpidettäviä sääntöjä, eivät pysyvä lakitaulukko. Nimeä omistaja, seuraa viranomaismuutoksia ja päivitä koodi, testit sekä ohje yhtenä muutoksena. UK/GB ja USA kuuluvat EU-listan ulkopuolelle, vaikka niillä olisi omat tai yleiset muotosäännöt.