Kysely- ja välityspalvelun määrittelyt

Kysely- ja välityspalvelun avulla viranomaiset ja muut terveydenhuollon ulkopuoliset organisaatiot voivat vastaanottaa terveydenhuollon todistuksia. Määrittelyissä kuvataan palvelua käyttäville järjestelmille asetettuja vaatimuksia.

Kantaan tallennettuja todistuksia ja lausuntoja voidaan välittää terveydenhuollon ulkopuolisille toimijoille Kysely- ja välityspalvelun avulla. Välitys edellyttää, että viranomaisella tai muulla toimijalla on lakiin perustuva oikeus saada tiedot käyttöönsä. Lue lisää Kysely- ja välityspalvelusta.

Todistukset, lausunnot tai niiden tietosisällöt, joita on mahdollista välittää terveydenhuollon ulkopuolelle, on kuvattu THL:n määräyksessä 2/2024 (pdf, thl.fi)(avautuu uuteen ikkunaan).

Tiedot Kysely- ja välityspalvelua käyttävistä organisaatioista ja niiden vastaanottamista sisällöistä päivitetään Viestinvälitys-Sanoman vastaanottaja -koodistoon (koodistopalvelu.kanta.fi)(avautuu uuteen ikkunaan).

Tutustu määrittelyihin

Taulukko: Kysely- ja välityspalvelun toiminnalliset määrittelyt. Päivitetty 2.12.2025.
Määrittelyn nimi ja versio Kuvaus Muutokset edelliseen versioon Voimassa sertifioinnissa Voimassa tuotantokäytössä

Kysely- ja välityspalvelu - toiminnallinen määrittely v 1.4 (pdf)(avautuu uuteen ikkunaan)

Kysely- ja välityspalvelu - toiminnallinen määrittely v 1.4 (Yhteistyötilat)(avautuu uuteen ikkunaan)

Versio 1.4, 2.12.2025

Versio tulee voimaan, kun palvelun tuotantokäyttö alkaa vuonna 2026.  Tarkennettu vaatimuksia ja tekstiä vastaamaan uudistuvaa Kysely- ja välityspalvelua. Tämä korvaa version 1.3. Ilmoitetaan myöhemmin. Ilmoitetaan myöhemmin.

Kysely ja välityspalvelu - toiminnallinen määrittely v. 1.3 (pdf)(avautuu uuteen ikkunaan)

Kysely- ja välityspalvelu -  toiminnallinen määrittely (Yhteistyötilat)(avautuu uuteen ikkunaan)

Versio 1.3, 22.3.2024

  Huomioitu 1.1.2024 voimaan tullut asiakastietolaki ja Kysely- ja välityspalvelun kehittämisen vaiheistus Ilmoitetaan myöhemmin. Ilmoitetaan myöhemmin.

Kysely- ja välityspalvelu - toiminnallinen määrittely versio 1.2 (Julkari.fi)

Versio 1.2, 2017

Voimassa siihen asti, kun nykyinen välitys Kelaan ja Traficomiin on käytössä.   Toistaiseksi v. 2017 alkaen. Toistaiseksi v. 2017 alkaen.

Potilastietojärjestelmien ja terveydenhuollon sovellusten rajapintoja koskevat tekniset määrittelyt.

Taulukko: Kysely- ja välityspalvelun tekniset määrittelyt. Päivitetty 25.11.2025
Määrittelyn nimi ja versio Kuvaus Muutokset edelliseen versioon Voimassa sertifioinnissa Voimassa tuotantokäytössä

Kysely- ja välityspalvelun potilastietojärjestelmien FHIR-rajapintojen soveltamisopas (simplifier.net)(avautuu uuteen ikkunaan)

Versio 1.0.0-RC2, 25.11.2025

Implementointiopas välityspyynnön ja välitysperusteiden toimittamiseksi Kysely- ja välityspalvelulle. 

Julkaistu implementointiopas RC-statuksella. Versio vastaa asiakastestiympäristöön asennettavaa pakettia, sitä ei tueta vielä tuotantoympäristössä.

Tarkennuksia määrittelyihin Ilmoitetaan myöhemmin Ilmoitetaan myöhemmin

Kysely- ja välityspalvelun potilastietojärjestelmien FHIR-rajapintojen soveltamisopas (simplifier.net)(avautuu uuteen ikkunaan)

Versio 1.0.0-RC1, 21.7.2025

Implementointiopas välityspyynnön ja välitysperusteiden toimittamiseksi Kysely- ja välityspalvelulle. 

Julkaistu implementointiopas RC-statuksella. Versio vastaa asiakastestiympäristöön asennettavaa pakettia, sitä ei tueta vielä tuotantoympäristössä.

Ei aiempaa versiota. Ilmoitetaan myöhemmin. Ilmoitetaan myöhemmin.


 

Kysely- ja välityspalvelun yleiskuvauksessa kuvataan palvelun toimintaa, periaatteita ja tulevia kehitysmahdollisuuksia ja niiden rajauksia. 

Taulukko: Kysely- ja välityspalvelun yleiskuvaus. Päivitetty 3.11.2025
Määrittelyn nimi ja versio Muutokset edelliseen versioon Voimassa sertifioinnissa Voimassa tuotantokäytössä

Kysely- ja välityspalvelun yleiskuvaus 1.0 (yhteistyötilat.fi)(avautuu uuteen ikkunaan)

Versio 1.0, 3.11.2025

Uusi kommentoitava versio Ilmoitetaan myöhemmin Ilmoitetaan myöhemmin

 

Määrittelyjen voimassaolo
  • ”Voimassa sertifioinnissa” kertoo, millä aikavälillä järjestelmän yhteistestaus, tietoturvallisuuden arviointi tai vaatimustenmukaisuuden uusiminen tehdään kyseisen version mukaisesti.

  • ”Voimassa tuotantokäytössä” kertoo, millä aikavälillä tuotannossa olevat järjestelmät saavat toimia kyseisen version mukaisesti.

  • Lisätietoja voimassaoloajoista (thl.fi)(avautuu uuteen ikkunaan)

Lue lisää

Sivua päivitetty 3.12.2025