Saat parhaat ohjeet tilanteeseesi, kun vastaat ensin kysymyksiin oppaan aloitussivulla.
VTJ-muutosrajapinta on palvelu, jonka avulla organisaatiosi päivittää säännöllisesti omiin rekistereihinsä muutokset väestötietojärjestelmässä (VTJ).
Voit valita tietojen päivitysrytmin itse. Tiedot voidaan noutaa väestötietojärjestelmästä esimerkiksi kerran vuorokaudessa.
VTJ-muutosrajapintaa käytetään Suomi.fi-palveluväylän kautta. Jos organisaatiosi ei vielä käytä Suomi.fi-palveluväylää, se on otettava käyttöön samassa yhteydessä VTJ-muutosrajapinnan kanssa. Saat tästä oppaasta ohjeet myös Palveluväylän käyttöönottoon.
VTJ-muutosrajapinnan käyttöönotto on monivaiheinen prosessi, johon kannattaa varata aikaa ja resursseja. Tutustu yleiskuvaan prosessin vaiheista.
Kun organisaatiosi on jo liittynyt Palveluväylään, on VTJ-muutosrajapintaa käyttöönotettaessa haettava Digi- ja väestötietovirastolta kolme eri lupaa:
Tutustu VTJ-muutosrajapintaan
Aikatauluta ja resursoi käyttöönottoprosessi
Hae VTJ-muutosrajapinnan tietolupaa
Suunnittele VTJ-muutosrajapinnan tekninen käyttöönotto
Kun organisaatiosi alijärjestelmä(t) on lisätty testiliityntäpalvelimelle, hae testialijärjestelmälle käyttölupa VTJ-muutosrajapintaan (PDF)Avautuu uuteen ikkunaan.. Lähetä hakemus osoitteeseen muutostietopalvelu@dvv.fi.
Luvan saatuanne voitte testata VTJ-muutosrajapinnan testihiekkalaatikkoa Palveluväylän kautta.
Kun olette tehneet tarvittavat tekniset toimet testiympäristössä, testaa yhteys Palveluväylään:
Kun organisaatiosi alijärjestelmä(t) on lisätty liityntäpalvelimelle ja olette tehneet tarvittavat tekniset toimet tuotantoympäristössä, lähetä alijärjestelmän käyttölupahakemus VTJ-muutosrajapintaan (PDF)Avautuu uuteen ikkunaan. osoitteeseen muutostietopalvelu@dvv.fi.
DVV myöntää organisaatiollesi alijärjestelmän käyttöluvan VTJ-muutosrajapintaan.
Kun DVV on hyväksynyt VTJ-muutosrajapinnan tietoluvan, saat rajapinnan käyttöön tarvittavat tunnukset ja salasanat.
VTJ-muutosrajapinnan käyttöönotto on monivaiheinen prosessi, johon kannattaa varata aikaa ja resursseja. Tutustu yleiskuvaan prosessin vaiheista.
Käyttöönoton aikana organisaatiosi on haettava Digi- ja väestötietovirastolta viisi eri lupaa:
Tutustu VTJ-muutosrajapintaan
Tutustu Suomi.fi-palveluväylään
Tutustu Palveluväylän käytön mahdollisuuksiin ja velvollisuuksiin.
Aikatauluta ja resursoi käyttöönottoprosessi
Hae VTJ-muutosrajapinnan tietolupaa
Suunnittele Palveluväylän tekninen käyttöönotto
Suunnittele VTJ-muutosrajapinnan tekninen käyttöönotto
Valitse sopivin ratkaisu yhdessä teknisen toteuttajan kanssa
Vaihtoehdot ovat
Asenna ja määrittele alustapalvelin.
Lähetä käyttölupahakemus Palveluväylän testiympäristöön Suomi.fi-palveluhallinnassa.
Jos organisaatiosi ei ole aikaisemmin käyttänyt Palveluhallintaa, perusta ensin uusi organisaatiotili. Lue tarkemmat ohjeet Suomi.fi-palveluhallintaan rekisteröitymisestä.
DVV myöntää organisaatiollesi käyttöluvan Palveluväylän testiympäristöön ja lähettää asennusohjeet tekniselle yhteyshenkilölle.
Kun käyttölupahakemus on hyväksytty, organisaatiosi voi liittyä testiympäristöön teknisesti. Seuraa saamiasi ohjeita:
Kun organisaatiosi alijärjestelmä on lisätty testiliityntäpalvelimelle, hae testialijärjestelmälle käyttölupa VTJ-muutosrajapintaanAvautuu uuteen ikkunaan.. Lähetä hakemus osoitteeseen muutostietopalvelu@dvv.fi.
Luvan saatuanne voitte testata VTJ-muutosrajapinnan testihiekkalaatikkoa Palveluväylän kautta.
Kun olette liittyneet onnistuneesti testiympäristöön, testaa yhteys Palveluväylään:
Kun testiympäristössä tehdyt testit on käyty läpi ja virheet korjattu, voitte siirtyä tuotantoympäristöön.
Hae käyttölupaa Palveluväylän tuotantoympäristöön Suomi.fi-palveluhallinnassa.
DVV myöntää organisaatiollesi käyttöluvan Palveluväylän tuotantoympäristöön ja lähettää asennusohjeet tekniselle yhteyshenkilölle.
Kun käyttölupa tuotantoympäristöön on myönnetty, toista samat tekniset toimenpiteet kuin testiympäristöön liityttäessä.
Kun organisaatiosi alijärjestelmä(t) on lisätty liityntäpalvelimelle ja olette siirtyneet onnistuneesti tuotantoympäristöön, lähetä alijärjestelmän käyttölupahakemusAvautuu uuteen ikkunaan. VTJ-muutosrajapintaan osoitteeseen muutostietopalvelu@dvv.fi.
DVV myöntää organisaatiosi alijärjestelmälle käyttöluvan VTJ-muutosrajapintaan.
Kun DVV on hyväksynyt VTJ-muutosrajapinnan tietoluvan, saat rajapinnan käyttöön tarvittavat tunnukset ja salasanat.
Henkilötietojen käsittely ja luovuttaminen vaatii aina lain mukaisen perusteen. Organisaatiosi on perusteltava väestötietojen käyttötarve VTJ-muutosrajapinnan tietolupahakemuksessa. Selvitä siis jo valmiiksi
Käyttötarkoituksen pitää perustua hakijan tietotarpeeseen. Teknisen järjestelmän vaihtuminen toiseen ei riitä käyttötarkoituksen perusteluksi.
Hyvinvointialueiden ja kuntien tarvitsemia tietoja on VTJ-muutosrajapinnassa ryhmitelty niin, että eri tuotteet sisältävät valmiita rajauksia eri käyttötarkoituksiin. Pohdi organisaatiosi tarpeita ja tutustu VTJ-muutosrajapinnan tuotteisiin tarkemmin Digi- ja väestötietoviraston verkkosivuillaAvautuu uuteen ikkunaan..
Muille julkishallinnon organisaatioille poimittavat tiedot räätälöidään erikseen.
Organisaatiosi tarvitsee väestötietojen käyttöön tietoluvan. Hakemuksen tekee hallinnollinen yhteyshenkilö.
Perustele hakemuksessa organisaatiosi tietotarve ja siihen liittyvä lainsäädäntö. Liitä hakemus organisaatiosi kattolupaan.
DVV voi lähettää käsittelyvaiheessa täydennyspyyntöjä hakemukseesi. Vastaa täydennyspyyntöihin mahdollisimman nopeasti.
Huomaa, että tietoluvan myöntäminen on käyttöönottavan organisaation ja DVV:n välinen juridinen prosessi. Tekninen toimittaja ei siis voi täyttää hakemusta organisaation puolesta. Hakemuksen täyttämiseen saat apua osoitteesta muutostietopalvelu@dvv.fi.
Kun suunnittelet VTJ-muutosrajapinnan käyttöönottoa, huomioi, että palvelussa
Voit tutustua VTJ-muutosrajapintaan ennen käyttöönottoa niin kutsutulla hiekkalaatikkosivustollaAvautuu uuteen ikkunaan.. Voit testata rajapinnan toimintaa vapaasti ilman kirjautumista.
Hiekkalaatikkosivuston tiedot eivät sisällä oikeiden ihmisten aitoja tietoja, vaan henkilötunnukset ja muut henkilötiedot on luotu testausta varten.