Muutostietopalvelu
Muutostietopalvelu tarjoaa isännöintijärjestelmille mahdollisuuden seurata Huoneistotietojärjestelmän tietosisällössä tapahtuvia muutoksia. Muutostietopalvelu kertoo minkä tyyppisiä muutoksia asunto-osakeyhtiöiden (tai keskinäisten kiinteistöosakeyhtiöiden) osakeryhmissä on tapahtunut. Muutostietopalvelun kautta ei voi hakea varsinaista dataa, vaan se pitää noutaa huoneistotietojen kyselypalvelun kautta.
Muutostietorajapinnan kutsumiseen ei tarvita järjestelmälupaa eli pyyntöä ei tehdä kenenkään yksittäisen isännöintitahon nimissä. Varsinaisen muuttuneen datan hakeminen vaatii rajapintojen kutsumista, joissa tarkistetaan järjestelmälupa ja isännöintitahon oikeus käsitellä kyseisiä tietoja.
Rajapinnan tekninen kuvaus
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ä.
Tietojoukon "yhtiotOsakeryhmat" 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
- Huoneistotietojärjestelmään tallennetun osoitteen/sähköpostin lisäys tai muutos tai poisto (Huom! ei koske osakkaan vtj osoitteen muutoksia)
- Omistuksen rekisteröinnistä osakeluettelossa olevalle omistajalle
- Osakkeen muodon muuttamisesta (Huom! Koskee vain tilanteita, kun osakkeen muoto "määrittämätön" vahvistetaan joko sähköiseksi merkinnäksi tai osakekirjaksi)
Kutsun parametrit
| Kentän nimi | Selite | Esimerkkiarvo |
| alkupvm | Tutkittavan aikavälin alkupäivä | "2026-02-01" |
| loppupvm | Tutkittavan aikavälin loppupäivä. Alkupvm ja loppupvm ero max 31 päivää. | "2026-02-28" |
| yTunnukset | Lista y-tunnuksia, joista halutaan muutostiedot. Max. 100 kpl | [ "1234567-8", "2345678-9" ] |
| naytaOmat | Palautetaanko itse lähetetyt muutokset. Liittyy tietojoukkoihin "kumu" ja "taloudelliset" | false |
| tietoJoukot | Lista haettavista tietojoukoista. Sallittuja arvoja on "kumu", "taloudelliset" ja yhtiotOsakeryhmat. Toistaiseksi tuotantokäytössä vain yhtiotOsakeryhmat | [ "yhtiotOsakeryhmat", "kumu" ] |
Vastauksen rakenne
| Kentän nimi | Selite |
| kumu | Tietojoukon kumu muutostapahtumat. |
| taloudelliset | Tietojoukon taloudelliset muutostapahtumat |
| osakeryhmanMuutostiedot | Tietojoukon yhtiotOsakeryhmat muutostapahtumat. |
| hylatyt-ytunnukset | Kysellyt y-tunnukset, jotka ovat virheellisiä. Syitä voi olla esim. viallinen y-tunnus, yhtiö on lakannut tai yhtiö ei ole Huoneistietojärjestelmän piirissä. |
Esimerkkisanoma
POST /htj/isannointi/v1/muutostiedot
{
"alkupvm": "2026-02-01",
"loppupvm": "2026-02-28",
"yTunnukset": [ "1234567-8", "2345678-9", "7008695-4"],
"naytaOmat": false,
"tietoJoukot": [ "yhtiotOsakeryhmat" ]
}
Esimerkkivastaus
{
"osakeryhmanMuutostiedot": [
{
"ytunnus": "7008695-4",
"osakeryhmatunnus": "OHFIMBEN134AB001",
"muutostyyppi": {
"koodisto": "YHTION_MUUTOSTYYPPI",
"koodi": "7"
},
"muutospvm": "2026-02-17T10:47:08"
},
{
"ytunnus": "7008695-4",
"osakeryhmatunnus": "OHFIMBEN134AB030",
"muutostyyppi": {
"koodisto": "YHTION_MUUTOSTYYPPI",
"koodi": "7"
},
"muutospvm": "2026-02-17T10:47:08"
}
],
"hylatyt-ytunnukset": [
"2345678-9",
"1234567-8"
]
Vastauksen schema (vain tietojoukko yhtiotOsakeryhmat käytössä toistaiseksi)
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Muutostiedot",
"type": "object",
"additionalProperties": true,
"properties": {
"osakeryhmanMuutostiedot": {
"type": "array",
"items": {
"$ref": "#/definitions/ExtOsakeryhmanMuutostietoDto"
}
},
"hylatytYhtiot": {
"type": "array",
"items": {
"type": "string"
}
}
},
"definitions": {
"ExtOsakeryhmanMuutostietoDto": {
"type": "object",
"additionalProperties": true,
"properties": {
"ytunnus": {
"type": "string"
},
"osakeryhmatunnus": {
"type": "string"
},
"muutostyyppi": {
"$ref": "#/definitions/ExtKoodiArvoDto"
},
"muutospvm": {
"type": "string",
"format": "yyyy-MM-dd'T'HH:mm:ss"
}
}
},
"ExtKoodiArvoDto": {
"type": "object",
"additionalProperties": true,
"properties": {
"koodisto": {
"type": "string"
},
"koodi": {
"type": "string",
"minLength": 1,
"maxLength": 16
}
},
"required": [
"koodisto",
"koodi"
]
}
}
}