Tekninen kuvaus Huoneistotietojen kyselypalvelu (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/GET-protokollaan perustuvalla kyselyllä. Kyselyyn sisältyvät parametrit, joiden mukaista tietoa haetaan.
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.
Loppukäyttäjien lokitus
Huoneistotietojen kyselypalvelun palvelinjärjestelmässä tallennetaan lokeihin tietoa myös asiakassovelluksessa tunnistetusta loppukäyttäjästä, mikäli asiakassovellus välittää rajapintapalvelulle loppukäyttäjää identifioivan tunnisteen kunkin rajapintapyynnön yhteydessä.
Teknisesti rajapintapalvelun kutsuissa tunniste tulee välittää HTTP-standardin mukaisena Request Header-kenttänä nimeltään "enduserid" ja jonka arvon tulee olla merkkijono (välilyönnit ei sallittuja, pituus max. 60 merkkiä). Muutoin merkkijonon sisältö voi olla asiakassovelluksen määrittämä, mutta kuitenkin siten, että tarvittaessa tunnisteen perusteella on selvitettävissä loppukäyttäjä asiakassovelluksen ylläpitäjän toimesta.
Yleistä lisätietoa HTTP:n Request Header-kentistä: https://developer.mozilla.org/en-US/docs/Glossary/Request_header
Lokitietojen siirron toimivuus on hyvä varmistaa ottamalla yhteyttä Maanmittauslaitokseen osoitteeseen verkkopalvelut@maanmittauslaitos.fi
Lisäksi lokitietoja tulee säilyttää kuuden vuoden ajan, jonka jälkeen ne tulee poistaa.
Aineistot ja tuotteet
Tuotteet
- Yhtiöiden haku hakuehdoin
- Osakeryhmien haku hakuehdoin
- Yhtiön perustiedot
- Osakeryhmän perustiedot
- Osakeryhmän hallintakohteet
- Osakeryhmän omistajat (Suppea ja laaja)
- Osakeryhmän panttaukset (Suppea ja laaja)
- Osakeryhmän rajoitukset (Suppea ja laaja)
- Osakeluetteloon merkityt omistajat
- Henkilön omistukset viranomaisille
- Koodistot
- Tiedotteet
Tuotteiden yhteiset
- Skeemat (Päivitetty 15.4.2025)
- Koodistot (Päivitetty 10.3.2025)
- Huom. pdf-tiedoston ylläpito on lopetettu ja se poistetaan 27.5.2025. Ajantasaiset koodistot ovat saatavissa koodistot-rajapinnasta.
- Tietojen kuvaukset (Päivitetty 15.4.2025)
Kyselyt ja esimerkit
Yhtiöiden haku hakuehdoin
Rakenteessa esitetään yhtiöiden suppeat perustiedot.
Tällä kyselyllä saadaan tietää, onko yhtiö huoneistotietojärjestelmässä. Huoneistotietojärjestelmässä olevista yhtiöistä palautetaan vastauksessa tieto 'osakeluetteloOsakehuoneistorekisterissa' arvolla true. Vain huoneistotietojärjestelmässä olevista voimassa olevista yhtiöistä voidaan pyytää muita kyselyjä ja tulosteita.
Yhtiöistä, jotka on perustettu ennen 1.1.2019 ja jotka eivät vielä ole siirtäneet osakeluetteloaan huoneistotietojärjestelmään, kysely voi palauttaa vastauksena joko rakenteen, jossa osakeluetteloOsakehuoneistorekisterissa=false, tai virhekoodin 404 Not found.
Hakuparametrit
| Nimi | Arvot | Lkm | Kuvaus |
| ytunnus | y-tunnus | 1 | Yhtiön y-tunnus. |
Esimerkit
https://htjws.nls.fi/htj/v1/kysely/yhtiot/haku?ytunnus=6583621-2
Osakeryhmien haku hakuehdoin
Tiedot voidaan pyytää huoneistotietojärjestelmässä olevasta voimassa olevasta yhtiöstä. Rakenteessa esitetään osakeryhmien suppeat perustiedot jokaisesta yhtiön voimassa olevasta, syntyvästä ja lakkaavasta osakeryhmästä.
Tällä kyselyllä saadaan tietää, perustuuko osakeryhmän omistus huoneistotietojärjestelmään rekisteröityyn sähköiseen merkintään. Vastauksessa palautetaan tieto 'sahkoinenOmistusmerkinta' arvolla true, jos omistus perustuu sähköiseen merkintään, ja arvolla false, jos omistus perustuu osakekirjaan tai osakkeen muotoa ei ole vielä vahvistettu.
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. |
Esimerkit
https://htjws.nls.fi/htj/v1/kysely/osakeryhmat/haku?ytunnus=6583621-2
Esimerkkivastaus lakannut osakeryhmä
Yhtiön perustiedot
Tiedot voidaan pyytää huoneistotietojärjestelmässä olevasta voimassa olevasta yhtiöstä. Rakenteessa esitetään tulosteiden osiossa "Yhtiö" esiintyvät 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. |
Esimerkit
https://htjws.nls.fi/htj/v1/kysely/yhtiot/perustiedot?ytunnus=6583621-2
Osakeryhmän perustiedot
Tiedot voidaan pyytää huoneistotietojärjestelmässä olevan yhtiön voimassa olevasta, syntyvästä ja lakkaavasta osakeryhmästä. Rakenteessa esitetään tulosteiden osiossa "Osakeryhmä" esiintyvät 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/osakeryhmat/perustiedot?ytunnus=6583621-2&osakeryhmatunnus=OHH88072226R4052
Esimerkkivastaus voimassa oleva
Esimerkkivastaus aikaisempi osakeryhmätunnus
Osakeryhmän hallintakohteet
Tiedot voidaan pyytää huoneistotietojärjestelmässä olevan yhtiön voimassa olevasta, syntyvästä ja lakkaavasta osakeryhmästä. Rakenteessa esitetään osakehuoneistotulosteen osiossa "Osakeryhmällä hallittavat tilat" esiintyvät 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/osakeryhmat/hallintakohteet?ytunnus=6583621-2&osakeryhmatunnus=OHH88072226R4052
Esimerkkivastaus voimassa oleva
Osakeryhmän omistajat
Tiedot voidaan pyytää huoneistotietojärjestelmässä olevan yhtiön voimassa olevasta, syntyvästä ja lakkaavasta osakeryhmästä. Rakenteessa esitetään osakehuoneistotulosteen osiossa "Omistusoikeudet" esiintyvät tiedot. Osakehuoneistotulosteen kuvauksen löydät täältä .
Kyselyssä palautetaan kaikki osakeryhmälle rekisteröidyt omistukset tilassa: vireillä, voimassa oleva, ehdollinen, ei lainvoimaisesti ratkaistut sekä tieto mahdollisesti vireillä olevasta omistuksen korjaamisesta.
Tuotteesta on saatavilla suppea ja laaja versio. Suppeassa palautetaan henkilöstä nimi, syntymäaika ja mahdollinen kuolinpäivä. Laajassa palautetaan henkilöstä nimi, henkilötunnus ja mahdollinen kuolinpäivä.
Tietojen luovutuskiellossa olevasta osakkeen omistajasta palautetaan kaikki vastaavat tiedot kuin " ei tietojen luovutuskiellossa" olevasta omistajasta.
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
Suppea: https://htjws.nls.fi/htj/v1/kysely/osakeryhmat/omistajat-suppea?ytunnus=4651585-1&osakeryhmatunnus=OHU34KRC6GTL5S12
Esimerkkivastaus hyväksytty omistuksen rekisteröinti
Laaja: https://htjws.nls.fi/htj/v1/kysely/osakeryhmat/omistajat-laaja?ytunnus=4651585-1&osakeryhmatunnus=OHU34KRC6GTL5S12
Esimerkkivastaus hyväksytty omistuksen rekisteröinti
Esimerkkivastaus ehdollinen omistuksen rekisteröinti
Esimerkkivastaus hyväksytty omistuksen rekisteröinti saaja kuolinpesä
Esimerkkivastaus omistuksen rekisteröinti vireillä
Esimerkkivastaus kun osakeryhmän tila syntyvä
Osakeryhmän panttaukset
Tiedot voidaan pyytää huoneistotietojärjestelmässä olevan yhtiön voimassa olevasta, syntyvästä ja lakkaavasta osakeryhmästä. Rakenteessa esitetään osakehuoneistotulosteen osiossa "Panttioikeudet" esiintyvät tiedot. Osakehuoneistotulosteen kuvauksen löydät täältä .
Kyselyssä palautetaan kaikki osakeryhmälle rekisteröidyt panttaukset tilassa: vireillä, voimassa oleva, jätetty lepäämään, ei lainvoimaisesti ratkaistut.
Kyselyssä palautetaan tiedot myös mahdollisista vireillä olevista panttauksen korjaamisista sekä muuttamis-ja poistamisasioista.
Tuotteesta on saatavilla suppea ja laaja versio. Suppeassa palautetaan henkilöstä nimi, syntymäaika ja mahdollinen kuolinpäivä. Laajassa palautetaan henkilöstä nimi, henkilötunnus ja mahdollinen kuolinpäivä.
Tietojen luovutuskiellossa olevista panttaukseen liittyvistä henkilöstä palautetaan kaikki vastaavat tiedot kuin " ei tietojen luovutuskiellossa" olevista henkilöistä.
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
Suppea:https://htjws.nls.fi/htj/v1/kysely/osakeryhmat/panttaukset-suppea?ytunnus=5063373-8&osakeryhmatunnus=OHXPPQMXD6U3P243
Esimerkkivastaus panttauksen rekisteröinti hyväksytty
Laaja: https://htjws.nls.fi/htj/v1/kysely/osakeryhmat/panttaukset-laaja?ytunnus=5063373-8&osakeryhmatunnus=OHXPPQMXD6U3P243
Esimerkkivastaus panttauksen rekisteröinti hyväksytty
Esimerkkivastaus panttauksen rekisteröinti jätetty lepäämään ja uusi panttaus vireillä
Esimerkkivastaus kun osakeryhmän tila syntyvä
Osakeryhmän rajoitukset
Tiedot voidaan pyytää huoneistotietojärjestelmässä olevan yhtiön voimassa olevasta, syntyvästä ja lakkaavasta osakeryhmästä. Rakenteessa esitetään osakehuoneistotulosteen osioissa "Vallintarajoitukset" ja "Muut rajoitukset" esiintyvät tiedot. Osakehuoneistotulosteen kuvauksen löydät täältä .
Kyselyssä palautetaan kaikki osakeryhmälle merkityt rajoitukset tilassa: vireillä, voimassa oleva, ei lainvoimaiset ratkaisut.
Kyselyssä palautetaan tiedot myös mahdollisista vireillä olevista rajoituksen korjaamisista ja poistamisasioista.
Tuotteesta on saatavilla suppea ja laaja versio. Suppeassa palautetaan henkilöstä nimi, syntymäaika ja mahdollinen kuolinpäivä. Laajassa palautetaan henkilöstä nimi, henkilötunnus ja mahdollinen kuolinpäivä.
Rajoitukseen liittyvät henkilöt esitetään myös henkilöiden osalta joilla on tietojen luovutuskielto.
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
Suppea: https://htjws.nls.fi/htj/v1/kysely/osakeryhmat/rajoitukset-suppea?ytunnus=6116537-8&osakeryhmatunnus=OHPS2FUFRXS48R7
Laaja: https://htjws.nls.fi/htj/v1/kysely/osakeryhmat/rajoitukset-laaja?ytunnus=6116537-8&osakeryhmatunnus=OHPS2FUFRXS48R7
Esimerkkivastaus osakeluettelon siirrossa ilmoitettu rajoitus
Esimerkkivastaus hakemuksesta merkitty rajoitus
Esimerkkivastaus rajoituksen merkitseminen vireillä
Esimerkkivastaus kun osakeryhmän tila syntyvä
Osakeluetteloon merkityt omistajat
Tiedot voidaan pyytää huoneistotietojärjestelmässä olevan yhtiön voimassa olevasta, syntyvästä ja lakkaavasta osakeryhmästä.
Kyselyssä palautetaan osakeryhmän osalta osakeluetteloon merkityt omistajat. Henkilöomistajista palautetaan omistajien nimet, omistusosuus ja merkitsemispäivä. Kuolinpesien osalta palautetaan myös vainajan nimen lisäksi kuolinpesän osakkaiden nimet. Kuolinpesä on voitu tallentaa rekisteriin myös siten, että vainajan ja kuolinpesän osakkaiden nimet on tallennettu etunimi-ja sukunimikenttään jolloin vainajan ja osakkaiden nimet palautetaan samassa etunimi-ja sukunimikentässä. Organisaatio-omistajista kyselyssä palautetaan toiminimen ja muiden tietojen lisäksi y-tunnus. Ulkomaisten organisaatio omistajien osalta palautetaan toiminimi, rekisterinumero, rekisteri, kotipaikka, kotivaltio.
Osakeluettelomerkintä voi perustua yhtiön osakeluettelon siirrossa ilmoitettuun tietoon, omistuksen rekisteröinnin yhteydessä tehtyyn osakeluettelomerkintään tai kaupparekisteristä saadun perustajaosakkaan tietoon.
Jos osakeluetteloon merkityllä henkilöllä on tietojen luovutuskielto (turvakielto tai yhteystietojen luovutuskielto), osakeluettelomerkinnästä palautetaan vain omistusosuus ja osakeluetteloon merkitsemispvm. Tietojen luovutuskiellossa olevan osakeluetteloon merkityn osakkaan osalta kyselyssä ei palauteta henkilön nimeä. Nimitiedon osalta palautetaan "Tietoja ei saatavilla".
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/osakeryhmat/osakeluettelo/omistajat?ytunnus=4651585-1&osakeryhmatunnus=OHU34KRC6GTL5S12
Esimerkki osakeluettelo merkintä
Esimerkki osakeluettelomerkintä kuolinpesä
Esimerkki osakeluettelo turvakielto henkilö
Henkilön omistukset viranomaisille
Rajapinta on käytettävissä vain viranomaisille suomi.fi palveluväylän kautta.
Kysely palauttaa henkilön tai yrityksen voimassa olevat tai voimaan tulevat omistukset sekä kuolinpesäosakkuudet. Tietoja voidaan hakea henkilötunnuksella tai y-tunnuksella.
Omistustietojen palauttaminen edellyttää että omistusasialle on tallennettu voimassa olevan tai voimaan tulevan omistajan henkilö- tai y-tunnus. Kyselyssä palautettavat osakeryhmät voivat olla osakekirjamuotoisia ja sähköisiä. Tiedot voidaan pyytää huoneistotietojärjestelmässä olevan yhtiön voimassa olevasta, syntyvästä ja lakkaavasta osakeryhmästä.
Hakuparametrit
| Nimi | Arvot | Lkm | Kuvaus |
| tunnus | y-tunnus/henkilötunnus | 1 | Tietoja voi hakea osakeryhmän omistajan henkilötunnuksella tai y-tunnuksella. Tunnus voi olla 9-11 merkkiä pitkä |
Esimerkit
Esimerkkivastaus omistaja ja kuolinpesän osakkuus
Koodistot
Rakenteessa esitetään koodistojen nimet ja koodiarvot.
Hakuparametrit
Ei hakuparametreja.
Esimerkit
https://htjws.nls.fi/htj/v1/kysely/koodistot
Tiedotteet
Rakenteessa esitetään palvelun käyttöön liittyvät voimassa olevat tiedotteet, 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
Versiohallinta
Sovellusversio 15.4.2025
Muutokset
Osakeryhmän perustiedot
Tuotteelle lisätty seuraavat uudet tiedot:
- Osakkeen muoto
- Aikaisemmat osakeryhmät
..."aikaisemmatOsakeryhmat": [ { "osakeryhmatunnus": "OH4D47N49EL8KE43" }, { "osakeryhmatunnus": "OH4D47N49EL8KE42" }],..."osakkeenMuoto": { "koodisto": "OSAKEMUOTO", "koodi": "SM"},... |
Osakeryhmän perustiedot -tuotteelle merkattu seuraavat tiedot poistettaviksi tulevissa julkaisuversioissa. Ajankohta vahvistetaan erikseen.
- Sähköinen omistus true/false
- Voimaantulopäivämäärä Osakehuoneistorekisterissä
..."sahkoinenOmistusmerkinta": true,..."voimaantulopvmOsakehuoneistorekisterissa": "2019-07-08",... |
Osakeryhmien haku hakuehdoin (osakeryhmien suppeat tiedot)
Tuote palauttaa myös lakanneet osakeryhmät. Tuotteelle lisätty seuraavat uudet tiedot:
- Osakeryhmän rekisteröintipäivämäärä
- Osakelukumäärä
- Osakkeen muoto
- Osakeryhmän lakkaamispäivämäärä
..."rekisterointipvm": "2019-08-23",..."osakelukumaara": 200,..."osakkeenMuoto": { "koodisto": "OSAKEMUOTO", "koodi": "OK"},..."lakkaamispvm": "2019-09-23",... |
Osakeryhmien haku hakuehdoin-tuotteelle merkattu seuraavat tiedot poistettaviksi tulevissa julkaisuversioissa. Ajankohta vahvistetaan erikseen.
- Sähköinen omistusmerkintä true/false
..."sahkoinenOmistusmerkinta": true,... |
Henkilön omistukset viranomaisille
- Uusi kyselypalvelutuote
- Rajapinta on käytettävissä vain viranomaisille suomi.fi palveluväylän kautta.
- Kyselyt ja esimerkit löytyvät täältä
Sovellusversio 12.3.2025
Muutokset
Osakeryhmän omistukset-tuotteelle lisätty uusi perustelaji koodiarvolla 8 "Aikaisempi omistus, yhtiöjärjestyksen muutos".
"koodisto": "PERUSTELAJI",
"koodi": "8",
"seliteFi": "Aikaisempi omistus, yhtiöjärjestyksen muutos",
"seliteSv": "Tidigare ägande, ändring av bolagsordning",
"voimassaoloAlkaa": "20.01.2025"
Sovellusversio 5.2.2025
Muutokset
Osakeryhmän rajoitukset-tuotteen "vapaaehtoinen selite" maksimi merkkimäärä nostettu 4000 merkkiin. Muutos koskee kaikkia rajoituslajeja.
},
"vapaaehtoinenSelite": {
"type": "string",
"maxLength": 4000,
"description": "Rajoitukseen liittyvä selite."
},
Sovellusversio 14.1.2025
Muutokset
Osakeryhmistä annettavaa tietopalvelua laajennettu:
Tietopalvelua on laajennettu myös uusiin Kaupparekisterissä rekisteröityihin osakeryhmiin yhtiöissä, joissa on tehty yhtiöjärjestyksen muutos. Tällaisesta osakeryhmästä saa tietopalvelua heti sen rekisteröinnistä alkaen.
Kaikista tuotteista voidaan pyytää tiedot huoneistotietojärjestelmässä olevan yhtiön voimassa olevasta, syntyvästä ja lakkaavasta osakeryhmästä.
- Uuden kaupparekisterissä rekisteröidyn osakeryhmän tila on huoneistotietojärjestelmässä "Syntyvä", kunnes osakeryhmän tiedot on tarkistettu ja mahdolliset rekisteröinnit on kohdistettu tai haettu. Tällaisen osakeryhmän tiedot eivät ole vielä ajan tasalla.
- Osakeryhmän tila on "Voimassa", kun osakeryhmän tiedot on tarkistettu ja rekisteröinnit kohdistettu huoneistotietojärjestelmässä.
- Osakeryhmän tila on "Lakkaava", jos se on lakannut kaupparekisterissä, mutta sillä on rekisteröintejä, joita täytyy mahdollisesti kohdistaa uusille osakeryhmille.
Muutokset osakeryhmän tilaa palauttaviin tuotteisiin
Osakeryhmän haku hakuehdoin ja Osakeryhmän perustiedot Osakeryhman_tila koodisto palauttaa nyt myös osakeryhmän tilan koodiarvoa 3 (syntyvä)
"olotila": {
"koodisto": "OSAKERYHMAN_TILA",
"koodi": "3"
Aikaisemmin tiedot palautettiin vain, kun osakeryhmän tila on "voimassa" (koodiarvo 1) ja "lakkaava" (koodiarvo 4).
Muutos Osakeryhmän perustiedot ja Osakeryhmien haku hakuehdoin -tuotteissa:
Osakeryhmän tietona näytettävään sahkoinenOmistusmerkinta false-arvon palauttamiseen on tehty muutos. False-arvo palautetaan myös kun osakkeen muotoa ei ole vielä vahvistettu. SahkoinenOmistusmerkinta tietoa näytetään rajapinnoissa: Osakeryhmän perustiedot, Osakeryhmien haku hakuehdoin.
- sahkoinenOmistusmerkinta arvo "false" palautetaan, kun osakkeen muoto on osakekirja tai sitä ei ole vielä vahvistettu.
- sahkoinenOmistusmerkinta arvo "true" palautetaan, kun osakkeen muoto on sähköinen merkintä.
Osakeryhman_huomio koodistoa on päivitetty
Osakeryhman_huomio-koodiston koodiarvoa 3 on päivitetty. Koodiarvo 3 palautetaan osakeryhmille, joiden tila on lakkaava (koodiarvo 4):
- "koodisto": "OSAKERYHMAN_HUOMIO",
"koodi": "3",
"seliteFi": "Osakeryhmä on lakannut yhtiöjärjestyksen muutoksessa. Tiedot eivät ole huoneistotietojärjestelmässä ajan tasalla.",
"seliteSv": "Aktiegruppen har upphört vid en ändring av bolagsordningen. Uppgifterna i bostadsdatasystemet är inte uppdaterade..",
"voimassaoloAlkaa": "14.01.2025"
Osakeryhman_huomio-koodistoon on lisätty uusi koodiarvo 7. Koodiarvo 7 palautetaan osakeryhmille, joiden tila on syntyvä (koodiarvo 3):
- "koodisto": "OSAKERYHMAN_HUOMIO",
"koodi": "7",
"seliteFi": "Osakeryhmä on syntynyt yhtiöjärjestyksen muutoksessa. Tiedot eivät ole huoneistotietojärjestelmässä ajan tasalla.",
"seliteSv": "Aktiegruppen har uppstått vid en ändring av bolagsordningen. Uppgifterna i bostadsdatasystemet är inte uppdaterade.",
"voimassaoloAlkaa": "14.01.2025"
Muutokset rajoituslaji-koodistoon
Rajoituslaji-koodistoon lisätty uusi rajoituslaji koodiarvo 41 "Tieto osakeluetteloon merkitystä omistajasta ja mitätöimättömästä osakekirjasta" :
- "koodisto": "RAJOITUSLAJI",
"koodi": "41",
"seliteFi": "Tieto osakeluetteloon merkitystä omistajasta ja mitätöimättömästä osakekirjasta",
"seliteSv": "Uppgift om ägare som antecknats i aktieboken och om icke makulerat aktiebrev",
"voimassaoloAlkaa": "14.01.2025"
Sovellusversio 7.11.2024
Muutokset
- Tietopalvelukoodiston saantolaji-koodistoon aktivoitu saantolajit
- "koodi": "4","seliteFi": "Perintö","seliteSv": "Arv","voimassaoloAlkaa": "01.01.2000"
- "koodi": "5","seliteFi": "Testamentti","seliteSv": "Testamente","voimassaoloAlkaa": "01.01.2000"
- "koodi": "13","seliteFi": "Perinnönjako","seliteSv": "Arvskifte","voimassaoloAlkaa": "01.01.2000"
- "koodi": "15","seliteFi": "Ositus ja perinnönjako","seliteSv": "Avvittring och arvskifte","voimassaoloAlkaa": "01.01.2000"
- "koodi": "31","seliteFi": "Jakautuminen","seliteSv": "Delning","voimassaoloAlkaa": "01.01.2000"
Sovellusversio 19.6.2024
Muutokset
- Rajoituslajikoodistosta lakkautettu rajoituslajit koodiarvo 2 "Muuta rajoitusta koskeva riita" ja koodiarvo 33 "Asunto-osakkeen saantoon kohdistuu yhtiöjärjestyksen mukainen muu vaihdannanrajoitus"
"koodisto": "RAJOITUSLAJI",
"koodi": "2",
"seliteFi": "Muuta rajoitusta koskeva riita",
"seliteSv": "Tvist om en annan begränsning",
"voimassaoloAlkaa": "01.01.2000",
"voimassaoloPaattyy": "01.05.2024"
"koodisto": "RAJOITUSLAJI",
"koodi": "33",
"seliteFi": "Asunto-osakkeen saantoon kohdistuu yhtiöjärjestyksen mukainen muu vaihdannanrajoitus",
"seliteSv": "Förvärv av bostadsaktie omfattas av en annan begränsning av omsättning i enlighet med bolagsordningen",
"voimassaoloAlkaa": "01.01.2000",
"voimassaoloPaattyy": "01.05.2024"
Sovellusversio 7.2.2024
Muutokset
- Osakeryhmän huomiot koodistosta lakkautettu koodiarvo 1
"koodisto": "OSAKERYHMAN_HUOMIO",
"koodi": "1",
"seliteFi": "Turvakielto tai yhteystietojen luovutuskielto",
"seliteSv": "Spärrmarkering el. förbud mot utlämning av kontaktuppgifter",
"voimassaoloAlkaa": "01.01.2023",
"voimassaoloPaattyy": "09.01.2024"
- Yhdenkään osakeryhmään liittyvän henkilön luovutuskielto ei enää jatkossa piilota osakeryhmiltä muiden henkilötietoja. Tietojen luovuvutuskiellossa olevasta henkilöstä palautetaan jatkossa kaikki samat tiedot kuin "ei tietojen luovutuskiellossa" olevasta henkilöstä, lukuun ottamatta "Osakeluetteloon merkityt omistajat" kyselyä. Tässä kyselyssä tietojen luovutuskiellossa olevan henkilön nimeä ei näytetä.
Sovellusversio 3.1.2024
Muutokset
- Osakeluetteloon merkityt omistajat
- Uusi kyselypalvelutuote. Tuote sisältää osakeryhmän jokaisen osakeluetteloon merkittyjen omistajien tiedot. Kyselyssä palautetaan omistajan omistusosuus, omistajan nimi, osakeluetteloon merkintä päivä
- Kyselyt ja esimerkit täältä
Virheiden hallinta
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. |
Koekäyttöympäristö
Aineisto
Koekäyttöympäristössä on vain pieni kuvitteellinen aineisto. Aineistossa on:
- 6583621-2
- vanha voimassa oleva asunto-osakeyhtiö
- yhtiö on jo siirtänyt osakeluettelonsa huoneistotietojärjestelmään
- yksi voimassa oleva osakeryhmä, jonka omistus perustuu edelleen osakekirjaan
- kaikki kyselyt ja tulosteet palauttavat vastauksen
- 4651585-1
- vanha voimassa oleva asunto-osakeyhtiö
- yhtiö on jo siirtänyt osakeluettelonsa huoneistotietojärjestelmään
- kolme voimassa olevaa osakeryhmää, joilla kaikilla sähköinen omistuskirjaus
- kaksi lakkaavaa osakeryhmää, joilla kaikilla sähköinen omistuskirjaus
- kaikki kyselyt ja tulosteet palauttavat vastauksen
- 8642123-5
- vanha voimassa oleva keskinäinen kiinteistöosakeyhtiö
- yhtiö on jo siirtänyt osakeluettelonsa huoneistotietojärjestelmään
- kolme voimassa olevaa osakeryhmää, joilla kaikilla sähköinen omistuskirjaus
- kaksi lakkaavaa osakeryhmää, joilla kaikilla sähköinen omistuskirjaus
- yhtiön muutostietojen siirto kaupparekisteristä on estynyt ja yhtiön tiedot eivät ole ajantasaisia
- kaikki kyselyt ja tulosteet palauttavat vastauksen
- 8787078-8
- vanha voimassa oleva asunto-osakeyhtiö
- yhtiö ei ole vielä siirtänyt osakeluetteloaan huoneistotietojärjestelmään
- ainoastaan yhtiöiden haku hakuehdoin palauttaa vastauksen
- 6373566-1
- lakannut asunto-osakeyhtiö
- ainoastaan yhtiöiden haku hakuehdoin palauttaa vastauksen
- 2513126-9
- yhtiö on muuttanut yhtiömuotonsa asunto-osakeyhtiöstä tavalliseksi osakeyhtiöksi, eikä se siksi enää kuulu huoneistotietojärjestelmään
- ainoastaan yhtiöiden haku hakuehdoin palauttaa vastauksen
- 1815350-7
- vanha voimassa oleva asunto-osakeyhtiö
- yhtiö on siirtänyt osakeluettelonsa huoneistotietojärjestelmään
- yhtiöllä on osakeryhmiä, joilla kaikilla omistus perustuu edelleen osakekirjaan
- kaikki kyselyt ja tulosteet palauttavat vastaukset
- 0498222-4
- Yhtiö on siirtänyt osakeluettelonsa huoneistotietojärjestelmään
- Kaikki kyselyt ja tulosteet palauttavat vastaukset
Testitapaukset (päivitetty 16.4.2025)
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ä.
Tuotteet
Kaikki palvelun tuotteet ovat koekäytettävissä.
Tuotantopalvelussa olevasta tuotteen kyselyosoitteesta saa koekäyttöpalvelun osoitteen vaihtamalla osoitteen alkuun htjws.nls.fi -> htjwsint.nls.fi
Esimerkiksi osakeryhmän perustiedot:
https://htjwsint.nls.fi/htj/v1/kysely/osakeryhmat/perustiedot?ytunnus=6583621-2&osakeryhmatunnus=OHH88072226R4052