Kirjoita suomalaisen yrityksen Y-tunnus ja saat yrityksen tiedot kaupparekisteristä: virallinen nimi, yhtiömuoto, tila ja kaupunki, suoraan. Tarkiste (modulo 11) tarkistetaan selaimessasi ennen hakua, joten kirjoitusvirhe huomataan heti.
Jokaisella suomalaisella yrityksellä ja yhteisöllä on Y-tunnus eli yritys- ja yhteisötunnus. Se kirjoitetaan seitsemänä numerona, yhdysmerkkinä ja tarkisteena: 0112038-9 on Nokia Oyj. Viimeinen numero on tarkiste, joka lasketaan seitsemästä ensimmäisestä numerosta painoilla 7, 9, 10, 5, 8, 4 ja 2 modulo 11 -menetelmällä, ja siksi kirjoitusvirhe huomataan ennen hakua. Jos jakojäännös on 1, tarkistetta ei ole olemassa, joten sellaista tunnusta ei koskaan myönnetä.
Samoista numeroista muodostuu yrityksen EU:n ALV-tunnus, kun yritys on arvonlisäverovelvollinen: FI ja kahdeksan numeroa ilman yhdysmerkkiä (FI01120389). Joissakin vanhoissa tunnuksissa on yhdysmerkin edessä vain kuusi numeroa; puuttuva etunolla palautetaan, joten 112038-9 luetaan muodossa 0112038-9. Yhdysmerkki on haussa valinnainen.
Tiedätkö vain yrityksen nimen? Kirjoita nimi kenttään numeron sijaan. Haku tehdään silloin nimellä ja näyttää enintään viisi osumaa, ja jokaisen osuman Y-tunnus näkyy rivillä ”Identifier”. Koodista sama onnistuu name-parametrilla: GET /companies/search?name=Nokia&country=FI.
Haku lähettää tunnuksen Prometiam-rajapintaan ja palauttaa tietueen nimen, yhtiömuodon, tilan ja kaupungin. Aineisto on yrityskohtaista tietoa Suomen kaupparekisteristä: virallinen nimi, yhtiömuoto, tila, rekisteröity osoite, toimialakoodi ja päivämäärät. Avainhenkilöitä, yritystapahtumavirtaa ja seurantaa ei ole, eivätkä yksityiset elinkeinonharjoittajat kuulu Suomen aineistoon. Yritysten maksukyvyttömyysilmoitukset (vain yritykset, ei yksityishenkilöitä) on liitetty yritykseen Y-tunnuksen perusteella.
Koko tietue ja siihen liitetyt ilmoitukset ovat yhden kutsun päässä. Ilmainen avain on 14 päivän kokeilu: 1 000 API-kutsua kuukaudessa, 10 pyyntöä minuutissa, ei luottokorttia, ja tilauksen jälkeen sama avain toimii edelleen. Katso hinnat ja hakuparametrit dokumentaatiosta.
Onko Y-tunnus sama kuin ALV-tunnus?
Y-tunnus on ALV-tunnuksen perusta: suomalainen ALV-tunnus on FI ja Y-tunnuksen kahdeksan numeroa ilman yhdysmerkkiä. Haku ottaa Y-tunnuksen numeromuodossa, ja rajapinnan vat-parametri hyväksyy muodon FI01120389. Se, onko ALV-tunnus voimassa, on eri kysymys, johon vastaa VIES: GET /vat/FI01120389.
Miksi kelvollinen tunnus ei tuota tulosta?
Yksityiset elinkeinonharjoittajat eivät kuulu Suomen aineistoon, rekisteristä poistunut yritys ei välttämättä enää löydy, ja uusi rekisteröinti voi näkyä vasta muutaman päivän kuluttua. Kokeile hakua nimellä.
Voiko haun tehdä koodilla?
Kyllä: GET /companies/search?company_number=0112038-9&country=FI ja API-avain palauttavat saman tietueen JSON-muodossa. Ilmainen kokeilu kattaa 1 000 kutsua kuukaudessa.
Mikä on kaupparekisteri? · Tunnisteiden validaattori (englanniksi) · Y-tunnus lookup (englanniksi) · Suomen yritystiedot rajapinnasta (englanniksi) · API-dokumentaatio · Hinnat