Tietopalvelurajapinnat

(päivitetty 3.12.2018)

Yleistä

Huoneistotietoja voi tuoda omaan tietojärjestelmään rajapintapalveluiden kautta. Rajapinnan käyttöönotto vaatii sopimuksen ja Maanmittauslaitoksen myöntämän luvan.

Toisaalta erilaisilla palveluntarjoajilla on mahdollisuus tarjota huoneistotietoja omien palvelujensa kautta. Tällöin myös palvelun loppukäyttäjä (esim. pankki tai kiinteistönvälittäjä) tarvitsee luvan tietojen käyttöön. 

Tietopalvelurajapinnat on jaettu tulostepalveluun ja kyselypalveluun. Tulostepalvelusta saa tulos-teita pdf-formaatissa ja kyselypalvelu palauttaa vastauksen json-formaatissa. Palvelut otetaan käyttöön vuoden 2019 aikana.

Alla on luettelo rajapintapalveluihin toteutettavista tuotteista. Tuotteisiin voi tulla muutoksia. Tuotteista tullaan myöhemmin toteuttamaan erilaisia versiota henkilötietojen laajuuden mukaan.

Tulostepalvelu (pdf)

Tuotetta pyydetään palvelusta HTTPS-protokollaan perustuvalla kyselyllä. Metodina on GET. Kyse-lyyn sisältyvät parametrit, joiden mukaista tietoa haetaan. Vastauksena palautetaan pdf-tuloste.

Osakeluettelo

  • yleiskuvaus: yhtiöstä tuotettava tuloste koko yhtiön osakeluettelosta
  • hakuehdot: y-tunnus
  • tietosisältö: tulosteen osioina yhtiön perustiedot ja osakeryhmittäin osakeluetteloon merkityt omistajat

Osakehuoneistotuloste

  • yleiskuvaus: osakeryhmästä tuotettava tuloste mm. vaihdantaan ja panttaukseen
  • hakuehdot: osakeryhmätunnus
  • tietosisältö: tulosteen osioina yhtiön ja osakeryhmän perustiedot, osakeryhmän hallintakohteet, osakeryhmän omistusoikeudet, osakeryhmän panttioikeudet, osakeryhmän vallintarajoitukset ja osakeryhmän muut rajoitukset

Kyselypalvelu (json)
Huoneistotietojen kyselypalvelu toteutetaan REST-tyylisenä rajapintana. Tuotetta pyydetään palve-lusta HTTPS-protokollaan perustuvalla kyselyllä. Metodina on GET. Kyselyyn sisältyvät parametrit, joiden mukaista tietoa haetaan. Vastauksena palautetaan JSON-rakenne. 

Yhtiöiden haku hakuehdoin

  • yleiskuvaus: hakupalvelu yhtiön perustietojen (y-tunnusten) saamiseksi
  • hakuehdot: useita hakuehtoja
  • tietosisältö: yhtiön tunnistetiedot

Yhtiön perustiedot

  • yleiskuvaus: tuote, jossa esitetään yhtiöstä tulosteille tulostuvat perustiedot
  • hakuehdot: y-tunnus
  • tietosisältö: yhtiön perustiedot

Yhtiön osakeluettelo

  • yleiskuvaus: tuote, jossa esitetään tulosteelle "Yhtiön osakeluettelo" tulostuvat tiedot
  • hakuehdot: y-tunnus
  • tietosisältö: yhtiön perustiedot, yhtiön osakeryhmät ja niiden osakeluetteloon merkityt omistajat

Yhtiön hallintakohteet

  • yleiskuvaus: tuote, jossa esitetään yhtiön rakennuksissa olevat huoneistot, autopaikat ja muut tilat sekä rakennusten ulkopuolella olevat autopaikat ja muut tilat.
  • hakuehdot: y-tunnus
  • tietosisältö: yhtiön perustiedot, yhtiön hallintakohteet

Osakeryhmien haku hakuehdoin

  • yleiskuvaus: hakupalvelu osakeryhmän perustietojen (osakeryhmätunnusten) saamiseksi
  • hakuehdot: useita hakuehtoja
  • tietosisältö: osakeryhmän tunnistetiedot

Osakeryhmän perustiedot

  • yleiskuvaus: tuote, jossa esitetään osakeryhmästä tulosteille tulostuvat perustiedot
  • hakuehdot: osakeryhmätunnus
  • tietosisältö: osakeryhmän perustiedot

Osakeryhmän hallintakohteet

  • yleiskuvaus: tuote, jossa esitetään tulosteelle "Osakehuoneistotuloste" tulostuvat osakeryhmän hallintakohteet
  • hakuehdot: osakeryhmätunnus
  • tietosisältö: osakeryhmän perustiedot, osakeryhmän hallintakohteet

Osakeryhmän omistusoikeudet

  • yleiskuvaus: tuote, jossa esitetään tulosteelle "Osakehuoneistotuloste" tulostuvat osakeryhmän omistusoikeudet
  • hakuehdot: osakeryhmätunnus
  • tietosisältö: osakeryhmän perustiedot, osakeryhmälle kirjatut omistusoikeudet (kirjaamisasiat, omistusosuudet ja omistajat)

Osakeryhmän panttioikeudet

  • yleiskuvaus: tuote, jossa esitetään tulosteelle "Osakehuoneistotuloste" tulostuvat osakeryhmän panttioikeudet
  • hakuehdot: osakeryhmätunnus
  • tietosisältö: osakeryhmän perustiedot, osakeryhmälle kirjatut panttioikeudet (kirjaamisasiat, pant-tioikeudet ja pantinsaajat)

Osakeryhmän rajoitukset

  • yleiskuvaus: tuote, jossa esitetään tulosteelle "Osakehuoneistotuloste" tulostuvat osakeryhmän val-lintarajoitukset ja muut rajoitukset
  • hakuehdot: osakeryhmätunnus
  • tietosisältö: osakeryhmän perustiedot, osakeryhmälle kirjatut rajoitusmerkinnät (kirjaamisasiat sekä rajoitusten tiedot)

Koodistot

  • yleiskuvaus: tuote koodistoarvojen selitteiden saamiseksi
  • hakuehdot: ei hakuehtoja
  • tietosisältö: kaikkien tietopalvelukoodistojen koodiarvot ja selitteet

Tietojen kuvaukset

Koodistot, versio 0.11, 7.11.2018

Tietojen kuvaukset, versio 0.1, 8.3.2018

Koodistot, versio 0.1, 8.3.2018