Ilmainen työkalu
Y-tunnushaku: yrityshaku Y-tunnuksella tai nimellä
Kirjoita suomalaisen yrityksen Y-tunnus tai nimi ja saat yrityksen tiedot kaupparekisteristä: virallinen nimi, yhtiömuoto, tila ja kaupunki, suoraan. Tarkiste (modulo 11) tarkistetaan selaimessasi ennen hakua, joten kirjoitusvirhe huomataan heti.
Sama haku curlilla
curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=0112038-9&country=FI" \ -H "Authorization: Bearer rk_live_your_api_key"
Mikä on Y-tunnus?
Etsitkö YTJ:tä? YTJ on PRH:n ylläpitämä yritys- ja yhteisöhaku, jossa yrityksiä voi hakea nimellä, Y-tunnuksella tai LEI-koodilla. Tämä työkalu ei ole YTJ eikä virallinen lähde: se on nopea haku Y-tunnuksella tai nimellä, joka näyttää tietueen, jonka saat Prometiam-rajapinnasta.
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.
Etsi yrityksen Y-tunnus nimellä
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 omalla rivillään. Koodista sama onnistuu name-parametrilla: GET /companies/search?name=Nokia&country=FI.
Mitä haku palauttaa
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ä ei ole, mutta rekisterin muutostapahtumat ja seuranta ovat käytettävissä, 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: 500 krediittiä, 10 pyyntöä minuutissa, mitään ei veloiteta ennen kokeilun päättymistä, ja tilauksen jälkeen sama avain toimii edelleen. Katso hinnat ja hakuparametrit dokumentaatiosta.
Usein kysyttyä
Mistä löydän yrityksen Y-tunnuksen?
Kirjoita yrityksen nimi hakukenttään, jolloin jokaisen osuman Y-tunnus näkyy omalla rivillään. Y-tunnus näkyy myös YTJ:n yrityshaun tuloksissa. Tunnuksen tarkiste tarkistetaan hakua ennen.
Onko tämä sama kuin YTJ?
Ei. YTJ on PRH:n palvelu, ja tämä työkalu hakee kaupparekisterin tietoja Prometiam-rajapinnan kautta eikä ole virallinen lähde. Tarvitsetko rekisterin omat tiedot, käytä YTJ:tä.
Mikä on Y-tunnus?
Y-tunnus on yrityksen ja yhteisön yksilöivä tunnus: seitsemän numeroa, yhdysmerkki ja tarkiste, esimerkiksi 0112038-9. Siitä muodostuu myös ALV-tunnus, kun yritys on arvonlisäverovelvollinen.
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 14 päivän kokeilu kattaa 500 krediittiä.