Asiakastietoa käsitteleviä järjestelmiä koskevat toiminnalliset vaatimukset

Tälle sivulle on koottu Sosiaalihuollon asiakastietovarannon käyttöön liittyvät määrittelyt sekä asiakastietoa käsitteleviä järjestelmiä koskevat vaatimukset.

Yleiskuvan sosiaalihuollon tiedonhallinnan toiminnallisuudesta sekä toiminnallisuuden toteuttamiseksi ja käyttöönottamiseksi tarvittavista tietojärjestelmäratkaisuista saa tutustumalla verkkojulkaisuun Kanta-palvelujen käsikirja sosiaalihuollon toimijoille(avautuu uuteen ikkunaan).

Lisäksi asiakastietoa käsitteleviä järjestelmiä koskevia toiminnallisia vaatimuksia löytyy sivulta Kanta-palvelujen Yhteiset määrittelyt(avautuu uuteen ikkunaan).

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)

Tiedonhallinnan tukiprosessit

Tiedonhallinnan tukiprosessit kuvaa ammattihenkilöiden, asiakastietoja käsittelevien järjestelmien ja Kanta-palveluiden välistä työnjakkoa sekä viestinvälitystä asiakastietojen käsittelyssä.

Taulukko: Tiedonhallinnan tukiprosessit. Päivitetty 25.3.2026.

Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Tiedonhallinnan tukiprosessit, versio 4.6 (pdf)

Lisätty prosessi "Hae sosiaalihuollon asiakastietoja sosiaalihuoltoon" sekä poistettu vanhentunut prosessien yleiskuva. Hyväksytty THL 25.3.2026

Toistaiseksi 25.3.2026 alkaen Toistaiseksi 25.3.2026 alkaen
Taulukko: Tiedonhallinnan tukiprosessit, aikaisemmat versiot
Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Tiedonhallinnan tukiprosessit, versio 4.5 (pdf)

Korvattu termi "Sosiaalihuollon asiakastiedon arkisto" termillä Sosiaalihuollon asiakastietovaranto. Hyväksytty THL 10.12.2024

Toistaiseksi 1.9.2026 saakka Toistaiseksi 1.9.2026 saakka
Tiedonhallinnan tukiprosessit, versio 4.4 (pdf)  Päivitetty prosessiin 3.15 palvelunantajan ja viranomaisen laaja tiedonsaantioikeus. Hyväksytty THL 26.3.2024 Toistaiseksi 1.9.2026 saakka Toistaiseksi 1.9.2026 saakka

 

Vaatimukset asiakastietoja käsitteleville järjestelmille

Määrittelyssä kuvataan Kanta-palveluihin liittyvälle sosiaalihuollon asiakastietoa käsittelevälle järjestelmälle asetetut toiminnalliset vaatimukset.

Taulukko: Vaatimukset asiakastietoja käsitteleville järjestelmille. Päivitetty 25.3.2026

Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Vaatimukset asiakastietoja käsitteleville järjestelmille, versio 6.5 (xlsx)(avautuu uuteen ikkunaan) Versioon 6.5 on lisätty asiakastietoja terveydenhuoltoon hakevien järjestelmien vaatimukset. Hyväksytty THL 25.3.2026 Toistaiseksi 25.3.2026 alkaen Toistaiseksi 25.3. 2026 alkaen
Taulukko: Vaatimukset asiakastietoja käsitteleville järjestelmille, aikaisemmat versiot
Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Vaatimukset asiakastietoja käsitteleville järjestelmille, versio 6.4 (xlsx)(avautuu uuteen ikkunaan) Versioon 6.4 on tehty tarkennuksia ja selkeytetty vaatimusten tai lisätietojen sisältöä (vaatimukset AsiaY19, HaAsk01, AkrSi28 ja ArY48). Hyväksytty THL 9.12.2025.
 
Toistaiseksi 1.9.2026 saakka. Toistaiseksi 1.9.2026 saakka.
Vaatimukset asiakastietoja käsitteleville järjestelmille, versio 6.3 (xlsx)(avautuu uuteen ikkunaan) Versioon 6.3 on lisätty FHIR-muotoisten asiakastietojen käsittelyä ja mitätöintiä koskevat vaatimukset YMi07, ArMi10, ArMi11, PaY10, KeY10 ja AkrSi34. Lisäksi vaatimuksen AsiaY19 lisätietoa on korjattu koskemaan kaikkien asioiden käsittelyä. Hyväksytty THL 26.9.2025. Toistaiseksi 1.9.2026 saakka. Toistaiseksi 1.9.2026 saakka
Vaatimukset asiakastietoja käsitteleville järjestelmille, versio 6.2 (xlsx) Versioon 6.2 on päivitetty allekirjoitustietoja koskeva vaatimus YAl18 vastaamaan nykyistä toteutusta. Lisäksi eräiden vaatimusten (esim. YY05, YY16) tekstiä on selkeytetty ja tarkennettu. Hyväksytty THL 13.6.2025. Toistaiseksi 1.9.2026 saakka. Toistaiseksi 1.9.2026 saakka.
Vaatimukset asiakastietoja käsitteleville järjestelmille, versio 6.1 (xlsx) Versioon 6.1 on tarkennettu vaatimuksia asiakirjan näyttömuodon kenttien nimien ja otsikoiden näyttämisen pakollisuudesta. Hyväksytty THL 27.3.2025. Toistaiseksi 1.9.2026 saakka. Toistaiseksi 1.9.2026 saakka.
Vaatimukset asiakastietoja käsitteleville järjestelmille, versio 6.0 (xlsx) Versio 6.0 sisältää laajennuksen asiakirjan ylä- ja alatunnisteessa sallittuun tietosisältöön. Hyväksytty THL 12.12.2024. Toistaiseksi 1.9.2026 saakka. Toistaiseksi 1.9.2026 saakka.
Vaatimukset asiakastietoja käsitteleville järjestelmille, versio 5.9 (xlsx) Versiossa 5.9 tarkennettu asiakirjan viivästämiseen liittyviä vaatimuksia (PaY08,PaY09),  Hyväksytty THL 30.9.2024. Toistaiseksi 1.9.2026 saakka. Toistaiseksi 1.9.2026 saakka.
Vaatimukset asiakastietoja käsitteleville järjestelmille, versio 5.8 (xlsx)

Versioon 5.8 on täydennetty käyttövaltuushallintaan (KäLu04-04, KäLu08-09 sekä asiakirjan näyttömuotoon liittyviä vaatimuksia (AkrSi21 ja AkrSi32). Hyväksytty THL 26.3.2024

Toistaiseksi 1.9.2026 saakka. Toistaiseksi 1.9.2026 saakka.

 

Sosiaalihuollon asiakastietovarannon ja asiakastietojärjestelmän väliset rajapintakäyttötapaukset

Rajapintakäyttötapaukset -määrittely kuvaa asiakastietoa käsittelevän järjestelmän ja Sosiaalihuollon asiakastietovarannon väliset rajapintakäyttötapaukset tallennukseen ja hakuun.

Taulukko: Rajapintakäyttötapaukset. Päivitetty 25.3.2026

Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Rajapintakäyttötapaukset, versio 3.8 RC2 (pdf) RC-Versioon 3.8 RC2 on lisätty Sosiaalihuollon asiakastietovarannon terveydenhuollon haut sekä FHIR-toimintakykytietojen liiteasiakirjan käsittelyn työnkulut. Julkaisupäivä 25.3.2026 RC-versio RC-versio
Rajapintakäyttötapaukset, versio 3.6 (pdf) Versio 3.6 sisältää laajan tiedonsaantioikeuden sekä viranomaisen laajan tiedonsaantioikeuden rajapintakäyttötapaukset. Julkaisupäivä 2.4.2025. Toistaiseksi 2.4.2025 alkaen Toistaiseksi 2.4.2025 alkaen
Taulukko: Rajapintakäyttötapaukset, aikaisemmat versiot
Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Rajapintakäyttötapaukset, versio 3.5 (pdf) Versioon 3.5 on lisätty laajan rekisterinkäyttöoikeuden rajapintakäyttötapaukset. Julkaisupäivä 4.1.2023  Toistaiseksi 1.9.2026 saakka. Toistaiseksi 1.9.2026 saakka.

 

Asiakas- ja potilastietojen käsittelyssä syntyvien lokitietojen hallinta

Asiakas- ja potilastietojen käsittelyssä syntyvien lokitietojen hallinnan kansalliset määrittelyt löytyvät Kanta-palvelujen yhteisten määrittelyjen sivulta Asiakas- ja potilastietojen käsittelyssä syntyvien lokititetojen hallinnan kansalliset vaatimusmäärittelyt

 

Sivua päivitetty 26.3.2026