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

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

Yhteys palvelun ja asiakkaan välillä on SSL-suojattu (Secure Socket Layer, HTTPS-protokolla). Palveluun pitää kirjautua sisään antamalla käyttäjätunnus ja salasana. Käytössä on HTTP Basic Authentication -tunnistus, jonka on oltava mukana jokaisessa pyynnössä. Palvelu kerää hakuihin liittyviä tilasto- ja laskutustietoja palvelupyyntöjen perusteella käyttäjätunnuksittain jaoteltuna.

JSON-rakenne pyydetään palvelusta HTTPS/POST-protokollaan perustuvalla kyselyllä. Kyselyyn sisältyvät parametrit, joiden mukaista tietoa haetaan. 

Tuotteet

  • Yhtiön perustiedot
  • Osakeryhmien haku hakuehdoin
  • Osakeryhmän perustiedot
  • Osakeryhmän hallintakohteet
  • Osakeryhmän yhteystiedot
  • Osakeryhmän rajoitukset
  • Osakeryhmien muutostiedot
  • Koodistot
  • Tiedotteet
  • Valtuutusavaimet

Tuotteiden yhteiset

Yhtiön perustiedot

Rakenteessa esitetään huoneistotietojärjestelmän tulosteiden osiossa "Yhtiö" esiintyvät tiedot. Tiedot voidaan pyytää huoneistotietojärjestelmässä olevasta voimassa olevasta yhtiöstä. 

Hakuparametrit

 Nimi 

 Arvot

Lkm

 Kuvaus

valtuutusavaimet valtuutusavain 1..n Yhtiön tietoihin oikeuttava valtuutusavain, jonka saa haettua Osakeluettelon siirtopalvelusta.

ytunnus

y-tunnus

1

Yhtiön y-tunnus. Yhtiön pitää olla joko uusi vuonna 2019 tai myöhemmin perustettu yhtiö tai vanha yhtiö, joka on jo siirtänyt osakeluettelonsa huoneistotietojärjestelmään.

Esimerkit

https://htjws.nls.fi/htj/v1/kysely/isannoitsijat/yhtiot/perustiedot

POST:

  {
    "valtuutusavaimet": ["HTJ-2020-08-10-6f485da4-6ab8-49ef-9216-ec79afb53cvd"],
    "ytunnus": "0161649-9"
  }

Esimerkkivastaus

 

Osakeryhmien haku hakuehdoin

Kyselyllä saadaan haettua yhtiön kaikkien osakeryhmien tunnistetiedot. Tiedot voidaan pyytää huoneistotietojärjestelmässä olevasta voimassa olevasta yhtiöstä. Rakenteessa palautetaan yhtiön voimassa olevat ja lakkaavat osakeryhmät.

Jokaisesta voimassa olevasta osakeryhmästä palautetaan tieto, perustuuko osakeryhmän omistus osakekirjaan vai huoneistotietojärjestelmään kirjattuun sähköiseen merkintään. Vastauksessa palautetaan tieto 'sahkoinenOmistusmerkinta' arvolla false, jos omistus perustuu edelleen osakekirjaan, ja arvolla true, jos omistus perustuu sähköiseen merkintään.

Hakuparametrit

 Nimi 

 Arvot

Lkm

 Kuvaus

valtuutusavaimet valtuutusavain 1..n Yhtiön tietoihin oikeuttava valtuutusavain, jonka saa haettua Osakeluettelon siirtopalvelusta.

ytunnus

y-tunnus

1

Yhtiön y-tunnus. Yhtiön pitää olla joko uusi vuonna 2019 tai myöhemmin perustettu yhtiö tai vanha yhtiö, joka on jo siirtänyt osakeluettelonsa huoneistotietojärjestelmään. 

Esimerkit

https://htjws.nls.fi/htj/v1/kysely/isannoitsijat/osakeryhmat/haku

POST:

{
"valtuutusavaimet": ["HTJ-2020-08-10-6f485da4-6ab8-49ef-9216-ec79afb53cvd"],
"ytunnus": "0161649-9"
}

Esimerkkivastaus

 

Osakeryhmän perustiedot

Tiedot voidaan pyytää huoneistotietojärjestelmässä olevasta voimassa olevasta ja lakkaavasta osakeryhmästä. 

Rakenteessa esitetään huoneistotietojärjestelmän tulosteiden osiossa "Osakeryhmä" esiintyvät tiedot. 

Hakuparametrit

 Nimi 

 Arvot

Lkm

 Kuvaus

valtuutusavaimet valtuutusavain 1..n Yhtiön tietoihin oikeuttava valtuutusavain, jonka saa haettua Osakeluettelon siirtopalvelusta.

ytunnus

y-tunnus

1

Yhtiön y-tunnus. Yhtiön pitää olla joko uusi vuonna 2019 tai myöhemmin perustettu yhtiö tai vanha yhtiö, joka on jo siirtänyt osakeluettelonsa huoneistotietojärjestelmään.

osakeryhmatunnus

osakeryhmätunnus

1

Osakeryhmän osakeryhmätunnus. Osakeryhmän pitää olla voimassa oleva tai lakkaava.

Esimerkit

https://htjws.nls.fi/htj/v1/kysely/isannoitsijat/osakeryhmat/perustiedot

POST:

{
"valtuutusavaimet": ["HTJ-2020-08-10-6f485da4-6ab8-49ef-9216-ec79afb53cvd"],
"ytunnus": "0161649-9",
"osakeryhmatunnus" : "OH5BRDQ22L3NBB12"
}

Esimerkkivastaus voimassa oleva

Esimerkkivastaus lakkaava

 

Osakeryhmän hallintakohteet

Tiedot voidaan pyytää huoneistotietojärjestelmässä olevan yhtiön voimassa olevasta tai lakkaavasta osakeryhmästä. 

Rakenteessa esitetään osakeryhmällä hallinnoitavien tilojen (huoneisto, autopaikka, muu tila) tiedot.

Hakuparametrit

 Nimi 

 Arvot

Lkm

 Kuvaus

ytunnus

y-tunnus

1

Yhtiön y-tunnus. Yhtiön pitää olla joko uusi vuonna 2019 tai myöhemmin perustettu yhtiö tai vanha yhtiö, joka on jo siirtänyt osakeluettelonsa huoneistotietojärjestelmään. Vain asunto-osakeyhtiöt ja keskinäiset kiinteistöosakeyhtiöt voivat kuulua huoneistotietojärjestelmään.

osakeryhmatunnus

osakeryhmätunnus

1

Osakeryhmän osakeryhmätunnus. Osakeryhmän pitää olla voimassa oleva tai lakkaava.

Esimerkit

https://htjws.nls.fi/htj/v1/kysely/isannoitsijat/osakeryhmat/hallintakohteet

POST:

{
"valtuutusavaimet": ["HTJ-2020-08-10-6f485da4-6ab8-49ef-9216-ec79afb53cvd"],
"ytunnus": "0161649-9",
"osakeryhmatunnus" : "OH5BRDQ22L3NBB12"
}

Esimerkkivastaus voimassa oleva

Esimerkkivastaus lakkaava

 

Osakeryhmän yhteystiedot

Tiedot voidaan pyytää huoneistotietojärjestelmässä olevasta voimassa olevasta tai lakkaavasta osakeryhmästä. 

Rakenteessa esitetään osakeryhmän jokaisen voimassa olevan omistajan yhteystiedot sekä tieto siitä, onko omistaja merkitty osakeluetteloon. Jos omistajalla on huoneistotietojärjestelmässä henkilötunnus tai y-tunnus ja omistaja on ilmoittanut huoneistotietojärjestelmään VTJ:stä/YTJ:stä poikkeavan osoitteen, esitetään se, ja muussa tapauksessa esitetään ajantasainen VTJ:n/YTJ:n mukainen osoite. Kuolleen henkilön VTJ-osoitetta ei esitetä, mutta mahdollinen poikkeava osoite esitetään. Jos yhdelläkin osakeryhmään liittyvistä henkilöistä on tietojen luovutuskielto, yhdenkään omistajan tietoja ei palauteta.

Hakuparametrit

 Nimi 

 Arvot

Lkm

 Kuvaus

valtuutusavaimet valtuutusavain 1..n Yhtiön tietoihin oikeuttava valtuutusavain, jonka saa haettua Osakeluettelon siirtopalvelusta.

ytunnus

y-tunnus

1

Yhtiön y-tunnus. Yhtiön pitää olla joko uusi vuonna 2019 tai myöhemmin perustettu yhtiö tai vanha yhtiö, joka on jo siirtänyt osakeluettelonsa huoneistotietojärjestelmään.

osakeryhmatunnus

osakeryhmätunnus

1

Osakeryhmän osakeryhmätunnus. Osakeryhmän pitää olla voimassa oleva tai lakkaava.

Esimerkit

https://htjws.nls.fi/htj/v1/kysely/isannoitsijat/osakeryhmat/yhteystiedot

POST:

{
"valtuutusavaimet": ["HTJ-2020-08-10-6f485da4-6ab8-49ef-9216-ec79afb53cvd"],
"ytunnus": "0161649-9",
"osakeryhmatunnus" : "OH5BRDQ22L3NBB12"
}

Esimerkkivastaus

Esimerkkivastaus

 

Osakeryhmän rajoitukset

Tiedot voidaan pyytää huoneistotietojärjestelmässä olevasta voimassa olevasta tai lakkaavasta osakeryhmästä. 

Rakenteessa esitetään osakeryhmällä voimassa olevista rajoituksista ne, jotka esitetään osakeluettelossa. Rajoitukseen liittyvät henkilöt esitetään, mikäli kenelläkään osakeryhmän henkilöllä ei ole tietojen luovutuskieltoa.

Hakuparametrit

 Nimi 

 Arvot

Lkm

 Kuvaus

valtuutusavaimet valtuutusavain 1..n Yhtiön tietoihin oikeuttava valtuutusavain, jonka saa haettua Osakeluettelon siirtopalvelusta.

ytunnus

y-tunnus

1

Yhtiön y-tunnus. Yhtiön pitää olla joko uusi vuonna 2019 tai myöhemmin perustettu yhtiö tai vanha yhtiö, joka on jo siirtänyt osakeluettelonsa huoneistotietojärjestelmään.

osakeryhmatunnus

osakeryhmätunnus

1

Osakeryhmän osakeryhmätunnus. Osakeryhmän pitää olla voimassa oleva tai lakkaava.

Esimerkit

https://htjws.nls.fi/htj/v1/kysely/isannoitsijat/osakeryhmat/rajoitukset

POST:

{
"valtuutusavaimet": ["HTJ-2020-08-10-6f485da4-6ab8-49ef-9216-ec79afb53cvd"],
"ytunnus": "0161649-9",
"osakeryhmatunnus" : "OH5BRDQ22L3NBB12"
}

Esimerkkivastaus

 

Osakeryhmien muutostiedot

Rakenteessa esitetään tunnistetiedot muutoksista, joita yhtiöiden osakeryhmillä on aikavälillä (max 31 päivää) tapahtunut. Tiedot voidaan pyytää huoneistotietojärjestelmässä voimassa olevista yhtiöistä. 

Rakenteessa esitetään muutostapahtuma jokaisesta yhtiön osakeryhmälle aikavälillä tapahtuneesta

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

Kyselyparametrit

 Nimi 

 Arvot

Lkm Oletusarvo

 Kuvaus

limit nro 0..1 10 Vastauksessa palautettavien tulosten määrä. Tulosten kokonaislukumäärän saa vastaussanoman TotalElements-kentästä.

page

nro

0..1 0

Vastauksessa palautettavan sivun numero. Ensimmäinen sivu on 0. Sivujen kokonaislukumäärän saa vastaussanoman TotalPages-kentästä. 

Hakuparametrit

 Nimi 

 Arvot

Lkm

 Kuvaus

valtuutusavaimet valtuutusavain 1..n Yhtiön tietoihin oikeuttava valtuutusavain, jonka saa haettua Osakeluettelon siirtopalvelusta.

ytunnukset

y-tunnus

1..n

Yhtiön y-tunnus. Yhtiön pitää olla joko uusi vuonna 2019 tai myöhemmin perustettu yhtiö tai vanha yhtiö, joka on jo siirtänyt osakeluettelonsa huoneistotietojärjestelmään.

alkupvm

pvm

1

Aikavälin alkupvm. Palvelu palauttaa myös annettuna päivänä tapahtuneet muutokset. Aikavälin (alkupvm...loppupvm) maksimipituus on 31 päivää.

loppupvm pvm 1 Aikavälin loppupvm. Palvelu palauttaa myös annettuna päivänä tapahtuneet muutokset. Aikavälin (alkupvm...loppupvm) maksimipituus on 31 päivää.

Esimerkit

https://htjws.nls.fi/htj/v1/kysely/isannoitsijat/osakeryhmat/muutostiedot

https://htjws.nls.fi/htj/v1/kysely/isannoitsijat/osakeryhmat/muutostiedot?limit=5&page=2

POST:

{
  "valtuutusavaimet": ["HTJ-2020-08-10-6f485da4-6ab8-49ef-9216-ec79afb53cvd"],
  "ytunnukset": ["1234567-8", "2345678-9"],
  "alkupvm": "2020-01-01",
  "loppupvm": "2020-01-30"
}

Esimerkkivastaus

 

Koodistot

Rakenteessa esitetään koodistojen nimet ja koodiarvot.

Hakuparametrit

Ei hakuparametreja.

Esimerkit

https://htjws.nls.fi/htj/v1/kysely/koodistot

Esimerkkivastaus

 

Tiedotteet

Rakenteessa esitetään palvelun käyttöön liittyviä tiedotteita, kuten tiedot tulossa olevista käyttökatkoista tai uusien käyttöehtojen julkaisemisesta.

Hakuparametrit

Ei hakuparametreja.

Esimerkit

https://htjws.nls.fi/htj/v1/kysely/tiedotteet

Esimerkkivastaus

 

Valtuutusavaimet

Rakenteessa esitetään tiedot kysyttyjen valtuutusavainten voimassaolosta ja niihin liittyvien käyttöehtojen hyväksymisestä.

Hakuparametrit

 Nimi 

 Arvot

Lkm

 Kuvaus

valtuutusavaimet valtuutusavain 1..n Yhtiön tietoihin oikeuttava valtuutusavain, jonka saa haettua Osakeluettelon siirtopalvelusta.

Esimerkit

https://htjws.nls.fi/htj/v1/kysely/isannoitsijat/valtuutusavaimet

POST:

{
  "valtuutusavaimet": ["HTJ-2020-08-10-6f485da4-6ab8-49ef-9216-ec79afb53cvd"]
}

Esimerkkivastaus

Sovellusversio 25.5.2021

Muutokset

  • Kaupparekisterissä lakkaavien ja niiden sijaan syntyvien osakeryhmien käsittelyyn toteutetut muutokset
    • Kaupparekisterissä tehdyssä yhtiöjärjestyksen muutoksessa lakanneet osakeryhmät säilyvät huoneistotietojärjestelmän tietopalvelussa niin kauan, kunnes kaikki lakkaavaan osakeryhmään liittyvät oikeudet on tarpeellisilta osin siirretty osakeryhmän sijaan tulleelle uudelle osakeryhmälle.
    • Kaupparekisterissä tehdyssä yhtiöjärjestyksen muutoksessa syntyvät osakeryhmät eivät tule huoneistotietojärjestelmän tietopalveluun ennen kuin osakeryhmään liittyvän lakkaavan osakeryhmän oikeudet on siirretty syntyvälle osakeryhmälle.
    • Huoneistotietojärjestelmässä otetaan käyttöön jokaiseen osakeryhmään liittyvä osakeryhmän tila, joka voi olla jokin seuraavista
      • voimassa oleva
      • lakkaava
        • kaupparekisterissä osakeryhmä voi olla jo lakannut, mutta huoneistotietojärjestelmässä sitä vielä esitetään siihen saakka, kunnes kaikki siihen liittyvät oikeudet on siirretty syntyvälle osakeryhmälle
      • syntyvä
        • kaupparekisterissä osakeryhmä voi olla jo syntynyt, mutta huoneistotietojärjestelmässä sitä ei vielä esitetä ennen kuin sille on siirretty kaikki tarpeelliset lakkaavan osakeryhmän oikeudet 
        • syntyviä osakeryhmiä ei esitetä tietopalvelussa
      • lakannut
        • aikaisemmin voimassa ollut osakeryhmä mutta nyt jo sekä kaupparekisterissä että huoneistotietojärjestelmässä lakannut osakeryhmä
        • lakanneita osakeryhmiä ei esitetä tietopalvelussa
    • Aikaisemmin ilmoitetut skeemamuutokset ks. 19.1.2021 ja 16.2.2021
    • Uusi skeemamuutos 
      • Osakeryhmän hallintakohteet
        • lisätty uusi elementti "lakkaamispvm" 
    • Muutokset kyselypalvelutuotteissa
      • Osakeryhmien haku hakuehdoin
        • "olotila"
          • ks. yllä osakeryhmän tila
      • Osakeryhmän perustiedot
        • "olotila"
          • ks. yllä osakeryhmän tila
        • "voimaantulopvmOsakehuoneistorekisterissa"
          • pvm, jolloin osakeryhmä on tullut huoneistotietojärjestelmän tietopalveluun
          • pvm on yleensä se pvm, jolloin uusi osakeryhmä on rekisteröity kaupparekisterissä
          • jos osakeryhmän tila on ensin ollut huoneistotietojärjestelmässä syntyvä ja siihen liittyvät oikeudet on siirretty vastaavalta lakkaavalta osakeryhmältä, pvm on myöhäisempi kuin kaupparekisteristä saatu rekisteröintipvm ja pvm kertoo, milloin osakeryhmän tila on muuttunut syntyvästä voimassa olevaksi
          • vanhojen yhtiöiden osakeryhmillä voimaantulovpm on osakeluettelon siirron hyväksymispvm
        • "lakkaamispvmOsakehuoneistorekisterissa"
          • pvm, jolloin osakeryhmä poistui huoneistotietojärjestelmän tietopalvelusta
          • toistaiseksi tietopalvelussa ei esitetä lakanneita osakeryhmiä, joten pvm:ää ei käytännössä esiinny tietopalvelussa
      • Osakeryhmän hallintakohteet
        • "lakkaamispvm"
          • hallintakohteet voivat olla lakanneita silloin, kun osakeryhmä ja siihen liittyvät hallintakohteet ovat jo lakanneet kaupparekisterissä tehdyssä yhtiöjärjestyksen muutoksessa
          • vain lakkaaviin osakeryhmiin liittyvät hallintakohteet voivat olla lakanneita
      • Yhtiön perustiedot
        • "ajantasainen"
          • yhtiön muutostietojen siirron ajantasaisuus esitetään vain silloin, kun tiedot eivät ole ajantasalla
          • yhtiön tiedot eivät ole ajantasaisia, jos
            • yhtiön muutostietojen siirto kaupparekisteristä huoneistotietojärjestelmään on jostain teknisestä syystä estynyt
            • kaupparekisterissä tapahtuneen sulautumisen tai jakautumisen tietojen siirto huoneistotietojärjestelmään on kesken

Kaikki skeemat zip-pakettina

Sovellusversio 16.2.2021

Muutokset

  • Osakeryhmän yhteystiedot
    • hakuskeemaan on lisätty tähän saakka puuttunut elementti "osakeryhmatunnus"
  • Osakeryhmän perustiedot
    • päähallintakohteen käyttötarkoitus esitetään samalla tavalla kuin tuotteessa Osakeryhmän hallintakohteet
      • lisätty uusi yläelementti "paakayttotarkoitus" 
      • käyttötarkoituksen 999=Muu yksikielinen seliteteksti tulostetaan elementtiin "selite" 
  • Skeemamuutokset, jotka liittyvät myöhemmin keväällä käyttöönotettavaan muutokseen kaupparekisterissä lakkaavien osakeryhmien käsittelyssä
    • Yhtiön perustiedot
      • lisätty uusi elementti "ajantasainen"

Kaikki skeemat zip-pakettina

Sovellusversio 19.1.2021

Muutokset

  • Kaikki skeemat
    • Skeemoja muutetaan niiltä osin, missä skeemoissa estetään ylimääräisten kenttien käyttäminen sanomissa. Kyseinen rajoitus muutetaan, jotta tietopalvelujen kehittämistä voidaan tehdä ketterästi rikkomatta mahdollista skeemavalidointia jokaisen lisätyn kentän johdosta. 
      • Skeemoissa on korvattu "additionalProperties": false -määre "additionalProperties": true -määreellä.
  • Skeemamuutokset, jotka liittyvät myöhemmin keväällä käyttöönotettavaan muutokseen kaupparekisterissä lakkaavien osakeryhmien käsittelyssä
    • Osakeryhmien haku hakuehdoin
      • lisätty uusi elementti "olotila"
    • Osakeryhmän perustiedot
      • lisätty uudet elementit "olotila", "voimaantulopvmOsakehuoneistorekisterissa" ja "lakkaamispvmOsakehuoneistorekisterissa"
  • Osakeryhmän hallintakohteet
    • uusi kyselypalvelutuote, joka sisältää tiedot osakeryhmällä hallittavasta huoneistosta, autopaikasta ja muusta tilasta

Kaikki skeemat zip-pakettina

Sovellusversio 1.1.2021

Kaikki skeemat zip-pakettina

 

Palveluun kytkeytymiseen tai saatavuuteen sekä tietoliikenteeseen liittyvistä virhetilanteista palautetaan asiakassovellukselle virheilmoitus HTTP-virhekoodeina. Palvelu palauttaa seuraavia virhekoodeja:

Virhekoodi HTTP-tunnus Selitys
400 Bad Request Hakupyyntö tai sen parametrit ovat virheellisiä.
401 Unauthorized Palvelu ei hyväksy asiakassovelluksen välittämää käyttäjätunnistetta.
404 Not found Parametreilla ei löydy tietoa.
500 Internal Server Error Pyyntöä käsiteltäessä tapahtunut jokin odottamaton virhetilanne.

Aineisto

Koekäyttöympäristöön on luotu kuvitteellisten yhtiöiden perustietoja kutakin isännöintijärjestelmää varten. Isännöintijärjestelmistä tuodaan yhtiöille kohdetiedot sekä osakeluettelotiedot.

Ennen osakeluettelon siirron hyväksymistä ei pysty hakemaan tietopalvelukyselyillä tietoja. Tämän takia isännöintijärjestelmien omien yhtiöiden lisäksi koekäyttöympäristössä on yksi jo osakeluettelonsa siirtänyt yhtiö, jolla voidaan kokeilla kyselyjä (y-tunnus 6583621-2, yhtiöllä viisi voimassa olevaa osakeryhmää ja yksi lakkaava osakeryhmä, yhtiön osakeluettelo ja osakeryhmien osakehuoneistotulosteet), muutostietoja löytyy päivämäärällä 22.10.2020.

Mikäli isännöintijärjestelmien omien yhtiöiden tiedoilla halutaan testata tietopalveluhakuja, pitää yhtiön osakeluettelon siirto hyväksyä ja sen jälkeen tietopalveluja voidaan testata. Jos tämän jälkeen halutaan taas testata osakeluettelon siirtoa, pitää pyytää oman yhtiön palauttamista osakeluettelon siirtoa edeltäneeseen tilanteeseen.

Käyttöönotto

Verkkopalveluiden asiakastuesta voi pyytää sähköpostitse (verkkopalvelut(at)maanmittauslaitos.fi) oikeutta koekäyttöympäristöön. Viestistä tulisi käydä ilmi, minkälaista palvelua ollaan suunnittelemassa ja miten palvelusta saatuja tietoja on tarkoitus hyödyntää mahdollisessa tuotantokäytössä.

Koekäyttöympäristön käyttöön myönnetään lupa, joka on voimassa kuusi kuukautta.

Tuotteet

Kaikki palvelun tuotteet ovat koekäytettävissä. Tuotantopalvelussa olevasta tuotteen kyselyosoitteesta saa koekäyttöpalvelun osoitteen vaihtamalla osoitteen alkuun htjws.nls.fi -> htjwskoe.nls.fi.

Esimerkiksi osakeryhmän perustiedot:

https://htjwskoe.nls.fi/htj/v1/kysely/isannoitsijat/osakeryhmat/perustiedot

Muutokset

Koekäyttöympäristössä on saatavilla vain nykyinen versio eikä vanhoja versioita säilytetä.

Tulossa oleva koekäyttöympäristön päivitys: x.x.xxxx

Viimeisin koekäyttöympäristön päivitys: 12.4.2021

  • Kaupparekisterissä lakkaavien ja niiden sijaan syntyvien osakeryhmien käsittelyyn toteutetut muutokset
    • Kaupparekisterissä tehdyssä yhtiöjärjestyksen muutoksessa lakanneet osakeryhmät säilyvät huoneistotietojärjestelmän tietopalvelussa niin kauan, kunnes kaikki lakkaavaan osakeryhmään liittyvät oikeudet on tarpeellisilta osin siirretty osakeryhmän sijaan tulleelle uudelle osakeryhmälle.
    • Kaupparekisterissä tehdyssä yhtiöjärjestyksen muutoksessa syntyvät osakeryhmät eivät tule huoneistotietojärjestelmän tietopalveluun ennen kuin osakeryhmään liittyvän lakkaavan osakeryhmän oikeudet on siirretty syntyvälle osakeryhmälle.
    • Huoneistotietojärjestelmässä otetaan käyttöön jokaiseen osakeryhmään liittyvä osakeryhmän tila, joka voi olla jokin seuraavista
      • voimassa oleva
      • lakkaava
        • kaupparekisterissä osakeryhmä voi olla jo lakannut, mutta huoneistotietojärjestelmässä sitä vielä esitetään siihen saakka, kunnes kaikki siihen liittyvät oikeudet on siirretty syntyvälle osakeryhmälle
      • syntyvä
        • kaupparekisterissä osakeryhmä voi olla jo syntynyt, mutta huoneistotietojärjestelmässä sitä ei vielä esitetä ennen kuin sille on siirretty kaikki tarpeelliset lakkaavan osakeryhmän oikeudet 
        • syntyviä osakeryhmiä ei esitetä tietopalvelussa
      • lakannut
        • aikaisemmin voimassa ollut osakeryhmä mutta nyt jo sekä kaupparekisterissä että huoneistotietojärjestelmässä lakannut osakeryhmä
        • lakanneita osakeryhmiä ei esitetä tietopalvelussa
    • Aikaisemmin ilmoitetut skeemamuutokset ks. 4.1.2021 ja 1.2.2021
    • Uusi skeemamuutos 
      • Osakeryhmän hallintakohteet
        • lisätty uusi elementti "lakkaamispvm" 
    • Muutokset kyselypalvelutuotteissa
      • Osakeryhmien haku hakuehdoin
        • "olotila"
          • ks. yllä osakeryhmän tila
      • Osakeryhmän perustiedot
        • "olotila"
          • ks. yllä osakeryhmän tila
        • "voimaantulopvmOsakehuoneistorekisterissa"
          • pvm, jolloin osakeryhmä on tullut huoneistotietojärjestelmän tietopalveluun
          • pvm on yleensä se pvm, jolloin uusi osakeryhmä on rekisteröity kaupparekisterissä
          • jos osakeryhmän tila on ensin ollut huoneistotietojärjestelmässä syntyvä ja siihen liittyvät oikeudet on siirretty vastaavalta lakkaavalta osakeryhmältä, pvm on myöhäisempi kuin kaupparekisteristä saatu rekisteröintipvm ja pvm kertoo, milloin osakeryhmän tila on muuttunut syntyvästä voimassa olevaksi
          • vanhojen yhtiöiden osakeryhmillä voimaantulovpm on osakeluettelon siirron hyväksymispvm
        • "lakkaamispvmOsakehuoneistorekisterissa"
          • pvm, jolloin osakeryhmä poistui huoneistotietojärjestelmän tietopalvelusta
          • toistaiseksi tietopalvelussa ei esitetä lakanneita osakeryhmiä, joten pvm:ää ei käytännössä esiinny tietopalvelussa
      • Osakeryhmän hallintakohteet
        • "lakkaamispvm"
          • hallintakohteet voivat olla lakanneita silloin, kun osakeryhmä ja siihen liittyvät hallintakohteet ovat jo lakanneet kaupparekisterissä tehdyssä yhtiöjärjestyksen muutoksessa
          • vain lakkaaviin osakeryhmiin liittyvät hallintakohteet voivat olla lakanneita
      • Yhtiön perustiedot
        • "ajantasainen"
          • yhtiön muutostietojen siirron ajantasaisuus esitetään vain silloin, kun tiedot eivät ole ajantasalla
          • yhtiön tiedot eivät ole ajantasaisia, jos
            • yhtiön muutostietojen siirto kaupparekisteristä huoneistotietojärjestelmään on jostain teknisestä syystä estynyt
            • kaupparekisterissä tapahtuneen sulautumisen tai jakautumisen tietojen siirto huoneistotietojärjestelmään on kesken

    Aikaisemmat koekäyttöympäristön päivitykset:

    1.2.2021

    • Osakeryhmän yhteystiedot
      • hakuskeemaan on lisätty tähän saakka puuttunut elementti "osakeryhmatunnus"
    • Osakeryhmän perustiedot
      • päähallintakohteen käyttötarkoitus esitetään samalla tavalla kuin tuotteessa Osakeryhmän hallintakohteet
        • lisätty uusi yläelementti "paakayttotarkoitus" 
        • käyttötarkoituksen 999=Muu yksikielinen seliteteksti tulostetaan elementtiin "selite" 
    • Skeemamuutokset, jotka liittyvät myöhemmin keväällä käyttöönotettavaan muutokseen kaupparekisterissä lakkaavien osakeryhmien käsittelyssä
      • Yhtiön perustiedot
        • lisätty uusi elementti "ajantasainen"

    4.1.2021

    • Kaikki skeemat
      • Skeemoja muutetaan niiltä osin, missä skeemoissa estetään ylimääräisten kenttien käyttäminen sanomissa. Kyseinen rajoitus muutetaan, jotta tietopalvelujen kehittämistä voidaan tehdä ketterästi rikkomatta mahdollista skeemavalidointia jokaisen lisätyn kentän johdosta. 
        • Skeemoissa on korvattu "additionalProperties": false -määre "additionalProperties": true -määreellä.
    • Skeemamuutokset, jotka liittyvät myöhemmin keväällä käyttöönotettavaan muutokseen kaupparekisterissä lakkaavien osakeryhmien käsittelyssä
      • Osakeryhmien haku hakuehdoin
        • lisätty uusi elementti "olotila"
      • Osakeryhmän perustiedot
        • lisätty uudet elementit "olotila", "voimaantulopvmOsakehuoneistorekisterissa" ja "lakkaamispvmOsakehuoneistorekisterissa"
    • Osakeryhmän hallintakohteet
      • uusi kyselypalvelutuote, joka sisältää tiedot osakeryhmällä hallittavasta huoneistosta, autopaikasta ja muusta tilasta

    23.11.2020

    • Kaikki skeemat
      • Skeemoista on korvattu KoodiArvoDto-objekti uudella extKoodiArvoDto-objektilla. Näiden objektien erona on koodisto-arvojen listauksen (enum) vaihtuminen pelkäksi merkkijonoksi. Muutos on tehty, jotta koodistoja voidaan lisätä HTJ taustajärjestelmiin ilman, että skeemasta tarvitsee aina tehdä uutta versiota.

    9.11.2020

    • Osakeryhmien yhteystiedot
      • palauttaa omistajana olevan luonnollisen henkilön syntymäajan
      • palauttaa omistajana olevan ulkomaalaisen yrityksen rekisterinumeron, rekisterin nimen ja kotivaltion
      • palauttaa omistustiedon alkamispäivän (päivä, jolloin omistuksen kirjaus on tullut vireille)
      • palauttaa osakeluetteloon merkitsemispäivän
      • ei palauta yhdenkään omistajan tietoja silloin, kun yhdelläkin osakeryhmän omistajista on tietojen luovutuskielto
    • Osakeryhmän rajoitukset
      • palauttaa vain ne rajoitukset, jotka esitetään osakeluettelossa
      • palauttaa vain voimassa olevat rajoitukset
    • Osakeryhmien muutostiedot
      • palauttaa tiedon siitä, että osakeryhmän omistaja on merkitty osakeluetteloon

    26.10.2020

    • Osakeryhmien haku hakuehdoin
      • uusi tuote, joka palauttaa yhtiön kaikkien osakeryhmien tunnistetiedot
    • Valtuutusavaimet
      • uusi tuote, joka palauttaa tiedot kysyttyjen valtuutusavainten voimassaolosta sekä siitä, onko valtuutusavaimeen liittyvät käyttöehdot hyväksytty
    • Koodistot
      • lisätty tulosrakenteeseen uudet tiedot sisaltoseliteFi, sisaltoseliteSv, lainkohtaFi ja lainkohtaSv

    3.9.2020

    • Tiedotteet
      • uusi tuote, joka palauttaa tietoja palvelun käytöstä, mm. tiedot tulossa olevista käyttökatkoista sekä uusien käyttöehtojen julkaisemisesta

    3.8.2020

    • Kaikki kyselyt
      • hakuparametrin 'valtuutuskoodit' nimi on muuttunut muotoon 'valtuutusavaimet'
    • Osakeryhmien muutostiedot
      • palauttaa tiedon osakeryhmän rajoituksen muutoksesta
    • Koodistot
      • uusi muutostyyppi 8=Osakeryhmän rajoitusmuutos
    • Osakeryhmän perustiedot
      • palauttaa huoneiston ja muun tilan ensisijaisen käyttötarkoituksen
      • palauttaa osakesarjalla mahdollisesti olevan tarkenteen

    9.6.2020

    • Kaikki kyselyt
      • hakuparametrilla 'valtuutuskoodit' voi antaa useita valtuutusavaimia 

    27.5.2020

    • Osakeryhmän perustiedot
      • hallintakohdetyyppi esitetään koodistona
      • muutos katunimien esittämiseen eri kielillä
    • Koodistot
      • palauttaa hallintakohdetyypin koodiarvot selitteineen

    7.5.2020

    • Koekäyttöympäristö julkaistu