VTJ-muutosrajapinta
Uusi VTJ-muutosrajapinta on käyttövalmis
Uusi VTJ-muutosrajapinta korvaa nykyisen muutostietopalvelun. Uusi palvelu on saatavissa henkilötietojen osalta.
VTJ-muutosrajapinnan kautta välitetään samoja väestötietojärjestelmän tietoja ja tietosisällöltään samoja tietoryhmiä kuin nykyisessä muutostietopalvelussa. Uutta on joustava päivitysrytmi ja siten parempi tietojen ajantasaisuus. Päivityksiä on mahdollista hakea asiakkaan itse valitsemassa rytmissä.
VTJ-muutosrajapinnan avulla julkishallinnon organisaatio voi pitää rekisterinsä ajan tasalla. Palvelu soveltuu etenkin päivittäin käytössä olevien suurten rekisterien päivittämiseen.
Muutostietopalvelun käyttö edellyttää Digi- ja väestötietoviraston myöntämää tietolupaa. Tietolupaa haetaan Digi- ja väestötietoviraston verkkoasioinnin kautta. Digi- ja väestötietovirasto on myöntänyt kunnille, sairaanhoitopiireille ja kuntayhtymille kattoluvan muutostietopalvelun käyttöön.
Testausrajapinta
VTJ-muutosrajapinnan esittelyä ja testausta varten on käytössä ns. hiekkalaatikko-sivusto. Palvelu ei vaadi kirjautumista ja on vapaasti asiakkaiden ja ohjelmistokehittäjien käytettävissä. 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 käyttöön ottaminen
VTJ-muutosrajapinnan aineistoformaatti ja tietojenvälitystapa muuttuvat, mikä vaatii muutoksia myös asiakkaan rekisterin päivityksen tekniseen toteutukseen.
Nykyisen muutostietopalvelun mukaista peräkkäistiedostoa toimitetaan vuoden 2024 loppuun saakka. Nykyinen muutostietopalvelu toimii siihen saakka uuden rinnalla. Vanhaan muutostietopalveluun ei tehdä enää muutoksia eikä siihen oteta uusia käyttäjiä.
VTJ-muutosrajapinnan tietoja välitetään Digi- ja väestötietoviraston palveluväylän kautta. Lisätietoa VTJ-muutosrajapinnan tietojen välittämisestä.
Toimi näin:
VTJ-muutosrajapinnan käyttöönotto tapahtuu hakemalla tietolupaa Digi- ja väestötietoviraston verkkoasioinnissa.
VTJ-muutosrajapinnan hakemusohjeet julkishallinnon asiakkaille
VTJ-muutosrajapinnan tilausohjeet kunnille
Palvelun tilauksen yhteydessä on annettava selvitys tietojen suojauksesta ja käyttötarkoituksesta.
Aikataulu
Palvelun hakemuksen tai tilauksen käsittelyaika riippuu tilauksen koosta ja luovutettavista tiedoista. Palvelun käyttöönottoaikataulusta sovitaan erikseen asiakkaan aikataulun mukaisesti.
Hinnasto
Palvelun käyttöönotto:
VTJ-muutosrajapinnan käyttöönoton yhteydessä asiakkaalle välitetään kertaluonteisesti väestöjärjestelmästä luovutettaviksi sovitut tiedot.
VTJ-muutosrajapinnan käyttöönottomaksu on 1000 € / 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ä mainituille valtion ja kuntien viranomaisille
Muutostietojen hinta:
Muutostietojen tietoyksikköhinta: Väestötietojärjestelmän tiedot 0,036 € / tietue.
Tietoyksikköhinta veloitetaan niiltä asiakkailta, jotka eivät ole oikeutettuja maksuttomaan palveluun.
Usein kysytyt kysymykset
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 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 esim. 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.
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 palveluun ei tehdä enää muutoksia, eikä siihen oteta uusia käyttäjiä. Perustietoaineistojen tilaus vanhaan muutostietopalveluun on edelleen mahdollista. Siirtymäajan jälkeen vanha palvelu poistuu käytöstä.
Kuntien vakiomuotoisen muutostietopalvelun tietosisältöjen mukainen VTJ-muutosrajapinta tulee saataville myöhemmin vuoden 2021 aikana.
Uuteen palveluun siirryttäessä tietoluvat uusitaan. Asiakas tekee verkkoasioinnin kautta hakemuksen uudesta tietoluvasta.
Kunnille, kuntayhtymille ja sairaanhoitopiireille on myönnetty yhteinen kattolupa saada tietoja niiden 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ä ns. hiekkalaatikko-sivusto. Palvelu ei vaadi kirjautumista ja on vapaasti asiakkaiden ja ohjelmistokehittäjien käytettävissä. 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.
Linkit asiaan liittyviin lakeihin
Valtiovarainministeriön asetus Digi- ja väestötietoviraston suoritteiden maksuista vuonna 2022 (1136/2021)
Valtiovarainministeriön asetus Digi- ja väestötietoviraston suoritteiden maksuista vuonna 2021 (969/2020)
Laki väestötietojärjestelmästä ja Digi- ja väestötietoviraston varmennepalveluista (661/2009)