How to deploy the query and forwarding service

The implementation of the query and forwarding service will be phased and may take 1 to 2 years, depending on factors like the organisation’s schedule and the status of the system it uses. Support and guidance are available for deployment.

These user instructions are intended for public authorities and other organisations outside the healthcare sector.

Before starting deployment

Start preparations for deployment by identifying which healthcare certificates or data therein your organisation needs for its service provision. Please note that certificates must be recorded by healthcare services in the Kanta Services and your organisation must be legally entitled to receive them.

At the same time, identify how you need to obtain the information on the certificate: 

  • by receiving certificates forwarded by the healthcare services via the forwarding service 
  • by requesting information from a specific certificate through the query service. 

This need determines whether your organisation will deploy the query service, the forwarding service or both. 

Check THL’s and Kela’s instructions:

Instructions on the conditions for joining the service for organisations outside the healthcare sector (pdf, thl.fi, in Finnish)(opens new window)Regulation on documents to be forwarded to parties outside the healthcare sector (pdf, thl.fi, in Finnish)(opens new window)Functional specifications of the query and forwarding service (in Finnish)For a list of certificates to be stored in Kanta and those under development, see the page on the specifications of medical certificates (in Finnish)

If the certificate your organisation needs cannot yet be stored in Kanta, please agree on a process for specifying data content with THL. For more information, please email sotetiedonhallinta@thl.fi.

Submit a report to THL

Once you have identified your organisation’s needs and the basis for deploying the service, please inform THL of the following: 

  • what healthcare certificates or information therein will be forwarded to your organisation
  • the law on which the forwarding is based 
  • whether you are deploying the query service, the forwarding service, or both. 

Please submit the report via email to sotetiedonhallinta@thl.fi.

If necessary, THL will arrange a meeting to go over the matters described in the report. 

The organisations using the query and forwarding service are organisations outside the healthcare sector. As a result, their systems are not subject to the same certification requirements as those of social welfare and healthcare operators.

However, your system needs to be approved by Kela and THL in order to use the query and forwarding service.

Your information system provider will develop the system in parallel with other preparations for deployment.

Information system guidelines

As a party joining the service, you are responsible for complying with the technical information security requirements of the Kanta Query and Forwarding Service (pdf, in Finnish)(opens new window). These requirements apply not only to the information system but also to data communications and the network, their management and, for example, access rights. 

Contact Kela by sending an email to kanta@kanta.fi to arrange the initial meeting. 

At the meeting, the representatives of your organisation and experts from Kela and THL will discuss the following matters:

  • your organisation’s need for data and entitlement to the data (you have already reported these to THL) 
  • which forms (certificates, statements or notifications) or their specific data content are received by your organisation
  • the situation in the development of the required forms
  • the planned data forwarding process and the systems that will be used
  • setting a realistic target timetable for deployment.

Service deployment

Please send the following information to koodistopalvelu@thl.fi: 

  • the official name of the organisation 
  • the organisation’s business ID
  • whether the organisation will use the query service, the forwarding service or both
  • the date from which the service is planned to be deployed
  • The names in Finnish and Swedish of the data content to be transmitted via the query and forwarding service, and any abbreviations (e.g. Medical report on the need for special maternity leave SV 97). 

THL will add the information tothe Messaging – Message recipient code set in the National Code Service (koodistopalvelu.kanta.fi, in Finnish)(opens new window).

In order to enable the required connections to the Kanta Services, your organisation must first join the Suomi.fi Data Exchange Layer provided by the Digital and Population Data Services Agency (DVV).

Suomi.fi Data Exchange Layer (dvv.fi)(opens new window)

The organisation can then connect to the Kanta Services client test service, which is provided in the Kanta client test environment. The application to join as a user of the service is usually submitted by the information system provider. If you have a test environment, you can also join the Kanta Service’s client test service yourself, if necessary. 

For more information on the client test environment, please email kanta@kanta.fi and consult the client test service’s instructions for joining the service. 

Instructions for joining the Kanta client test service (pdf, in Finnish)(opens new window)Application to join the Patient Data Repository’s client test service (xls, in Finnish)(opens new window)

Once the connections are enabled, the information system provider will continue with system development to make it compatible with the Kanta Services.

To be able to use Kanta Services, an organisation must have an up-to-date and documented data security plan. THL has issued a regulation on the reports and requirements to be included in the data security plan (pdf, thl.fi, in Finnish)(opens new window). It is binding on social welfare and healthcare service providers and also serves as a guideline for organisations outside the healthcare sector.

You can use the data security plan template to help you develop a data security plan or to supplement your organisation’s existing data security plan for the deployment of the Kanta Services. 

If you have any questions about the content of the data security plan, contact THL by email: sotetiedonhallinta@thl.fi.

Data security plan template (docx, thl.fi, in Finnish)(opens new window)

The data security plan will be reviewed at the meeting approving the conditions for joining.

Before you start using the service, make sure that your organisation’s staff have the necessary skills to use the information system. To this end, it is a good idea to designate the main users of the future system and make a plan to ensure their competence. 

Agree on organisational policies internally and together with the information system provider. Examples of policies to be agreed upon include system access rights and access management. Through shared practices, you can ensure that data is processed securely within your organisation.

The meeting will examine whether the necessary preparations for deployment have been made. At this stage, the information system used by your organisation must also be approved. 

Representatives of your organisation, Kela and THL will attend the meeting to approve the conditions of joining. The information system provider may also participate in the meeting, if necessary. A Kela representative will take notes of the meeting and send them to all participants.

To arrange a meeting, send an email to kanta@kanta.fi.

Once compliance with the requirements for joining the service has been confirmed, Kela will send you the Technical details and contact persons for the query and forwarding service form and a commitment by which you agree to becoming a customer and accept:

After this, you can submit an application to become a service user by sending the following documents to kanta@kanta.fi:

  • a commitment you have signed to become a customer of the query and forwarding service
  • the completed Technical details and contact persons of the query and forwarding service form

Kela will notify you via email once your application has been approved. 

The deployment test involves entering the data for a specified test case at a predetermined time. This will ensure that the certificate or information content you need can be received by the information system you are using. 

Request deployment test instructions and a test case by emailing Kela at kanta@kanta.fi.

Agree on the schedule and procedures for the deployment test with the information system provider and, where appropriate, with the healthcare organisation. Kela will not participate in the deployment test.

Send a report on the deployment test to Kela

Send a report of a successfully completed deployment test to Kela at kanta@kanta.fi.

Kanta Services deployment test report (pdf, in Finnish)(opens new window)

After deployment

Once the service is up and running, review the action to be taken in the event of a fault and follow the maintenance and disruption notifications on kanta.fi.

If you have any problems using the service or there are changes in your organisation, please inform Kela by sending an email to kanta@kanta.fi. The most common changes that need to be reported to Kela are changes to contact persons or the system, a change in the name of the organisation and a change in the business ID.