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ä:

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

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

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