Ajankohtaista
VTJkysely-rajapinnan liiketaloudelliset hinnat muuttuivat 1.9.2024. Lataa uusi liiketaloudellinen hinnasto tästä.
VTJkysely-rajapinta
VTJkysely-rajapinnan kautta organisaatio voi hakea väestöjärjestelmästä yksittäisiä, reaaliaikaisia tietoja suoraan omaan tietojärjestelmäänsä.
VTJkysely-rajapinta sopii organisaatiolle, joka haluaa esimerkiksi
-
tarkistaa asiakkaiden perustietoja
-
tarjota omille asiakkailleen sähköisen asioinnin palveluita
-
tarkistaa tietojen oikeellisuutta hakemusten käsittelyprosesseissa.
Organisaation käyttöön luovutettavista VTJ-tiedoista ja niiden käyttötarkoituksesta sovitaan aina tapauskohtaisesti Digi- ja väestötietoviraston kanssa.
Digi- ja väestötietovirasto palvelee julkisen sektorin organisaatioita.
Välittäjäyritykset palvelevat yksityisen sektorin organisaatioita.
Liity häiriötiedotelistalle
- Häiriötiedotelistalla oleviin sähköpostiosoitteisiin tiedotetaan mahdollisista häiriöistä VTJkysely-rajapinnassa. Ilmoittaudu tästä.
VTJkysely-rajapinta ei saa käyttää oman rekisterin tietojen säännölliseen tai laajamittaiseen päivittämiseen tai muihin massamuotoisiin kyselyihin. Tällaiseen tarpeeseen soveltuvat Digi- ja väestötietoviraston asiakasrekisterien päivityspalvelut julkishallinnolle ja yksityisille yrityksille ja yhteisöille.
VTJkysely-rajapinnasta haetaan ja vastaanotetaan tietoja XML-muotoisina sanomina. Tarkempaa tietoa rajapinnan teknisestä toteutuksesta löydät VTJkysely-rajapinnan tekninen toteutus ja käyttö -sivulta.
Muistilista ennen asiointia
-
VTJkysely-rajapinnan käyttöönotto edellyttää että julkisen sektorin organisaatiolla on käytössä Suomi.fi-palveluväylä. Ohje Suomi.fi-palveluväylän käyttöönottoon.
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ä, edustatko julkishallinnon organisaatiota vai yritystä tai yhteisöä.
-
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 [email protected]
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.
Käsittelyaika
VTJkysely-rajapinnan tietolupahakemuksen käsittelyaika on noin kolme kuukautta. Käsittelyaika sisältää hakemuksen täydennyspyynnöt, neuvottelut ja teknisen järjestelmän arvioinnin.
Hinta
- VTJkysely-rajapinnan käyttö on maksutonta kunnan ja valtion viranomaisille sekä hyvinvointialueille.
- Muille lakisääteistä tehtävää suorittaville julkissektorin asiakkaille sekä yksityissektorin asiakkaille VTJkysely-rajapinnan käyttö laskutetaan kuukausittain tehtyjen kyselyiden määrään perusteella.
- Julkissektorin asiakkailta veloitetaan lisäksi VTJkysely-rajapinnan perustamismaksu.
Yrityksille ja yhteisöille VTJkysely-rajapinnan kautta tehtävät kyselyt ovat maksullisia. Kunkin kyselyn hinta riippuu muun muassa tietosisällön laajuudesta. Myös yhteyden perustamiskustannukset peritään asiakasorganisaatiolta.
VTJkyselyn-rajapinnan kyselyt ovat maksuttomia kunnan ja valtion viranomaisille sekä hyvinvointialueille, mutta palvelun käyttöönotosta peritään perustamismaksu.
Palvelun käyttöönotto
- VTJkysely-rajapinnan perustamismaksu 560 euroa.
Muussa tapauksessa julkissektorin maksut ovat seuraavat
- Suppea kysely 0,037 euroa per kysely
- Peruskysely 0,074 euroa per kysely
- Laaja kysely 0,111 euroa per kysely
- Tunnistuskysely 0,138 euroa per kysely.
Yksityissektorin toimijoille palvelun käytöstä veloitettavat maksut määräytyvät halutun kysely-yhteyden tietosisällön mukaan.
Esimerkkihintoja yksityissektorin maksuista 1.9.2024 alkaen:
• Minikysely 0,22 euroa per kysely
• Peruskysely 0,33 euroa per kysely
• Peruskysely muokattuna 0,49 euroa per kysely
• Laaja kysely 0,61 euroa per kysely
• Laaja kysely muokattuna 0,68 euroa per kysely
• Rakennuksen tunnistuskysely 0,025 euroa per kysely
• Rakennustiedot 0,252 euroa per kysely
VTJkysely-kyselyrajapinnan räätälöinnistä ja asiakkaalle räätälöityjen kyselyiden tekemisestä veloitetaan toteutuneiden kustannusten mukaan.
Liiketaloudellinen hinnasto 1.9.2024 alkaen (Pdf)
Usein kysytyt kysymykset
VTJkysely-rajapinnan käyttöönotto vaatii hieman enemmän työtä kuin VTJkysely-selainsovelluksen käyttöönotto. Tämä johtuu siitä, että kyselyrajapinta vaatii tietojärjestelmän kehitystyötä sekä tietojen käsittelyn suojausta ja lokitusta.
Rajapinta kuitenkin mahdollistaa VTJ-tiedon joustavamman käsittelyn järjestelmässä, joka on rakennettu omaan käyttötarkoitukseenne sopivaksi. Tarkempaa tietoa näistä edellytyksistä ja velvoitteista löydät VTJkysely-rajapinnan tekninen toteutus ja palvelun käyttö -sivulta.
VTJkysely-rajapinnan käyttöönottoon, salasanoihin ja muihin teknisiin ongelmiin liittyvissä asioissa ota yhteyttä VTJkysely-rajapinnan yleisen sähköpostin kautta:
Ilmoita ongelmista tuotannossa asiakastukeen:
- puh. 0203 43 433
- [email protected]
Nopeuta ongelman käsittelyä ilmoittamalla tarkempia tietoja:
- Ongelman alkamisaika
- VTJkysely-rajapinnasta tuleva virheilmoitus
- Käyttäjätunnus
- Rajapintakyselyitä lähettävän palvelimen IP-osoite
- Rajapinnan käyttämä domain-osoite
Linkit asiaan liittyviin lakeihin
Laki väestötietojärjestelmästä ja Digi- ja väestötietoviraston varmennepalveluista (661/2009)
Tietosuojalaki (1050/2018)
Valtiovarainministeriön asetus Digi- ja väestötietoviraston suoritteiden maksuista vuonna 2024 (1142/2023)
- Palvelut henkilöasiakkaille
- Muutto
- Tarkasta omat henkilötietosi
- Tilaa todistus väestötietojärjestelmästä
- Nimenmuutos
- Edunvalvontavaltuutus ja varautuminen
- Aikuisen edunvalvonta
- Näin haet itsellesi edunvalvojaa
- Näin ilmoitat edunvalvontaa tarvitsevasta henkilöstä
- Milloin edunvalvoja tarvitsee luvan?
- Edunvalvojan tehtävät
- Milloin edunvalvoja tarvitsee sijaisen?
- Päämiehen toimintakelpoisuuden rajoittaminen
- Milloin edunvalvonta päättyy?
- Tietoa päämiehen läheisille
- Poissa olevan henkilön tai omaisuuden tulevan omistajan etujen valvominen
- Alaikäisen omaisuuden edunvalvonta
- Lapsen syntymä ja adoptio
- Avioliitto ja parisuhde
- Kuolema ja perunkirjoitus
- Ulkomaalaisena Suomessa
- Ulkomaalaisen rekisteröinti väestötietojärjestelmään
- Opiskelijan opas
- Kotikunta
- Perhesuhteet ja siviilisääty
- Ulkomaalaisen muutto Suomeen, Suomessa ja Suomesta
- Ohjeita Ukrainasta saapuville
- Інструкції для українців
- Erityisasiantuntijoiden ja kasvuyrittäjien pikakaista
- Työntekijän opas
- Laillistamisohje
- Ulkomaisten asiakirjojen toimittaminen
- Julkisen notaarin todistamispalvelut
- Kansalaisuus
- Sukupuolen vahvistaminen
- Uskonnollisen yhdyskunnan jäsenyys
- Vaalit, äänioikeus ja kansalaisaloite
- Kansalaisvarmenne ja sähköinen henkilöllisyys
- Palvelut organisaatioasiakkaille
- Varmenteet ja kortit
- Väestötietopalvelut
- Väestötietojärjestelmän ylläpito
- Maistraattirekisterien hakupalvelut
- Otteet rekistereistä
- Digiturvapalvelut
- Digituki
- Eurooppalainen digitaalinen identiteettilompakko
- Suomi.fi-palvelut
- Digitalisaatiota edistävät palvelut
- Julkisen notaarin palvelut
- Kaupanvahvistus
- Vihkimisoikeus
- Ohjeet hyvinvointialueille
- Finnish Authenticator -tunnistuspalvelu
- Avoin data
- Verkkoasiointi
- Tietoa virastosta
- Digi- ja väestötietovirasto
- Meille töihin
- Asioi sähköisesti
- Yhteystiedot
- Ajankohtaista
- Yleistiedoksiannot ja kuulutukset
- Automaattinen ratkaisumenettely
- Laatupolitiikka
- Asiakkaiden yhdenvertaisuussuunnitelma
- Tietosuoja
- Medialle
- Esitteet ja julkaisut
- Väestötietojärjestelmä
- Hankkeet
- Ennakointi ja tutkimusyhteistyö