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.2025 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.
Julkishallinnon toimija, tervetuloa tutustumaan VTJ-muutosrajapinnan haku- ja käyttöönottoprosessiin.
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 opas sisältää ohjeet Suomi.fi-palveluväylän käyttöönoton hallinnollisista ja teknisistä toimenpiteistä. Vastaa esikysymyksiin, niin saat rajattua ohjeen tietosisällön omaan käyttötilanteeseesi sopivaksi.
Välitoimijamallin avulla myös IT-toimittaja tai muu palveluntarjoaja voi täyttää Palveluväylän käyttölupahakemuksen asiakasorganisaation (esim. kunnan tai hyvinvointialueen) puolesta ja lähettää sen tälle hyväksyttäväksi. Ohjeet välitoimijamallin käyttöönottoon löytyvät Suomi.fi-palveluhallinnan sivuilta.
Testausrajapinta
Testi-hiekkalaatikon käyttö avoimen rajapinnan kautta
VTJ-muutosrajapinnan esittelyä ja testausta varten on käytössä niin sanottu hiekkalaatikko-sivusto. 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ölupahakemus lähetetään osoitteeseen: [email protected].
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 verkkoasioinnissa.
Perehdy hakemusohjeisiin ennen tietolupahakemuksen täyttämistä:
-
VTJ-muutosrajapinnan hakemusohjeet julkishallinnon asiakkaille
-
VTJ-muutosrajapinnan hakemusohjeet kunnille ja hyvinvointialueille
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 kunnille
- Laajat väestötiedot kunnille
- K2000 väestötiedot hyvinvointialueille
- Laajat väestötiedot hyvinvointialueille
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 kunnille
- VAKA varhaiskasvatusrekisteri
- ASREK asiakasrekisteri
- Palveluseteli- ja ostopalvelut
- Joukkoliikenne
- OPISKELIJA tutkintoon johtavaa koulutusta antavien oppilaitosten rekisteri. Hakemusohje.
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 kuvaus, 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, 30.6.2025 saakka.
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 [email protected]
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.
Linkit asiaan liittyviin lakeihin
Valtiovarainministeriön asetus Digi- ja väestötietoviraston suoritteiden maksuista vuonna 2023 (1070/2022)
Valtiovarainministeriön asetus Digi- ja väestötietoviraston suoritteiden maksuista vuonna 2022 (1136/2021)
Laki väestötietojärjestelmästä ja Digi- ja väestötietoviraston varmennepalveluista (661/2009)