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"
]
}
}
}
