Sote-tietojärjestelmäpalvelujen määrittelyt

Tällä sivulla

Kenelle ohje on tarkoitettu?

Sosiaali- ja terveydenhuollon tiedonhallinnan kansalliset tietojärjestelmäpalvelujen määrittelyt on tarkoitettu sote-tietojärjestelmien ja digitaalisten palvelujen kehittäjille ja niitä hankkiville sote-toimijoille.

Määrittelyjen noudattaminen tietojärjestelmä- ja sovellustoteutuksissa on velvoittavaa, kun järjestelmät on tarkoitus liittää Kanta-palveluihin. Lupa- ja valvontavirasto valvoo määritysten mukaisuutta.

Kansallinen ohjaus ja määrittelyt tuotetaan yhteistyössä

THL vastaa sosiaali- ja terveydenhuollon tiedonhallinnan kansallisesta ohjauksesta yhdessä STM:n ja Kelan kanssa. THL laatii tietosisältömääritykset, asiakirjarakenteet, luokitukset, koodistot ja sanastot, jotta tiedot ovat yhteentoimivia eri järjestelmissä. Kelan kanssa yhteistyössä laaditaan järjestelmien toiminnallisuuksiin ja tietoturvaan liittyvät määrittelyt.

THL keskittyy sisältö- ja rakenteellisiin määrittelyihin, kun taas Kela huolehtii teknisestä toteutuksesta ja palvelujen käytännön toimivuudesta Kanta-palveluissa. Molemmat toimijat edistävät yhteentoimivuutta ja standardointia.

Tällä sivulla listataan THL:n julkaisemat sote-tietojärjestelmiin liittyvät yleiskuvaukset ja toiminnalliset määrittelyt sekä niiden voimassaolotiedot. THL julkaisee lisäksi valtakunnalliset tietosisältömääritykset Termeta- ja Sosmeta-palvelussa sekä koodistopalvelimella.

Lisäksi Kela julkaisee Kanta-palveluihin liittyvät toiminnalliset ja tekniset määrittelyt.
Kanta-palvelujen vaatimusmäärittelyt, tietosisällöt ja tekniset ohjeet tietojärjestelmätoimittajille (Kanta)

Terveys- ja hoitosuunnitelman toiminnalliset määrittelyt

Terveys- ja hoitosuunnitelman toiminnallisten vaatimusten määrittelyt ovat osa keskeisten terveystietojen määrittelyjen kokonaisuutta.

Alla olevassa määrittelyn voimassaolotietotaulukossa:

  • "Voimassa sertifioinnissa" kertoo, millä aikavälillä järjestelmän yhteistestaus tai tietoturvallisuuden arviointi 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

Voimassaolotietotaulukko. Taulukon tiedot päivitetty 24.6.2024.
Määrityksen otsikko ja versio Voimassa tuotantokäytössä Voimassa sertifioinnissa
Terveys- ja hoitosuunnitelman toiminnalliset vaatimukset versio 1.2 (2018) (Julkari) 05/2018– 05/2018–
Rakenteinen terveys- ja hoitosuunnitelma (2011) (Julkari) ei voimassa ei voimassa

Lisätietoja terveys- ja hoitosuunnitelman käytöstä ja muista aiheeseen liittyvistä määrittelyistä on THL:n julkaisemissa kirjaamisoppaissa, tiedonhallintapalvelun määrittelyissä.
Lisäksi katso myös: Terveys- ja hoitosuunnitelma (Kanta)

Seuraavat määrittelyt on tarkoitettu sekä sosiaali- että terveydenhuollon käyttöön.

Sosiaali- ja terveydenhuollon ajanvarauksen määrittelyt

Sosiaali- ja terveydenhuollon ajanvarauksen kansalliset määrittelyt on tarkoitettu sote-tietojärjestelmien ja digitaalisten asiointipalvelujen kehittäjille ja niitä hankkiville sote-toimijoille. Määrittelyjen ensimmäinen painopiste on terveydenhuollon ajanvaraustiedot ja niiden Kanta-palveluihin liitettävyys. Määrittelyt otetaan käyttöön sosiaali- ja terveyspalvelujen ajanvaraustietoja käsittelevissä järjestelmissä ja asiointipalveluissa.

Sote-ajanvarauksen kansalliset määrittelyt sisältävät käsitemäärittelyt, yleiskuvauksen ja linjaukset, arkkitehtuurikuvaukset sekä vaatimus- ja rajapintamäärittelyt.

Terveydenhuollon ajanvaraustietojen toimittaminen on toteutettu Kanta-palveluihin vuosina 2024 - 2025. Terveydenhuollon asiakkaille ilmoitettavien ajanvarausten tiedot on toimitettava Kanta Potilastietovarantoon viimeistään lokakuussa 2026. Ajanvaraustiedot tulevat jatkossa myös asiakkaiden näkyviin OmaKanta-palvelussa, josta on mahdollista siirtyä perumaan tai siirtämään aikoja palveluntuottajien alueellisiin tai paikallisiin ajanvarauspalveluihin.

Suuri osa kansallisista määrittelyistä ja koodistoista on tuotettu sekä sosiaali- että terveyspalvelujen tarpeet huomioiden. Sosiaalihuollon ajanvaraustietojen Kanta-palveluihin toimittamisen aikataulua ei ole säädetty kansallisesti.

Määrittelyjen pohjana ovat olleet aiempina vuosina tuotetut kansalliset määrittelyt, joita on päivitetty Suomen kestävän kasvun ohjelman (RRP) ja Kanta-yhteistyön kautta.

Ajanvarausmäärittelyjen hyödyntäminen

Ajanvarausten toteuttaminen sote-tietojärjestelmiin ja asiointipalveluihin helpottaa asiakkaan asiointia sosiaali- ja terveyspalveluissa ja vähentää riippuvuutta palveluajoista. Lisäksi se helpottaa puolesta-asiointia ja auttaa sitoutumaan palveluihin.

Ajanvarausten toteuttaminen tukee myös ammattilaisten tietotarpeita: päällekkäinen työ ja erillisten järjestelmien käyttö vähenee. Ammattilaisen on helpompi saada kokonaiskuva asiakkaan tilanteesta.

Kansallisten määrittelyjen avulla palvelujen tuottajien ja järjestäjien on mahdollista toteuttaa ajanvarauksen asiointi- ja palveluprosessit valtakunnallisesti yhteentoimivalla tavalla ja varmistaa ajanvaraustietojen saatavuus asiakkaille sekä tietoja tarvitseville ammattilaisille. Myös tietojen pitkäaikaissäilytyksen ja erillisten integraatioiden tarve vähenevät paikallisesti.

Ajanvarauksen kansalliset määrittelyt sisältävät useita osakokonaisuuksia, joita kuvataan alla tarkemmin.

Yleiskuvaus ja vaatimukset sekä käsitemäärittelyt

Sote-ajanvarausratkaisujen käsitemäärittelyjen pohjana toimii dokumentti "Sosiaali- ja terveydenhuollon ajanvarauspalvelujen ja palveluohjauksen käsitteet".

"Sote-ajanvaraus: yleiskuvaus ja terveydenhuollon ajanvarausratkaisujen kansalliset vaatimukset" -määrittely sisältää ajanvarausratkaisujen kansalliset linjaukset sekä tavoitetila- ja arkkitehtuurikuvauksen. Lisäksi siinä määritellään eri tietojärjestelmäpalvelujen keskeisimmät vaatimukset yhteentoimivuuden näkökulmasta sekä terveydenhuollon ajanvaraustietojen täsmennetyt vaatimukset, kun hyödynnetään Kanta-palveluja.

Linkit voimassa oleviin versioihin käsitemäärittelystä ja yleiskuvaus ja vaatimukset-määrittelystä löytyvät taulukosta:
Ajanvarauksen määritysten voimassaolotiedot

Koodistot ja tietorakenteet

Ajanvarausratkaisujen toteutuksissa hyödynnetään kansallisesti määriteltyjä tietorakenteita ja luokituksia.

Keskeisin tietosisältömäärittely on Termeta-palvelussa julkaistu Ajanvarausasiakirjan tietosisältömäärittely terveydenhuoltoon. Asiakirjassa hyödynnetään useita tarkempia tietokomponentteja, joilla kuvataan asiakkaan, ajanvarauksen, palvelupisteen ja annettavan palvelun tietoja sekä asiointiin liittyviä lisätietoja. Termeta-palvelussa julkaistu tietosisältömäärittely on korvannut aiemman Koodistopalvelimella julkaistun tietosisällön Ajanvaraus/Tietosisältö - Ajanvarausasiakirja.
Ajanvarausasiakirjan tietosisältömäärittely Termeta-palvelussa

Ajanvarausratkaisujen toteutuksissa hyödynnetään kansallisesti määriteltyjä koodistoja, joista keskeisimpiä ovat koodistopalvelusta saatavat:

Lisäksi ajanvaraustiedoissa hyödynnetään muita koodistoja, jotka eivät ole asiointi- tai ajanvarausspesifejä.

Rajapintojen määrittelyt

Ajanvaraustietojen liittämisessä Kanta-palveluihin hyödynnetään HL7 FHIR -standardia. Terveydenhuollon ajanvarausasiakirjan Kanta-määrittelyistä on julkaistu FHIR-implementointiopas. Implementointiopas on korvannut aiemman CDA-määrittelyn.

Myös muita ajanvarauksiin liittyviä rajapintamäärittelyjä on hyödynnettävissä. HL7 Finland on julkaissut ajanvarausrajapintojen määrittelyjä mm. vapaiden aikojen kyselyihin ja aikojen varaamisen toimenpiteisiin, jotka ovat hyödynnettävissä esimerkiksi asiointipalvelujen ja perusjärjestelmien integraatioissa sekä asiakkaalle tarkoitettujen digipalvelujen välisissä linkityksissä.

Ajanvarauksen määritysten voimassaolotiedot

Alla olevissa määrittelyn voimassaolotietotaulukoissa:

  • "Voimassa sertifioinnissa" kertoo, millä aikavälillä järjestelmän yhteistestaus tai tietoturvallisuuden arviointi 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

Sote-ajanvaraus: yleiskuvaus ja terveydenhuollon ajanvarausratkaisujen kansalliset vaatimukset. Taulukon tiedot päivitetty 2.12.2025.
Määrityksen otsikko ja versio Voimassa sertifioinnissa Voimassa tuotantokäytössä
Sote-ajanvaraus: yleiskuvaus ja terveydenhuollon ajanvarausratkaisujen kansalliset vaatimukset versio 2.2 (Yhteistyötilat) 2.12.2025- 2.12.2025-
Sote-ajanvaraus: yleiskuvaus ja terveydenhuollon ajanvarausratkaisujen kansalliset vaatimukset versio 2.1 (Julkari) ei voimassa ei voimassa
Sote-ajanvaraus: yleiskuvaus ja terveydenhuollon ajanvarausratkaisujen kansalliset vaatimukset versio 1.0 (Julkari) ei voimassa ei voimassa

Rajapintojen määrittelyt

Ajanvarauksen Kanta-rajapintoja ei toteuteta HL7 CDA R2 standardin kautta. Kanta-rajapintojen toteutus nojautuu HL7 FHIR-standardiin, ja rajapintojen toteuttamiseen on valmisteilla FHIR-soveltamisopas, joka löytyy Kelan simplifier-sivustolta. Kanta-rajapintatoteutus perustuu Termeta-palvelussa julkaistuihin ajanvarausasiakirjan ja sen tietokomponenttien määrittelyihin.
Asiakirjarakenteet Termeta-palvelussa

Ajanvarausasiakirjan Kanta-rajapinnat. Taulukon tiedot päivitetty 26.6.2024.
Määrityksen otsikko ja versio Voimassa sertifioinnissa Voimassa tuotantokäytössä
Kanta potilastietovarannon ajanvarauksen implementointiopas (simplifier.net) ei voimassa, valmisteilla oleva kehitysversio ei voimassa, valmisteilla oleva kehitysversio
Ajanvarausasiakirjan HL7 CDA R2 soveltamisopas, versio 1.00 (2020): ajanvarausasiakirjan HL7 CDA-soveltamisopas Kanta Potilastiedon arkistoon liittyville järjestelmille (hl7.fi) ei voimassa ei voimassa

Seuraavat rajapintamäärittelyt ovat saatavilla ja hyödynnettävissä, mutta ne eivät ole osa järjestelmien sertifiointia eikä niiden käyttöä kansallisesti edellytetä tuotantokäytössä:

HL7 Finland ry on määritellyt ja ylläpitää ajanvarausrajapintojen FHIR-määrittelyjä resurssienhallintarajapintoihin, kuten vapaiden aikojen hakeminen ja aikojen varaaminen. HL7 Finland määrittelyjä löytyy HL7 Finland sivujen kautta.

Käytönhallinta, luovutustenhallinta ja lokitiedot

Asiakastietojen käyttöä hallitaan useilla eri toimenpiteillä. Käytönhallinta sisältää esimerkiksi ammattihenkilöiden todentamisen, käyttöoikeuksien hallinnan, asiayhteyden todentamisen sekä asiakastietojen käytön seurannan käyttölokien avulla. Käytönhallinnan kokonaisuutta kuvataan tarkemmin sosiaalihuollon tiedonhallinnan sivuilla. Myös asiakastietojen luovuttamista eri rekisterinpitäjien ja rekisterien välillä ohjataan kansallisilla määrittelyillä ja seurataan Kanta-luovutuslokien avulla.

Tälle sivulle on koottu sote-tietojen käytönhallinnan ja luovutustenhallinnan eri osa-alueisiin liittyviä kansallisia määrittelyjä, materiaaleja ja niiden voimassaolotietoja. THL:n julkaisemista määrittelyistä ilmaistaan myös määritysten eri versiot ja niiden voimassaolotiedot.

Ammattihenkilöiden tunnistaminen ja todentaminen

Käyttöoikeuksien hallinta ja tarkistaminen

Asiayhteys ja hoitosuhde

Luovutustenhallinta

Lokitietojen hallinnan määrittelyt

Lokitietojen hallinnan vaatimuksia on toteutettu sähköisen reseptin, potilastietovarannon ja sosiaalihuollon asiakastietovarannon aikaisempien määrittelyjen mukaisesti. Aiemmat erilliset määrittelyt ja toteutukset ovat korvautumassa alla näkyvällä määrittelyllä.

Alla olevassa määrittelyn voimassaolotietotaulukossa:

  • "Voimassa sertifioinnissa" kertoo, millä aikavälillä järjestelmän yhteistestaus tai tietoturvallisuuden arviointi 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

Voimassaolotaulukko. Taulukon tiedot päivitetty 25.6.2024.
Määrittelyn otsikko ja versio Voimassa sertifioinnissa Voimassa tuotantokäytössä
Asiakas- ja potilastietojen käsittelyssä syntyvien lokitietojen hallinnan kansalliset vaatimusmäärittelyt v 1.2 (Yhteistyötilat) 04/2023–* 04/2023–*
Asiakas- ja potilastietojen käsittelyssä syntyvien lokitietojen hallinnan kansalliset vaatimukset (Release candidate) 1.1 (Yhteistyötilat) ei voimassa ei voimassa

* Määrittely korvaa lokimerkintöihin ja lokitietojen hallintaan liittyvät vaatimukset seuraavissa aiemmissa määrittelydokumenteissa:

  • Potilastiedon arkiston toiminnalliset vaatimukset sosiaali- ja terveydenhuollon tietojärjestelmille, lokimerkintöihin liittyvät luvut ja liite
  • Vaatimukset asiakastietoa käsitteleville tietojärjestelmille (sosiaalihuolto), vaatimukset käyttölokille ja luovutusilmoituksille
  • Resepti-palvelun toiminnalliset- ja rajapintamäärittelyt, Tietosisällöt -määrityksen "Käyttölokin tietosisältö"

Myös aiemmat määrittelyt ovat voimassa tuotantokäytössä siirtymäaikana.

Katso myös Asiakas- ja potilastietojen käsittelyssä syntyvien lokitietojen hallinnan kansalliset vaatimusmäärittelyt (Kanta)

Voimaantuloajat ja THL määräyksen 5/2024 mukaiset olennaiset vaatimukset

Lokivaatimukset ja niiden voimaantuloajat sisältyvät THL:n määräyksen 5/2024 olennaisiin vaatimuksiin (kuten vaatimus TLOK01). Eri käyttötarkoituksiin suunnitelluissa tietojärjestelmissä kansallisia lokivaatimuksia tulee toteuttaa ja ottaa käyttöön viimeistään seuraavalla aikataululla:

  • 1.1.2027:
    • lääkemääräyksiä tuottavat tietojärjestelmät, ja apteekkijärjestelmät (profiilit 3a1-3a2)
    • potilaskertomusjärjestelmät, suun terveydenhuollon sekä optisen toimialan järjestelmät (profiilit 3c1-3c3)
    • sosiaalihuollon kansallisten vaatimusprofiilien mukaiset järjestelmät (profiilit 3d1-3d4)
    • kuvantamiseen liittyvä potilashallinnon perusjärjestelmä (HIS) (profiili 3e3)
  • 1.1.2029:
    • kuvantamisen toiminnanohjausjärjestelmät (RIS) (profiilit 3e4 ja 3e5)  ja soveltuvin osin kuvien tallennus- ja jakamisjärjestelmät (PACS) ja kuvantamisen katselinohjelmistot (profiilit 3e6-3e7).
    • palvelunantajien digitaaliset asiointipalvelut ja omatietovarannosta hyvinvointitietoja käyttävät ammattilaisten tietojärjestelmät (profiilit 3h1 ja 3h5)
    • Asiakastietovarantoon todistuksia ja lausuntoja tuottava järjestelmä (profiili 3f3)
    • muut kuin yllä mainitut Kanta-tietovarannoista tietoja hakevat tai niihin tietoja tuottavat järjestelmät (profiilit 3b1-3b4)
  • 1.1.2030:
    • muut asiakas- ja potilastietojen käsittelyyn tarkoitetut tietojärjestelmät (profiili 3g1).

Toimintakykytieton hyödyntämiseen liittyvät määrittelyt

Määrittelyt, jotka liittyvät sote-yhteisten toimintakykyä kuvaavien tietorakenteiden (toimintakykymerkintä ja toimintakykyarvio) toteutuksiin. Dokumentaatio täydentyy vuoden 2025 aikana kun tietorakenteiden FHIR- pohjainen toteutus mahdollistuu.

Alla olevassa määrittelyn voimassaolotietotaulukossa:

  • "Voimassa sertifioinnissa" kertoo, millä aikavälillä järjestelmän yhteistestaus tai tietoturvallisuuden arviointi 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

Voimassaolotaulukko. Taulukon tiedot päivitetty 16.4.2024.
Määrityksen otsikko ja versio Voimassa sertifioinnissa Voimassa tuotantokäytössä
Toimintakykytiedon hyödyntämisen toiminnallinen määrittely: vaatimukset (Julkari) Ei voimassa Ei voimassa *
Toimintakykytiedon hyödyntämisen toiminnallinen määrittely: yleiskuvaus (Julkari) Ei voimassa Ei voimassa *

* Dokumenttia on hyödynnetty joidenkin asiakastietojärjestelmien omissa toteutuksissa. Kanta-toteutukset perustuvat potilastietovarannon ja sosiaalihuollon asiakastietovarannon yleisiin määrityksiin ja erikseen julkaistaviin rajapintojen soveltamisoppaisiin.

Sote-koodistojen hyödyntämisen perusvaatimukset

Sote-koodistojen hyödyntämisen perusvaatimukset -määrittely kokoaa ja yhtenäistää kansallisten koodistojen hyödyntämisen vaatimuksia sosiaali- ja terveydenhuollon tietojärjestelmissä. Uusi kokoava määrittely on hyödyllinen kaikille sosiaali- ja terveydenhuollon tietojärjestelmiä kehittäville ja kansallisia koodistoja hyödyntäville tietojärjestelmille.

Koodistojen yhtenäinen käyttö ja hyödyntäminen ovat tietojen yhdenmukaisuuden, vertailtavuuden, jatkokäyttömahdollisuuksien sekä tiedon laadun keskeinen edellytys. Monet tietojen tuottamisen ja hyödyntämisen koodistovaatimukset ovat yhteisiä eri koodistoille ja niiden käyttökohteille.

Sosiaali- ja terveydenhuollon tietojärjestelmien yhteiset perusvaatimukset on täsmennetty Sote-koodistojen hyödyntämisen perusvaatimukset -määrittelyyn. Koodistojen käsittelyn perusvaatimuksia sovelletaan erityisesti kaikissa Kanta-palveluihin liittyvissä järjestelmissä.

Vaatimukset ovat myös todennettavissa esimerkiksi järjestelmien sertifioinnissa ja olennaisissa vaatimuksissa. Tarkemmissa käyttökohteissa ja määrittelyissä on lisäksi koodisto- tai sisältökohtaisia vaatimuksia. Vaatimuksista saa tukea myös koodistoja käyttävien järjestelmien käytettävyyden parantamisessa, jotta esimerkiksi tietojen kirjaaminen on laadukkaampaa.

Perusvaatimukset yhtenäistävät kansallisten koodistojen hyödyntämisen vaatimukset tietoja tuottaville ja käyttäville sote-tietojärjestelmille. Vaatimuksia on aiemmin eri sosiaali- ja terveydenhuollon määrittelyssä ja THL:n määräyksissä.

Alla olevassa määrittelyn voimassaolotietotaulukossa:

  • "Voimassa sertifioinnissa" kertoo, millä aikavälillä järjestelmän yhteistestaus tai tietoturvallisuuden arviointi tehdään kyseisen määrittelyversion mukaisesti.
  • "Voimassa tuotantokäytössä" kertoo, millä aikavälillä tuotannossa olevat järjestelmät saavat toimia kyseisen version mukaisesti.

Lisätietoja voimassaoloajoista

Voimassaolotaulukko. Taulukon tiedot päivitetty 21.2.2025.
Määrittelyn otsikko ja versio Voimassa sertifioinnissa Voimassa tuotantokäytössä
Sote-koodistojen hyödyntämisen perusvaatimukset
(Yhteistyötilat)		 1.5.2025– 1.5.2025–

Lisätietoja: määrittelyn mukaiset perusvaatimukset on toteutettava tuotantokäytössä toimiviin tietojärjestelmiin viimeistään THL:n olennaisten vaatimusten määräyksessä ilmaistuihin määräaikoihin mennessä. Määräajat eri tyyppisille järjestelmille kuvataan THL:n olennaisten vaatimusten määräysten profiileissa (määräys 4/2024 liitteet 3). Osa dokumentin vaatimuksista liittyy Kanta-palveluihin liittyvien järjestelmien yhteistestaukseen. Yhteistestauksessa läpikäytävät yksityiskohtaiset vaatimukset perustuvat pääosin tarkempiin sisältö- ja palvelukohtaisiin määrittelyihin, joita päivitetään erikseen.

THL:n rooli

THL määrittelee kansalliset sote-asiakastietojen tietorakenteet ja koodistot, joita järjestelmätoimittajien on noudatettava. THL ja Kela julkaisevat määrittelyt järjestelmien toiminnallisuudesta, tietosisällöstä ja vaatimuksista. Määrittelyt ovat velvoittavia lain ja THL:n antamien määräysten kautta. Vaatimusten avulla varmistetaan, että järjestelmät tukevat turvallista tiedonhallintaa ja Kanta-palvelujen käyttöä.

Yhteystiedot

Sote-tiedonhallinta

sotetiedonhallinta(at)thl.fi