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 (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) 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. |
|
|
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.
| Määrittelyn nimi ja versio | Kuvaus | Muutokset edelliseen versioon | Voimassa sertifioinnissa | Voimassa tuotantokäytössä |
|---|---|---|---|---|
|
Versio 1.0.0, 11.9.2026 |
Implementointiopas välityspyynnön ja välitysperusteiden toimittamiseksi Kysely- ja välityspalvelulle. Tuotantoversio aiempien RC-versioiden sijaan. |
Ei varsinaisia muutoksia | 16.9.2026 lähtien toistaiseksi | 16.9.2026 lähtien toistaiseksi |
|
Versio 1.0.0-rc5, 18.6.2026 |
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ä. |
Tarkennukset välityksen tilan kyselyyn ja välityksen tilan kuvauksiin profiilien kuvaussivulla, sekä käyttötapauksessa. |
18.6.2026-15.9.2026 | Ei voimassa |
|
Versio 1.0.0-rc4 |
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ä. |
Tarkennus sallittujen välitysperusteiden käyttöön välityspyynnön tekemisen käyttötapauksessa. | Ei voimassa | Ei voimassa |
|
Versio 1.0.0-rc3, 18.12.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ä. |
Dokumentaatiota täydennetty sekä implementointioppaissa, että profiilien kuvauksissa. | Ei voimassa | Ei voimassa |
|
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 | Ei voimassa | Ei voimassa |
|
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. | Ei voimassa | Ei voimassa |
Sosiaali- ja terveydenhuollon ulkopuolisten Kysely- ja välityspalvelun kautta tietoja vastaanottavien sovellusten rajapintoja koskevat tekniset määrittelyt.
| Määrittelyn nimi ja versio | Kuvaus | Muutokset edelliseen versioon | Voimassa sertifioinnissa | Voimassa tuotantokäytössä |
|---|---|---|---|---|
|
Versio 1.0.0, 11.9.2026 |
Implementointiopas asiakirjojen hakuun liittyville rajapinnoille. Tuotantoversio teknisistä määrittelyistä sote-ulkoisille vastaanottajille. |
Ei varsinaisia muutoksia, tuotantoversion julkaisu. | 16.9.2026 lähtien toistaiseksi | 16.9.2026 lähtien toistaiseksi |
|
Versio 1.0.0-rc2, 18.6.2026 |
Implementointiopas asiakirjojen hakuun liittyville rajapinnoille. Julkaistu implementointiopas RC-statuksella. Versio vastaa asiakastestiympäristöön asennettavaa pakettia, sitä ei tueta vielä tuotantoympäristössä. |
Organisaatiolle osoitettujen asiakirjojen haun reload- ja organization-parametrien tarkennus. | 18.6.2026-15.9.2026 | Ei voimassa |
|
Versio 1.0.0-RC1, 18.12.2025 |
Implementointiopas asiakirjojen hakuun liittyville rajapinnoille. Julkaistu implementointiopas RC-statuksella. Versio vastaa asiakastestiympäristöön asennettavaa pakettia, sitä ei tueta vielä tuotantoympäristössä. |
Ei aiempaa versiota. | Ei voimassa | Ei voimassa |
Kysely- ja välityspalvelun yleiskuvauksessa kuvataan palvelun toimintaa, periaatteita ja tulevia kehitysmahdollisuuksia ja niiden rajauksia.
| Määrittelyn nimi ja versio | Muutokset edelliseen versioon | Voimassa sertifioinnissa | Voimassa tuotantokäytössä |
|
Kysely- ja välityspalvelun yleiskuvaus v1.1 (yhteistyötilat.fi)(avautuu uuteen ikkunaan) Versio 1.1, 30.3.2026 |
Kommenttien pohjalta päivitetty versio | - | - |
|
Kysely- ja välityspalvelun yleiskuvaus 1.0 (yhteistyötilat.fi)(avautuu uuteen ikkunaan) Versio 1.0, 3.11.2025 |
Uusi kommentoitava versio | - | - |
-
”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)