Kirjoita yrityksen Y-tunnus (esimerkiksi 0112038-9) tai valmis ALV-numero. Sivu muodostaa Y-tunnuksesta ALV-numeron (FI01120389) ja kysyy VIES-palvelusta, onko numero voimassa juuri nyt.
Y-tunnus tai ALV-numero (FI…)
curl "https://api.prometiam.com/functions/v1/risk-api/vat/FI01120389" \ -H "Authorization: Bearer YOUR_API_KEY"
Suomalaisen yrityksen ALV-numero koostuu maatunnuksesta FI ja Y-tunnuksen kahdeksasta numerosta ilman yhdysmerkkiä eli väliviivaa. Verohallinnon mukaan arvonlisäverovelvolliset elinkeinonharjoittajat muodostavat numeronsa itse juuri näin. Nokia Oyj:n Y-tunnuksesta 0112038-9 tulee ALV-numero FI01120389, ja Fortum Oyj:n tunnuksesta 1463611-4 tulee FI14636114. Sivu tekee muunnoksen selaimessasi, ennen kuin lähetät mitään.
| Vaihe | Tulos |
|---|---|
| Y-tunnus sellaisenaan | 0112038-9 |
| Yhdysmerkki pois | 01120389 |
| Maatunnus FI eteen | FI01120389 |
| Voimassaolo VIES-palvelusta | voimassa tai ei vahvistettu tarkistushetkellä |
Samalle numerolle on monta nimeä. Verohallinto puhuu arvonlisäverotunnisteesta, mutta käytännössä sanotaan ALV-numero, ALV-tunnus tai ALV-tunniste, ja englanniksi VAT number. Kyse on aina samasta FI-alkuisesta tunnuksesta, jonka yritys ilmoittaa laskussa EU:n sisäisessä kaupassa.
Muodostettu numero ei vielä todista mitään. Jokaisella yrityksellä on Y-tunnus, mutta ALV-numero on voimassa vain, kun yritys on merkitty arvonlisäverovelvollisten rekisteriin. Siksi sivu ei pysähdy numeron muodostamiseen vaan kysyy VIES-palvelusta, onko se voimassa.
Voit kirjoittaa kenttään myös valmiin ALV-numeron maatunnuksen kanssa. Sivu tarkistaa muodon ja kysyy numeron VIES-palvelusta sellaisenaan, myös muiden EU-maiden numeroiden osalta. Eri maiden ALV-numeroiden muodot listaa englanninkielinen VAT number checker.
Arvonlisäverovelvollisten rekisteriä, lyhyemmin ALV-rekisteriä, pitää Verohallinto. Verohallinnon ohjeen (päivitetty 18.5.2026) mukaan yritys on yleensä arvonlisäverovelvollinen, kun se myy tavaroita tai palveluita liiketoimintana. Rekisteriin ilmoittautuminen on pakollista, kun liiketoiminnan liikevaihto ylittää 20 000 euroa kalenterivuodessa, ja joissakin tapauksissa yritys voi hakeutua siihen vapaaehtoisesti jo aiemmin. Jos yrityksellä on jo Y-tunnus, se voi ilmoittautua OmaVerossa tai YTJ:n asiointipalvelussa muutosilmoituksella. Tietyt toimialat, kuten rahoitus- tai vakuutuspalvelut, on arvonlisäverolaissa määritelty kokonaan arvonlisäverottomiksi, eikä tällaisesta toiminnasta voi rekisteröityä ALV-rekisteriin.
Yrityksellä voi siis olla Y-tunnus mutta ei voimassa olevaa ALV-numeroa: liikevaihto voi jäädä rekisteröitymisrajan alle, toimiala voi olla arvonlisäveroton, rekisteröinti voi olla vasta käsittelyssä tai yritys on poistunut rekisteristä esimerkiksi lopetettuaan toimintansa. Silloin Y-tunnuksesta muodostettu FI-numero ei ole voimassa.
Kuuluuko yritys ALV-rekisteriin, selviää YTJ:stä. Verohallinnon mukaan palvelusta voi tarkistaa, mistä alkaen yrityksen rekisteröinti on voimassa ja mihin rekistereihin yritys kuuluu; uuden yrityksen tiedot näkyvät siellä vasta, kun Verohallinto on käsitellyt rekisteröinnin. YTJ:n yritys- ja yhteisöhaku toimii Y-tunnuksella, nimellä tai LEI-tunnuksella. Prometiamin rajapinnassa rekisterin tieto tulee kentissä vat_number ja vat_number_source (ks. alla), ja maksuton Y-tunnus-haku näyttää yrityksen perustiedot kaupparekisteristä.
VIES (VAT Information Exchange System) on Euroopan komission palvelu, jolla tarkistetaan EU-maiden ALV-numeroiden voimassaolo. EU:lla ei ole yhteistä ALV-rekisteriä: VIES-palvelun ohjeen mukaan kysely lähtee numeron myöntäneen jäsenvaltion omaan tietokantaan ja vastaus tulee reaaliaikaisesti. Suomalaisen numeron vastaus perustuu siis Suomen omiin tietoihin, ei tämän sivun tai Prometiamin aineistoon. Verohallinto neuvoo tarkistamaan uuden kauppakumppanin numeron aina ennen kuin sitä käytetään EU-kaupan laskutuksessa ja vanhojenkin kumppanien numerot säännöllisesti.
Rajapinnan kutsut tekevät saman kuin sivu. GET /vat/FI01120389 kysyy VIES-palvelusta ja palauttaa data-oliossa kentät is_valid, name, address ja request_date. GET /companies/search?country=FI&company_number=0112038-9 palauttaa yrityksen tiedot ja ALV-numeron kentässä vat_number. Kun rekisteri vahvistaa ALV-rekisteröinnin, vat_number_source on register. Jos rekisteri kertoo, ettei yritys ole ALV-rekisterissä, vat_number on null. Jos rekisteri ei kerro rekisteröinnistä mitään, numero on vain muodostettu Y-tunnuksesta (rule), ja voimassaolon vahvistaa vasta /vat-kutsu.
# 1. Tarkista ALV-numero VIES-palvelusta curl 'https://api.prometiam.com/functions/v1/risk-api/vat/FI01120389' \ -H 'Authorization: Bearer rk_live_...' # 2. Hae yritys Y-tunnuksella: mukana vat_number ja vat_number_source curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=FI&company_number=0112038-9' \ -H 'Authorization: Bearer rk_live_...' # 3. Käänteinen haku: yritys ALV-numerolla curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=FI&vat=FI01120389' \ -H 'Authorization: Bearer rk_live_...'
import os, requests
API = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}
def alv_tarkistus(y_tunnus: str):
haku = requests.get(f'{API}/companies/search', headers=HEAD,
params={'country': 'FI', 'company_number': y_tunnus}).json()
yritys = haku['data'][0]
alv = yritys.get('vat_number')
if not alv: # rekisteri: yritys ei ole ALV-rekisterissä
return {'nimi': yritys['company_name'], 'alv': None}
vies = requests.get(f'{API}/vat/{alv}', headers=HEAD).json()['data']
return {'nimi': yritys['company_name'], 'alv': alv,
'voimassa': vies['is_valid'], 'tarkistettu': vies['request_date']}
print(alv_tarkistus('0112038-9'))
Käänteinen haku toimii myös: vat=FI01120389 löytää yrityksen ALV-numerolla, ja name=-haku palauttaa yrityksen Y-tunnuksen ja ALV-numeron, kun et tiedä tunnusta. Useamman yrityksen tarkistus onnistuu POST /companies/lookup -kutsulla, joka hakee jopa 100 yritystä kerralla ja palauttaa jokaisesta saman yritystietueen, vat_number mukaan lukien.
Onnistunut VIES-tarkistus ja yrityshaku maksavat kumpikin 1 krediitin; virheet eivät maksa mitään. Eräajossa jokainen yritys maksaa 1 krediitin. Starter (9,99 € kuukaudessa) sisältää 1 000 krediittiä kuukaudessa, Professional (29,99 €) 10 000 ja Scale (99,99 €) 50 000. 14 päivän kokeilu sisältää 500 krediittiä; kortti vaaditaan, kokeilun aikana ei veloiteta mitään, ja sen jälkeen jatkuu Starter, ellet peru.
POST /monitor) ilmoittaa tilan, nimen, yhtiömuodon ja rekisteröidyn osoitteen muutoksista, ei ALV-rekisteröinnin muutoksista. Tarkista tärkeiden toimittajien ja asiakkaiden numerot uudelleen sopimuskauden aikana.Rekisteritiedot: Contains data from the Finnish Patent and Registration Office (PRH), CC BY 4.0. VIES-vastaus: Euroopan komission VIES-palvelu.
Viimeksi tarkistettu 16.10.2026. Lähteet: Verohallinnon sivut arvonlisäverotunniste (päivitetty 1.10.2024) ja ALV-rekisteröinti (päivitetty 18.5.2026), YTJ sekä VIES.
Aloita 14 päivän ilmainen kokeilu · API-dokumentaatio
Kokeilu kestää 14 päivää ja sisältää 500 krediittiä. Kortti vaaditaan, kokeilun aikana ei veloiteta mitään; sen jälkeen jatkuu Starter-paketti (9,99 € kuukaudessa), ellet peru.