Tietoa avoimen datan rajapinnoista
Tälle sivustolle on koottu Patentti- ja rekisterihallituksen julkaisema avoin data. Aineisto on koneluettavassa muodossa, maksuton ja vapaasti käytettevissä. Aineistoon sovelletaan Creative Commons Nimeä 4.0 käyttölupaa ja JHS-suositusta. Avoimen datan uudelleenkäyttö ja jatkojalostaminen edellyttää, että palveluntarjoaja ei käytä palveluissaan PRH:n tai YTJ:n logoa tai muutoin sekaannuta palvelua ulkoasullaan alkuperäiseen viralliseen tietolähteeseen.
Avoin data on käytettävissä HTTP-protokollan avulla ja tiedonsiirtoformaattina on Javascript Object Notation (JSON). Tällä hetkellä aineistosta voi tehdä enintään 300 hakua minuutissa, joka jakautuu käyttäjien kesken. Palvelurajapinta tarjoaa parametrisoinnin avulla mahdollisuuden hakea suuremmankin tietojoukon yhdellä haulla, jolloin erillisten hakujen määrää voidaan rajoittaa.
Yksittäiselle tiedon käyttäjälle on kätevää hakea tietoja suoraan www-käyttäliittymää käyttäen Kaupparekisterin kuulutushaun ja YTJ-tietopalvelun kautta.
Kaupparekisterin kuulutustiedot
Kuulutustiedot sisältävät tietoa esim. tänään rekisteröidyistä uusista yrityksistä tai jonkin kunnan alueelle rekisteröidyistä uusista yrityksistä. Kuulutustietona julkaistaan myös yritysten tietojen muuttuminen (kuten hallituksen muutos). Tiedoissa näkyvät rekisterimerkintöjen otsikot (esim. hallitus, kotipaikka, osakepääoman korottaminen).
Tietosisällön kuvaus
Avoimen datan rajapinnasta on saatavilla kuulutustiedot kaupparekisteriin tehdyistä rekisteröinneistä 7.11.2014 alkaen. Ennen 29.8.2014 lakanneiden yritysten tietoja ei näytetä. Tietoja on saatavilla seuraavista yrityksistä ja yhteisöistä:
-
osakeyhtiö, julkinen osakeyhtiö, asunto-osakeyhtiö, osuuskunta, vakuutusyhtiö ja julkinen vakuutusyhtiö.
Kuulutusten tietosisältö:
-
yrityksen Y-tunnus, yrityksen rekisteröintipäivämäärä, yrityksen nimi (toiminimi), mahdolliset
rinnakkais- ja aputoiminimet, yritysmuoto, yrityksen tilanne YTJ-rajapinnan kautta (tieto mahdollisesta konkurssi-,
selvitystila- tai saneerausmenettelystä), yrityksen kotipaikka, osoite- ja yhteystiedot
(posti- ja/tai käyntiosoite sekä seuraavat rekisteröintivelvollisen mahdollisesti ilmoittamat
yhteystiedot: puhelin, matkapuhelin, faksi, www-osoite), viimeisin tietojen rekisteröintiajankohta
rekisterimerkintöjen otsikot (esim. hallitus, kotipaikka, osakepääoman korottaminen) ja rekisteröintipäivämäärä
Aineisto päivitetään kerran vuorokaudessa. Tänään on haettavissa kuulutustiedot eilisen päivän aikana tapahtuneista rekisteröinneistä.
Kuulutustietoja voi hakea Y-tunnuksella. Hakuja voi rajata myös rekisteri-ilmoituksen tyypillä, yrityksen kotipaikalla sekä rekisteröinnin ajankohdalla.
YTJ-tiedot
Avoimen datan rajapinnan kautta on saatavissa PRH:n ja Verohallinnon yhteisen YTJ-tietopalvelun tietoja seuraavista yrityksistä ja yhteisöistä: osakeyhtiö, julkinen osakeyhtiö, asunto-osakeyhtiö, osuuskunta, vakuutusyhtiö, julkinen vakuutusyhtiö. Kaupparekisteriin merkityn yrityksen perustietojen lisäksi palvelussa on tietoa mm. muista rekistereistä, joihin yritys on merkitty (ennakkoperintärekisteri, työnantajarekisteri, arvonlisäverovelvollisten rekisteri, vakuutusmaksuverovelvollisten rekisteri, verohallinnon asiakasrekisteri).
Tietosisällön kuvaus
Yritys- ja yhteisötietojärjestelmään merkitään seuraavat tunniste- ja perustiedot:
-
yritys- ja yhteisötunnus (Y-tunnus)
toiminimi, rinnakkaistoiminimet, aputoiminimet
kotipaikka tai kunta, josta toimintaa johdetaan
posti- ja/tai käyntiosoite sekä seuraavat rekisteröintivelvollisen mahdollisesti ilmoittamat yhteystiedot: puhelin, matkapuhelin, faksi, www-osoite
päätoimiala
kieli (suomi tai ruotsi)
yritysmuoto
tiedot merkitsemisestä seuraaviin rekistereihin:
-
kaupparekisteri
arvonlisäverovelvollisten rekisteri ja rekisteröinnin peruste
työnantajarekisteri
ennakkoperintärekisteri
Aineisto päivitetään kerran vuorokaudessa. Tänään on haettavissa eilisen päivän aikana päivitetyt YTJ-tietopalvelun tiedot.
Tietoa on saatavissa olemassa olevista yrityksistä ja yhteisöistä. Tietoja voi hakea yhdestä yrityksestä kerrallaan Y-tunnuksella. Haun voi myös kohdistaa yritysjoukkoon esim. rajaamalla hakua rekisteröintipäivämäärällä (esim. eilen annetut uudet Y-tunnukset) tai yrityksen nimen alkuosalla (esim. hakea yrityksiä, joiden nimi alkaa kirjaimilla Putkityö). Saatavien hakutulosten määrää voi myös rajoittaa sekä palautettavien tulosten lukumäärällä että tarkentamalla hakukriteereitä.