VTJ-muutosrajapinta
VTJ-muutosrajapinnan avulla julkishallinnon organisaation henkilörekisteriin päivitetään väestötiedoissa tapahtuneet muutokset. VTJ-muutosrajapinta korvaa Muutostietopalvelun vuoden 2024 loppuun mennessä. Nykyinen Muutostietopalvelu toimii siihen saakka uuden palvelun rinnalla.
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.
Testausrajapinta
VTJ-muutosrajapinnan esittelyä ja testausta varten on käytössä niin sanottu hiekkalaatikko-sivusto. Palvelu ei vaadi kirjautumista, ja se on vapaasti asiakkaiden ja ohjelmistokehittäjien käytettävissä.
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 hakeminen ja käyttöönotto
Palveluväylä
VTJ-muutosrajapinnan tietoja välitetään Digi- ja väestötietoviraston Suomi.fi-palveluväylän kautta. Jos organisaatiollanne ei jo ole käytössä Palveluväylää, tutustu palveluväylään ja täytä käyttölupahakemus.
Lisää seuraavaksi alijärjestelmä liityntäpalvelimelle. Löydät ohjeet Suomi.fi-palveluhallinnan verkkosivuilta.
Kun Palveluväylän käyttölupa on myönnetty ja alijärjestelmä(t) lisätty liityntäpalvelimelle, lähetä Palveluväylän alijärjestelmän lupahakemus osoitteeseen [email protected]
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.
VTJ-muutosrajapinnan tietolupa
Hae VTJ-muutosrajapinnan tietolupaa Digi- ja väestötietoviraston verkkoasioinnissa.
Hakemusohjeet:
- VTJ-muutosrajapinnan hakemusohjeet julkishallinnon asiakkaille
- VTJ-muutosrajapinnan hakemusohjeet kunnille ja hyvinvointialueille
Palvelun tilauksen yhteydessä on annettava selvitys tietojen suojauksesta ja käyttötarkoituksesta.
Kunnille ja kuntayhtymille sekä hyvinvointialueille on myönnetty organisaation viranomaistehtävien hoitoa varten yleiset tietoluvat eli niin kutsutut kattoluvat. Näiden organisaatioiden ei tarvitse hakea erikseen lupaa, vaan palvelun voi tilata verkkoasioinnin kautta. Tutustu kattolupiin:
- Kunnat ja sosiaali- ja terveystoimen kuntayhtymät sekä sairaanhoitopiirit DVV/4081/2021
- Sosiaali- ja terveystoimen hyvinvointialueet DVV/10082/2022
Hakemuksen tai tilauksen käsittelyaika riippuu tilauksen koosta ja luovutettavista tiedoista. Palvelun käyttöönottoaikataulusta sovitaan erikseen asiakkaan kanssa.
VTJ-muutosrajapinnan tuotteet ja tietosisällöt
Kuntarajaustuotteet kunnille ja 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 kunnille
- ASREK Kunnan asiakasrekisteri
- Joukkoliikenne laskutus
- OPPIJA Perusopetuksen rekisteri
- VAKA varhaiskasvatusrekisteri
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, ainakin vuoden 2024 loppuun 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)