Technical implementation and use of the VTJkysely interface

This page contains technical information on the VTJkysely interface. More general information is available on the VTJkysely interface page.

The VTJkysely interface is a web service that receives and returns messages in accordance with the XML (SOAP) protocol. A query message is sent from the customer organisation's information system via the VTJkysely interface to a service from which the Population Information System data corresponding to the query is returned as a response message.

Do as follows

Read more about the introduction of the VTJkysely interface on the VTJkysely interface pages.

Deploying the VTJkysely interface via the Data Exchange Layer

  1. Join Service Management.
  2. Join the Data Exchange Layer.
  3. Apply for a right to use the test data exchange layer.
  4. Select the appropriate Security Server solution.
  5. Define at least one subsystem for the Security Server.
  6. Test the data exchange layer in the test environment using the Data Exchange Layer test service.
  7. Apply for a right to use VTJkysely interface in data exchange layers test environment. Integrate and test according to the VTJkysely interface instructions.
  8. Apply for a right to use the VTJkysely interface in data exchange layers porduction enviroment and go to the production enviroment.

N.B. You should apply for the VTJkysely interface data permit simultaneously with the Data Exchange Layer permit.

Links to relevant laws

Laki väestötietojärjestelmästä ja Digi- ja väestötietoviraston varmennepalveluista (Act on the Population Information System and the Certificate Services of the Digital and Population Data Services Agency; 661/2009)

Valtioneuvoston asetus väestötietojärjestelmästä (Government Decree on the Population Information System; 128/2010)

Laki hallinnon yhteisistä sähköisen asioinnin tukipalveluista (Act on Central Government’s Joint e-Service Support Services; 571/2016)

Tietosuojalaki (Data Protection Act) (1050/2018)

Laki viranomaisten toiminnan julkisuudesta (Act on the Openness of Government Activities 621/1999)

Directive 95/46/EC (General Data Protection Regulation)

Relevant links

API Catalogue - VTJkysely 

Read more about the Data Exchange Layer