VTJ-muutosrajapinta
VTJ-muutosrajapinnan avulla julkishallinnon organisaation henkilörekisteriin päivitetään väestötiedoissa tapahtuneet muutokset. VTJ-muutosrajapinta korvaa Muutostietopalvelun. Muutostietopalvelu on käytössä 30.6.2026 saakka.
VTJ-muutosrajapinnassa asiakas voi itse valita tietojen päivitysrytmin. Joustavan päivitysrytmin ansiosta tiedot ovat paremmin ajan tasalla kuin aiemmassa Muutostietopalvelussa. Päivitysrytmi voi olla esimerkiksi kerran vuorokaudessa.
Jos organisaatio on aiemmin ollut Muutostietopalvelun käyttäjä, muuttuvat aineistoformaatti ja tietojen välitystapa vaihdettaessa VTJ-muutosrajapintaan. Tämä vaatii muutoksia myös tekniseen toteutukseen, jolla asiakkaan rekisteri päivitetään. Palvelun aloituksen yhteydessä asiakkaan rekisteriin välitetään sovitut perustiedot kaikista rekisterin henkilöistä.
Kunta tai hyvinvointialue, tervetuloa tutustumaan VTJ-muutosrajapinnan haku- ja käyttöönottoprosessiin.yja-document-link-opens-in-a-new-tab
Julkishallinnon toimija, tervetuloa tutustumaan VTJ-muutosrajapinnan haku- ja käyttöönottoprosessiinyja-document-link-opens-in-a-new-tab.
VTJ-muutosrajapinnan hakeminen ja käyttöönotto
Palveluväylä
VTJ-muutosrajapinnan tietoja välitetään Digi- ja väestötietoviraston Suomi.fi-palveluväylän kautta.
Suomi.fi-palveluväylän Kehittäjän opasLinkki toiselle sivustolleyja-external-link-opens-in-a-new-tab sisältää ohjeet Suomi.fi-palveluväylän käyttöönoton hallinnollisista ja teknisistä toimenpiteistä.
VälitoimijamallinLinkki toiselle sivustolleyja-external-link-opens-in-a-new-tab avulla myös IT-toimittaja tai muu palveluntarjoaja voi täyttää Palveluväylän käyttölupahakemuksen asiakasorganisaation, esimerkiksi kunnan tai hyvinvointialueen, puolesta ja lähettää sen tälle hyväksyttäväksi.
Testausrajapinta
Testi-hiekkalaatikon käyttö avoimen rajapinnan kautta
VTJ-muutosrajapinnan esittelyä ja testausta varten on käytössä niin sanottu hiekkalaatikko-sivustoLinkki toiselle sivustolleyja-external-link-opens-in-a-new-tab. Testi-hiekkalaatikon käyttö on mahdollista avoimen rajapinnan kautta ilman rekisteröitymistä tai erillistä lupaa.
Testi-hiekkalaatikon käyttö Suomi.fi-Palveluväylän kautta
Rajapinnan uusi osoite 19.9.2023 alkaen on api.hiekkalaatikko.muutostietopalvelu.dvv.fi. Osoitteen muutoksen myötä asiakkaat voivat testata ja käyttää testi-hiekkalaatikkoa myös käyttäen Suomi.fi-Palveluväylää (https://dvv.fi/palveluvayla).
Palveluväylän testiyhteyden käyttöönotto edellyttää, että käyttäjäorganisaatiolle on myönnetty Palveluväylän käyttölupa ja organisaatiolla on käytössään liityntäpalvelin, johon lisätään testi-alijärjestelmä.
Rekisteröidylle/lisätylle testi-alijärjestelmälle tulee myös hakea käyttölupaa. Täytetty alijärjestelmän käyttölupahakemusyja-document-link-opens-in-a-new-tab lähetetään osoitteeseen: muutostietopalvelu@dvv.fiyja-external-link-opens-in-a-new-tab.
Alijärjestelmän käyttöluvan myöntämisen jälkeen organisaatio voi testata ja käyttää testi-hiekkalaatikkoa Palveluväylän kautta.
Hiekkalaatikon tiedot eivät sisällä oikeita henkilötietoja, vaan henkilötunnukset ja muut henkilötiedot ovat testiaineistoja. Tietoja voi käyttää erilaisiin palvelunkehitystehtäviin ja palvelun testaamiseen. Testihenkilötunnukset, jotka alkavat numerolla 9, eivät ole koskaan oikeiden henkilöiden henkilötunnuksia vaan testitunnuksia.
VTJ-muutosrajapinnan tietolupa
Hae VTJ-muutosrajapinnan tietolupaa Digi- ja väestötietoviraston verkkoasioinnissaLinkki toiselle sivustolleyja-external-link-opens-in-a-new-tab.
Perehdy hakemusohjeisiin ennen tietolupahakemuksen täyttämistä:
Kunnille ja kuntayhtymille sekä hyvinvointialueille on myönnetty organisaation viranomaistehtävien hoitoa varten yleiset tietoluvat eli niin kutsutut kattoluvat. Kattolupa valitaan verkkoasioinnissa. Tutustu kattolupiin:
Hakemuksen käsittelyaika riippuu muun muassa luovutettavista tiedoista. Palvelun käyttöönottoaikataulusta sovitaan erikseen asiakkaan kanssa.
VTJ-muutosrajapinnan tuotteet ja tietosisällöt
Kuntarajaustuotteet
- K2000 väestötiedot kunnilleTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab
- K2000 2.0 väestötiedot kunnilleTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab
- Laajat väestötiedot kunnilleTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab
- Laajat 2.0 väestötiedot kunnilleTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab
- K2000 väestötiedot hyvinvointialueilleTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab
Kuntarajaustuotteet soveltuvat kunnan oman väestörekisterin tai hyvinvointialueen toimialueen kuntien asukkaiden tietojen päivitykseen. Päivitys tapahtuu henkilöiden kotikunnan perusteella.
Henkilötunnuksella rajattavat tuotteet
- OPPIJA varhaiskasvatuksen, perusopetuksen, lukiokoulutuksen ja ammatillisen koulutuksen rekisteri kunnilleTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab
- VAKA varhaiskasvatusrekisteriTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab
- ASREK asiakasrekisteriTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab
- Palveluseteli- ja ostopalvelutTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab
- JoukkoliikenneTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab
- OPISKELIJA tutkintoon johtavaa koulutusta antavien oppilaitosten rekisteriTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab. HakemusohjeTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab.
Henkilötunnuksella rajattavilla tuotteilla voi päivittää esimerkiksi kunnan asiakas- tai laskutusrekisteriä tiettyjen palvelujen käyttäjistä.
Päivitys tapahtuu luvansaajan rekisterissä olevien henkilötunnusten perusteella. Luvansaajan tulee itse ylläpitää henkilötunnuslistaa, jonka perusteella rekisteriä päivitetään.
Kunnan päivitystarpeet ja VTJ-muutosrajapinnan tuotteet
Katso kuvausyja-document-link-opens-in-a-new-tab, miten VTJ-muutosrajapinnan tuotteet soveltuvat kunnan päivitystarpeisiin.
Julkishallinnon toimijoiden tuotteet
Viranomaisille ja viranomaistehtäviä hoitaville toimijoille voidaan räätälöidä poimintaehtoja, joilla henkilöiden tietoja päivitetään.
Usein kysytyt kysymykset
Kyllä, uusi VTJ-muutosrajapinta-palvelu korvaa vanhan palvelun siirtymäajan jälkeen. Nykyisen kaltaista peräkkäistiedostoa toimitetaan siirtymäajan.
Vanhaan Muutostietopalveluun ei tehdä enää muutoksia, eikä siihen oteta uusia käyttäjiä. Vanhaan palveluun voi edelleen tilata perustietoaineistoja. Siirtymäajan jälkeen vanha palvelu poistuu käytöstä.
VTJ-muutosrajapinnan käyttöönottomaksu on 1000 euroa per yhteys.
- Käyttöönottomaksua ei veloiteta silloin, kun nykyisen Muutostietopalvelun asiakas siirtyy uuden VTJ-muutosrajapinnan käyttäjäksi. Jos päivitettäväksi tulee useita rekistereitä eri yhteyksien kautta, veloitetaan käyttöönottomaksu jokaisesta uudesta yhteydestä.
Palvelun käyttö on käyttöönoton jälkeen maksutonta Valtiovarainministeriön maksuasetuksen 1136/2021 2 §:ssä (linkki) mainituille valtion ja kuntien viranomaisille.
Tietoyksikköhinta veloitetaan niiltä asiakkailta, jotka eivät ole oikeutettuja maksuttomaan palveluun.
- Muutostietojen tietoyksikköhinta on 0,036 euroa per tietue.
Palvelun kautta välitetään samoja väestötietojärjestelmän henkilö- ja rakennustietoja kuin nykyisessäkin Muutostietopalvelussa. Tietoja välitetään tietoryhmittäin käyttötarpeen ja myönnetyn luvan mukaisesti.
- Tietojenvälitys tapahtuu REST-rajapinnan kautta.
- Uusi välitysreitti on Suomi.fi-palveluväylä.
- Uusi aineistoformaatti on JSON.
- Palvelussa on UTF-8 merkistön tuki.
Kyllä, tietojen päivitysrytmi on voi olla tiheämpi, ja tietojen ajantasaisuus on siten parempi. Päivitysrytmi on joustava, ja asiakas voi itse valita, kuinka usein hakee rekisteriinsä päivityksiä. Tietoja voidaan hakea esimerkiksi kerran vuorokaudessa tai kerran tunnissa.
- Henkilötietoja voidaan hakea henkilötunnuksilla. Asiakas voi lisätä päivitykseen omassa rekisterissään olevia henkilöitä henkilötunnuksen perusteella.
- Kunnat, sairaanhoitopiirit ja kuntayhtymät voivat hakea henkilötietojen päivityksiä kuntarajauksen perusteella.
- Valtakunnallista rekisteriä pitäville viranomaisille voidaan räätälöidä poimintaehtoja, joilla henkilöiden tietoja päivitetään.
Uuteen palveluun siirryttäessä tietoluvat uusitaan. Asiakas tekee verkkoasioinnin kautta hakemuksen uudesta tietoluvasta.
Kunnille, kuntayhtymille ja hyvinvointialueille on myönnetty yhteinen kattolupa saada tietoja viranomaistehtävien hoitoon, jolloin käyttäjäorganisaatiot voivat tilata tietoja luvan puitteissa.
Hakemus tai tilaus tehdään Digi- ja väestötietoviraston verkkoasioinnin kautta. Palvelun käyttölupaan liittyvät kysymykset voi lähettää osoitteella muutostietopalvelu@dvv.fiyja-external-link-opens-in-a-new-tab
VTJ-muutosrajapinnan esittelyä ja testausta varten on käytössä niin sanottu hiekkalaatikko-sivusto. Palvelu ei vaadi kirjautumista ja on vapaasti asiakkaiden ja ohjelmistokehittäjien käytettävissä.
Tietoja voi käyttää erilaisiin palvelunkehitystehtäviin ja palvelun testaamiseen. Tiedot eivät sisällä oikeita henkilötietoja, vaan henkilötunnukset ja muut henkilötiedot ovat testiaineistoja. Testihenkilötunnukset, jotka alkavat numerolla 9, eivät koskaan ole oikeiden henkilöiden henkilötunnuksia vaan testitunnuksia.