Hyppää pääsisältöön

Huoneistotietojen kyselypalvelu isännöintijärjestelmille (REST)

Huoneistotietojen kyselypalvelun kautta taloyhtiöt saavat käyttöönsä ajantasaisia huoneistotietojärjestelmän tietoja suoraan omaan sovellukseensa. 

Rajapintapalvelun käyttöönotto edellyttää, että taloyhtiö kuuluu huoneistotietojärjestelmään.

Taloyhtiön edustajalla, yleensä isännöitsijällä, on oikeus ainoastaan hallinnoimiensa taloyhtiöiden tietoihin.

Palvelu on käytettävissä 24/7. Rajapinnan tuki palvelee ma–pe 8–16.

Taulukossa on esitetty tällä hetkellä tuotannossa olevat tuotteet. Palvelun tuotevalikoima laajenee myöhemmin. 

Tietoja voi hakea y-tunnuksella ja osakeryhmätunnuksella.

Palvelun voimassa oleva sisältö käy ilmi tästä palvelukuvauksesta. Maanmittauslaitos ei tee palveluun organisaatiokohtaisia muutoksia.

TuotteetTiedot
Yhtiön perustiedotLaajat perustiedot, tietosisältö vastaa osakehuoneistotulosteella osiossa 'Yhtiö' esitettäviä tietoja. 
Osakeryhmien haku hakuehdoinOsakeryhmien tunnistetiedot
Osakeryhmän perustiedotLaajat perustiedot, tietosisältö vastaa osakehuoneistotulosteella osiossa 'Osakeryhmä' esitettäviä tietoja.
Osakeryhmän hallintakohteetOsakeryhmällä hallinnoitavat tilat (huoneisto, autopaikka, muu tila), tietosisältö vastaa osakehuoneistotulosteella osiossa "Osakeryhmällä hallittavat tilat" esitettäviä tietoja.
Osakeryhmän yhteystiedotOsakeryhmän voimassa olevien omistajien yhteystiedot
Osakeryhmien muutostiedotHakupalvelu aikavälillä tapahtuneiden osakeryhmien muutosten saamiseksi.
KoodistotKaikki HTJ:n koodistot
TiedotteetPalvelun käyttöön liittyvät tiedotteet
ValtuutusavaimetValtuutusavainten voimassaolo ja käyttöehtojen hyväksynnän tila
Osakeryhmän omistajat 

Tietosisältö vastaa osakehuoneistotulosteella osiossa 'Omistusoikeudet' esitettäviä tietoja. Tässä kyselyssä palautetaan kaikki osakeyhmälle rekisteröidyt voimaan tulevat (vireillä, ehdollinen, hylätty/hyväksytty ei lainvoimainen ratkaisu) ja voimassa olevat omistajat.

Tuotteista tarjotaan suppea (syntymäaika) ja laaja (henkilötunnus) versio.

Osakeryhmän rajoitukset

Tietosisältö vastaa osakehuoneistotulosteella osiossa 'Vallintarajoitukset' ja "Muut rajoitukset" esitettäviä tietoja. Tässä kyselyssä palautetaan kaikki osaryhmälle merkityt voimaan tulevat ( vireillä) ja voimassa olevat rajoitukset. Lisäksi kyselyssä palautetaan vireillä oleva rajoituksen poistaminen)

Tuotteista tarjotaan suppea (syntymäaika) ja laaja (henkilötunnus) versio.

Muutostiedot

Taloyhtiössä tapahtuneita muutoksia voi hakea taloyhtiön y-tunnuksella.

Tiedot voidaan pyytää huoneistotietojärjestelmässä voimassa olevista yhtiöistä. Vastauksessa esitetään tunnistetiedot muutoksista, joita yhtiöiden osakeryhmillä on aikavälillä tapahtunut.

Vastauksessa voi olla tiedot seuraavista yhtiön osakeryhmää tai osakeryhmiä koskevista muutoksista ao. aikavälillä

  • perustajaosakkaan tallentamisesta
  • lainvoimaisesti hyväksytystä omistuksen kirjaamisesta
  • osakeluetteloon merkitsemisestä
  • lainvoimaisesti hyväksytystä rajoituksen merkitsemisestä
  • lainvoimaisesti hyväksytystä rajoituksen poistamisesta

Rajoituksista näytetään osakeluetteloon merkittävät rajoitukset.

Järjestelmätoimittajan pitää hakea ensin oikeutta rajapinnan koekäyttöön. Riittävä testaus on edellytys palvelun tuotantokäytölle.

Rajapintapalvelun käyttö ja käyttöönotto edellyttävät, että
•    isännöintijärjestelmään on toteutettu järjestelmälupa-toiminnallisuus.
•    Taloyhtiön edustaja, yleensä isännöitsijä, on käynyt antamassa isännöintijärjestelmälle luvan käsitellä taloyhtiön tietoja

Käyttöönotto testauksen jälkeen

Rajapintapalvelun tuotantokäyttö isännöintijärjestelmässä edellyttää sopimusta ja käyttölupaa. Käyttölupa voidaan myöntää järjestelmätoimittajille, joka kehittää ja ylläpitää isännöintijärjestelmää tai sen osaa.

  1. Ota yhteyttä verkkopalveluiden asiakastukeen osoitteeseen verkkopalvelut@maanmittauslaitos.fi. Kerro viestissä, että haluat tehdä tuotantosopimuksen palvelun käytöstä.
  2. Lähetämme sinulle hakemuslomakkeen ja tietoturvaliitteen täytettäväksi. Voit hakea samalla hakemuksella Huoneistotietojen ylläpito isännöintijärjestelmille -rajapinnan käyttöoikeutta.
  3. Käsittelemme hakemuksen ja pyydämme tarvittaessa lisätietoja.
  4. Jos luvan ehdot täyttyvät, toimitamme sopimuksen allekirjoitettavaksi. 
  5. Sopimuksen allekirjoittamisen jälkeen saat ohjeet tuotantokäytön aloittamiseksi.

Tietoturva- ja tietosuojavaatimukset

Lupa ja sopimus edellyttävät tietoturva- ja tietosuojavaatimusten täyttämistä.

Tietoturvaliitteessä kysymme mm. miten isännöintijärjestelmässä hoidetaan:

  • henkilötietojen käsittely
  • käyttäjä- ja pääsynhallinta
  • huoneistotietojärjestelmän tietojen hakujen lokitus

Käyttäjähallinta

Isännöintijärjestelmän käyttäjän, esimerkiksi isännöintitoimiston tulee järjestää tietojen käyttäjille käyttäjähallinta. Käyttäjähallinta ja oikeudet tietojen käyttöön tulee pitää ajan tasalla. Palvelua saavat käyttää vain henkilöt, jotka työtehtävissään tarvitsevat huoneistotietojärjestelmän tietoja. Käyttöoikeudet on poistettava esimerkiksi työsuhteen päättyessä tai työtehtävien vaihtuessa.

Tietojen käytön lokitus

Järjestelmätoimittajan tulee toteuttaa isännöintijärjestelmään hakujen lokitus ja lokien säilytys. Lokitiedoista pitää näkyä, kuka on hakenut tietoja, mitä tietoja on haettu ja milloin. Myös jokaisessa rajapintakyselyssä tulee olla tieto, kuka tietoa hakee.

Kenellä on oikeus käsitellä taloyhtiön tietoja?

Rajapintaa voi käyttää henkikö, jolla on oikeus ylläpitää tai tarkastella taloyhtiön tietoja.

Rajapintaa voi käyttää ilman erillistä valtuutta henkilö, joka on kaupparekisteriin merkitty

  • taloyhtiön isännöitsijä
  • taloyhtiön hallituksen puheenjohtaja
  • taloyhtiön hallituksen jäsen (vain tietojen katseluoikeus)
  • keskinäisen kiinteistöosakeyhtiön toimitusjohtaja.

Muissa tilanteissa rajapinnan käyttäjä tarvitsee Suomi.fi-valtuuden. Asiointivaltuuden voi käydä antamassa tai pyytämässä Suomi.fi-valtuuksien sivuilla.

Tarvittava valtuus on:

Milloin rajapinnan käyttö ei ole mahdollista?

Rajapintaa ei voi käyttää, jos

  • henkilöllä ei ole tarvittavaa roolia tai valtuutta
  • valtuus ei kata kyseistä asiointia (katseluoikeus ei riitä tietojen ilmoittamiseen)
  • taloyhtiön tiedot eivät ole ajan tasalla kaupparekisterissä
  • taloyhtiön tila kaupparekisterissä on jokin muu kuin ”voimassa”
  • taloyhtiö on konkurssissa tai selvitystilassa.

Koekäyttöympäristö sisältää kuvitteellisten taloyhtiöiden tietoja testausta ja sovelluskehitystä varten.

Hae pääsyä koekäyttöympäristöön.

Koekäyttöä varten toimitamme yhteyshenkilölle sertifikaatin ja tiedon taloyhtiöistä, joilla palvelua voi testata.

Koekäyttöä varten isännöintijärjestelmään täytyy myös toteuttaa järjestelmälupa-toiminnallisuus.

Koekäyttöympäristön ehdot

Lisätiedot

Sovellusten ja palveluiden tila

Tarkista sovellusten ja verkkopalveluiden tilanne ja mahdolliset häiriöt. Tietoja päivitetään ma–pe klo 8–16.15.

Verkkopalveluiden asiakastuki

Verkkopalveluiden asiakastuki palvelee sopimuksiin ja käyttölupiin liittyvissä asioissa. Ota yhteyttä asiakastukeen verkkopalvelut@maanmittauslaitos.fi tai 029 530 1119.

Ongelmia palvelun käytössä?