Digi- ja väestötietovirasto tarjoaa VTJkysely-rajapintapalvelua julkisille organisaatioille. Palvelun käyttö edellyttää Digi- ja väestötietoviraston myöntämää tietolupaa sekä organisaation sitoutumista luvan ehtoihin. Tietosisällön laajuus määritellään aina organisaatiokohtaisesti virkatehtävien tarpeiden mukaisesti.
VTJkysely-rajapinnan käyttö edellyttää Suomi.fi-palveluväylänLinkki toiselle sivustolleyja-external-link-opens-in-a-new-tab käyttämistä (mahdollista hakea poikkeuslupaa). Palvelinvarmenteen käyttäminen on mahdollista poikkeusluvalla.
Käyttöönottoprosessin kuvausTiedosto avautuu uudessa välilehdessäyja-document-link-opens-in-a-new-tab (pdf)
Lisätietoa: vtjkysely-rajapinta(@)dvv.fi
Toimi näin
Ennen palveluun rekisteröitymistä tutustu Digi- ja väestötietoviraston palveluihin ja verkkoasioinnin käyttöehtoihin asiakassivustollamme.
Hae tietolupa verkkoasioinnissa
a) Jos olet jo rekisteröitynyt asiakastilin käyttäjäksi, kirjaudu sisään rekisteröityessäsi antamallasi sähköpostiosoitteella ja salasanalla tai suomi.fi-tunnistautumisen kautta. Mikäli et muista salasanaasi, paina ”Unohditko salasanasi” -linkkiä.
b) Jos et ole vielä rekisteröitynyt asiakastiliin käyttäjäksi, paina Rekisteröidy-painiketta.
Kirjauduttuasi sisään valitse verkkoasioinnin yläpalkista ”Aloita uusi hakemus” -osio.
Valitse välilehdistä, että edustat julkishallinnon organisaatiota.
Valitse seuraavaksi kohta, jossa lukee ”Haluan hakea tietoja väestötietojärjestelmästä”.
Valitse avautuvasta valikosta ”VTJkysely-rajapinnan tietolupahakemus” ja paina Aloita-painiketta.
Täydennä hakemuksen tiedot. Voit lähettää lomakkeen käsiteltäväksi vasta, kun kaikki tarvittavat kentät on täytetty. Tarkista, että kaikkien kenttien yhteydessä näkyy vihreä symboli, joka ilmaisee, että kenttä on täytetty oikein.
Tarkista lopuksi antamasi tiedot ja paina ”Lähetä DVV:lle” -painiketta.
Mikäli tarvitset apua tietolupahakemuksen tekemisessä, esimerkiksi haettavan tietosisällön tarkassa määrittelemisessä, ota yhteyttä VTJkysely-rajapinnan asiantuntijoihin osoitteessa vtjkysely-rajapinta(@)dvv.fiyja-external-link-opens-in-a-new-tab
Kunnat ja kuntayhtymät sekä sosiaali- ja terveystoimen hyvinvointialueet voivat tilata palvelun verkkoasioinnissa hieman kevennetyllä menettelyllä, sillä niillä on toistaiseksi voimassa olevat kattoluvat VTJkysely-rajapintaan.
Tilauksen yhteydessä on täytettävä selvitys tietojen suojauksesta ja käytöstä sekä käyttöoikeushakemuksen hallintapalveluista.
VTJkysely-rajapinnan käyttöönotto Palveluväylän kautta
1. Liity Suomi.fi-palveluhallintaanLinkki toiselle sivustolleyja-external-link-opens-in-a-new-tab.
2. Liity Suomi.fi-palveluväylään.
3. Hae testiväylän käyttölupaa.
4. Valitse sopiva liityntäpalvelinratkaisu.
5. Määrittele liityntäpalvelimelle vähintään yksi alijärjestelmä.
6. Testaa väylän testiympäristössä Palveluväylän testipalveluilla.
7. Pyydä VTJkysely-rajapinnan käyttölupa Palveluväylän testiympäristöön. Integroi ja testaa VTJkysely-rajapinnan ohjeiden mukaan.
8. Hae Palveluväylän tuotannon käyttölupaa ja siirry tuotantoympäristöön.
VTJkysely-rajapinnan käyttölupaa kannattaa hakea rinnakkain Palveluväylän käyttöluvan kanssa.