Huoneistotietojen ylläpidon rajapintapalvelu isännöintijärjestelmille

Taulukossa on esitetty tällä hetkellä tuotannossa olevat tuotteet. 

Tietoja voi hakea y-tunnuksella ja osakeryhmätunnuksella.
 

Hallinnollisten tietojen sisältö

Hallinnollisia tietoja ovat:

• kunnossapito- ja muutostyöt eli taloyhtiön hankkeet ja osakkaiden remontit
• kunnossapitotarveselvitys
• hoito-, tontti-, kunnossapito- ja pääomavastikkeet  
• huoneistokohtaiset lainaosuudet
• lainojen jakamisen tiedot, kun käyttötarkoitus on uudisrakentaminen tai perusparannus (ml. kunnostaminen)

Hallinnollisiin tietoihin eivät kuulu:

• taloyhtiön säännölliset huoltotoimenpiteet ja pienet kunnostustyöt
• taloyhtiön jatkuvaan toimintaan liittyvät hoitolainat
• käyttökorvaukset kuten autopaikkamaksu ja saunamaksu

Lisätoiminnallisuudet

Lisäksi rajapintapalvelun kautta voi isännöintijärjestelmässä taloyhtiön edustajille tarjota seuraavat toiminnallisuudet: ilmoitettujen tietojen ajantasaisuuden vahvistaminen ja tietojen kohdistaminen lakanneilta osakeryhmiltä uusille osakeryhmille sekä luotonantajien ilmoittamien lainojen tarkastelu.

Tunnistautuminen ja tietojen hakeminen

Rajapintapalvelun kautta taloyhtiön tietoja käsiteltäessä ja tarkasteltaessa Maanmittauslaitos edellyttää aina tunnistettua käyttäjää, jolla on oikeus ylläpitää kyseisen taloyhtiön tietoja. Tämän vuoksi palvelun kautta tietoja ei voi hakea taustaoperaatioina tai massa-ajoina. Kaikki tiedot on siis haettava tunnistautuneen käyttäjän toimesta. Poikkeuksena tähän ovat yhtiön julkiset tiedot, koodistot sekä muutostietorajapinnat, jotka eivät vaadi tunnistautumista, joten ne voidaan käsitellä taustalla.

Muutostiedot ja herätteet

Muutostiedoilla tarkoitetaan tietoa siitä, millainen muutos taloyhtiön aineistossa on tapahtunut ja milloin muutos on tapahtunut.
Herätteillä tarkoitetaan tietoa taloyhtiön aineistossa havaitusta tilanteesta, joka isännöintijärjestelmä tai sen käyttäjän tulisi ottaa huomioon tai pystyä hallitsemaan.

Herätteenä voidaan toimittaa tietoja esimerkiksi:

• järjestelmän käytön edellytysten tulevasta estymisestä
• taloyhtiön aineistossa havaituista tiedon ajantasaisuuden puutteista
• taloyhtiön aineiston havaituista laatuvirheistä

Taloyhtiössä tapahtuneita muutoksia ja herätteitä voi hakea taloyhtiöiden y-tunnuksilla.

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

Muutostiedot

• Uuden hankkeen, osakasremontin, kunnossapitotarveselvityksen (KPTS), yhtiölainan ja vastikkeen lisäys, päivitys tai poisto
• Uusi luotto ja kun uusi luotto on korvannut vanhan luoton sekä luoton poistuminen
• Luotonantaja on päivittänyt yhtiön luoton tietoja
• Yhtiön luoton tietoa lainaosuuksiin jakamisesta on päivitetty

Herätteet

• yhtiön kunnossapitotarveselvitys-tietoja, lainaosuuksia ja vastikkeita ei ole päivitetty aikavälillä
   

Yhteys palvelun ja asiakkaan välillä on SSL-suojattu (Secure Socket Layer, HTTPS-protokolla) ja asiakasohjelmiston tunnistaminen toteutetaan Mutual TLS -menettelyllä. Maanmittauslaitos toimittaa asiakasohjelmistolle tarvittavat sertifikaatit. Loppukäyttäjän tunnistautuminen tapahtuu järjestelmälupa-palvelun avulla, jonka vaatimat HTTP-otsikot (header) pitää olla jokaisessa pyynnössä mukana. Palvelu kerää pyyntöihin liittyvää tilastotietoa pyyntöjen määrästä. Järjestelmän käsittelemien pyyntöjen määrä on rajattu asiakasjärjestelmäkohtaisesti ylikuormitustilanteiden välttämiseksi.

Palvelu on JSON/REST-pohjainen ja asiakasohjelmisto saa käyttöönsä OpenAPI-kuvauksen integraation toteuttamiseksi.

Rajapintapalvelun skeemojen osalta on huomioitava, että rajapinnasta palautuvaan tietoon voi tulla uusia kenttiä uusissa sovellusversioissa. Muutoksista pyritään tiedottamaan hyvissä ajoin, mutta integraatiototeutusten on hyvä olla sellaisia, että ne sietävät uusia kenttiä tietomallissa ja osaavat jättää ne huomiotta.

Lähetämme sinulle palvelun teknisen dokumentaation aloittaessasi palvelun koekäytön.

Käyttöönoton edellytykset

Rajapintapalvelun käyttö ja käyttöönotto edellyttävät, että

• taloyhtiö kuuluu huoneistotietojärjestelmään
  • Osakeluettelo tulee olla siirrettynä sähköiseen muotoon Maanmittauslaitokselle osakeluettelon siirtopalvelulla.
• taloyhtiön edustaja tekee järjestelmäluvan ennen kuin pääsee ilmoittamaan ja tarkastelemaan tietoja käyttämässään isännöintijärjestelmässä.
  • Isännöintijärjestelmän tulee ohjata käyttäjä tekemään järjestelmälupa ennen hallinnollisten tietoja ylläpitoa ja käyttöä.
• Järjestelmätoimittajan pitää
  1. hakea oikeutta koekäyttöön ja koekäyttää rajapinta. Riittävä testaus on edellytys palvelun tuotantokäytölle.
  2. hakea käyttölupaa ja ehtojen täyttyessä tehdä sopimus tuotantokäytöstä Maanmittauslaitoksen kanssa.
     • Lupa ja sopimus edellyttävät tietoturva- ja tietosuojavaatimusten täyttämistä.
     • Sopimuksessa voi valita käyttöön kaikki hallinnolliset tiedot tai pelkästään taloudelliset tiedot tai kunnossapito- ja muutostyötiedot.

Käyttöönotto

Rajapintapalvelun käyttöönotto edellyttää sopimusta Maanmittauslaitoksen kanssa sekä HTJ-lain (Laki huoneistotietojärjestelmästä) mukaista käyttölupaa. Palvelun käyttölupa myönnetään hakemuksen perusteella. Käyttölupa voidaan myöntää organisaatiolle, joka kehittää ja ylläpitää isännöintijärjestelmää tai sen osaa. Isännöintijärjestelmän loppukäyttäjinä ovat isännöitsijät.

1. Hae palvelua ensin koekäyttöön. Riittävä testaus on edellytys palvelun tuotantokäytölle.
2. Koekäyttöä varten tarvitset järjestelmälupa-toiminnallisuuden toteutuksen. Lue järjestelmäluvasta täältä.
3. Ota yhteyttä sähköpostitse verkkopalveluiden asiakastukeen osoitteeseen verkkopalvelut(at)maanmittauslaitos.fi. Ilmoita tarpeesta tehdä tuotantosopimus palvelun käytöstä.
4. Asiakastuki toimittaa sinulle hakemuslomakkeen ja tietoturvaliitteen täytettäväksi. Samalla hakemuksella voit hakea myös Huoneistotietojen kyselypalvelu isännöintijärjestelmille (REST) käyttöoikeutta.
5. Harkitsemme käyttöluvan myöntämistä tapauskohtaisesti hakemuksessa ja tietoturvaliitteessä annettujen tietojen pohjalta. Tarvittaessa pyydämme lisätietoja.
6. Jos luvan ehdot täyttyvät, toimitamme sopimuksen tutustuttavaksi ja allekirjoitettavaksi. Sopimukset ovat määrämuotoisia ja toistaiseksi voimassa olevia. Samassa yhteydessä pyydämme toimittamaan IP-osoitteet tuotantokäyttöä varten.
7. Sopimuksen solmimisen jälkeen asiakastuki toimittaa asiakkaalle kopion sopimuksesta sekä tarvittavat ohjeet tuotantokäytön aloittamiseksi. Tuotantokäyttöä varten tarvittavan sertifikaatin toimittaa teleoperaattori suoraan asiakkaalle. 

Ota huomioon tietoturva- ja tietosuojavaatimukset

Lupa ja sopimus edellyttävät tietoturva- ja tietosuojavaatimusten täyttämistä. Tietoturvaliitteessä kysymme mm. miten organisaatiossanne hoidetaan tämän palvelun osalta:

• henkilötietojen käsittely,
• organisaation käyttäjä- ja pääsynhallinta ja
• HTJ-tietojen haun lokitus.

Käyttäjähallinta 

Asiakasorganisaation tulee järjestää tietojen käyttäjille käyttäjähallinta. Käyttäjien oikeudet tietoihin tulee pitää ajan tasalla. Käyttöoikeudet palveluun saa olla vain niillä henkilöillä, jotka työtehtäviensä perusteella tarvitsevat tietoja. Käyttöoikeudet täytyy sulkea esimerkiksi työsuhteen päättyessä tai työtehtävien vaihtuessa. 

Tietojen käytön lokitus 

Organisaation tulee järjestää tietojen haun lokitus ja lokien säilytys. Lokitiedoista tulee käydä ilmi, kuka henkilö on hakenut tietoja, mitä tietoja ja milloin. Lokien säilytyksen lisäksi tieto loppukäyttäjästä tulee toimittaa mukana jokaisessa rajapintakyselyssä. 

Maanmittauslaitos luo koekäyttöympäristöön testidataa isännöintijärjestelmille. Testidata koostuu kuvitteellisista taloyhtiöistä sekä järjestelmäluvan tunnistamia testihenkilöitä, joita voidaan käyttää loppukäyttäjän (kuten isännöitsijä) simuloimiseen. Jos isännöintijärjestelmällä on erityisiä tarpeita testidataan liittyen huomioimme ne mahdollisuuksien mukaan.

Voit testata Huoneistotietojen ylläpidon koekäyttöpalvelussa maksutta. Palvelua käytetään seuraavien käyttöehtojen mukaisesti: koekäyttöympäristön ehdot. Tutustu koekäyttöpalvelun kuvaukseen. 

Koekäyttöä varten perustettu testiympäristö sisältää kuvitteellisten taloyhtiöiden perustietoja isännöintijärjestelmän sovelluskehitystä ja testausta varten.

Hae palvelua koekäyttöön ottamalla yhteyttä verkkopalveluiden asiakastukeen: verkkopalvelut@maanmittauslaitos.fi. 

Kirjoita viestiin:

• hakijan tiedot
• millaista palvelua olet suunnittelemassa
• millaiseen käyttötarkoitukseen palvelun tietoja on tarkoitus hyödyntää tulevassa
• tuotantokäytössä ja
• kuka tietoja käyttää.

Koekäyttöpalvelua varten toimitamme yhteyshenkilölle sertifikaatin sekä tiedon keksityistä taloyhtiöistä, joilla testaus tehdään. Koekäyttöoikeus on voimassa kuusi kuukautta. Testaus on maksutonta. Riittävä testaus on edellytys palvelun tuotantokäytölle.

Koekäyttöä varten sinun täytyy toteuttaa järjestelmääsi järjestelmälupa-toiminnallisuus. Järjestelmäluvalla varmistetaan teknisesti, että edustamallasi isännöintijärjestelmällä on käyttöoikeus huoneistotietojärjestelmään.

Rajapinnan tekninen tuki palvelee ma - pe klo 8 - 16. Saat tukeen yhteyden verkkolomakkeella. 

Sopimuksiin ja käyttäjätunnuksiin liittyvää tukea saat osoitteesta verkkopalvelut@maanmittauslaitos.fi. > jos sopimuksellinen palvelu

Mahdollisista häiriöistä ilmoitetaan sovellusinfossa. Palveluun tehtävistä muutoksista tiedotetaan Palvelutiedotteet -verkkosivuilla. 

Voit antaa palautetta ja kehitysehdotuksia lomakkeen kautta.