Sosiaalihuollon asiakastietovarannon määrittelyt

Tältä sivulta löytyvät tietosisältö- ja viestinvälitysmäärittelyt, joita noudattaen asiakastietojärjestelmät arkistoivat asiakirjoja Sosiaalihuollon asiakastietovarantoon.

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)

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ä" ilmaisee ajanjakson, jolloin järjestelmät voivat toimia tuotantoympäristössä kyseisen version mukaisesti.
  • Lisätietoja voimassaoloajoista (thl.fi)(avautuu uuteen ikkunaan)

Sosiaalihuollon asiakirjojen metatietomalli

Sosiaalihuollon asiakirjojen metatietomalli kuvaa Sosiaalihuollon asiakastietovarantoon tallennettavat CDA R2-metatiedot sekä näiden tuottamisen, pakollisuudet ja käytön asiakirjaryhmäkohtaisesti.

Taulukko: Sosiaalihuollon asiakirjojen metatietomalli. Päivitetty 18.6.2025.

Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Sosiaalihuollon asiakirjojen metatietomalli, versio 5.2 (zip) Metatietomalliin on lisätty ammattihenkilön allekirjoituksen tiedot sekä poistettu metatieto henkilöä koskeva asiakastietojen näkyvyyden rajoittaminen. Julkaisupäivä 20.12.2023.  Toistaiseksi 20.12.2023 alkaen Toistaiseksi 20.12.2023 alkaen
Sosiaalihuollon asiakirjojen metatietomalli, versio 5.3 RC2 (zip). Release Candidate-versio sisältää asiakastietolain mukaiset asiakirjojen säilytysajan määrittelyt sekä metatiedon asiakirjan korjaamisen peruste pakollisuuden muutoksen (jatkossa valinnainen) . Julkaisupäivä 18.6.2025. RC  

Sosiaalihuollon metatietomallin metatietoesimerkit

Sosiaalihuollon metatietoesimerkit -dokumentti sisältää asiakirjaryhmäkohtaisia tietosisältöesimerkkejä Sosiaalihuollon asiakastietovarannon metatietojen käytöstä asiakirjojen tallennuksessa ja versioinnissa. 

Taulukko: Sosiaalihuollon metatietoesimerkit. Päivitetty 18.12.2024

Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Sosiaalihuollon asiakirjojen metatietomalli -metatietoesimerkit, versio 4.2 (pdf). Julkaisupäivä 20.12.2023.    
Sosiaalihuollon asiakirjojen metatietomalli- metatietoesimerkit, versio 5.3 RC1 (pdf). Release Candidate -versio sisältää asiakastietolain mukaiset asiakirjojen säilytysajan määrittelyt. Julkaisupäivä 18.12.2024.    

Sosiaalihuollon asiakastietovarannon Medical Records -sanomat

Sosiaalihuollon asiakastietovarannon viestinvälityksen dokumentaatio, jossa kuvataan Sosiaalihuollon HL7 V3 Medical Records -viestinvälitysrajapinnan määrittelyt.

Taulukko: Sosiaalihuollon Medical Records -sanomat. Päivitetty 2.4.2025

Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Sosiaalihuollon asiakastiedon arkiston Medical Records -sanomat, versio 4.2 (zip) Versio 4.2 sisältää palvelunantajan ja viranomaisen laajan tiedonsaantioikeuden tarkennukset määrittelyt. Julkaisupäivä 2.4.2025. Toistaiseksi Toistaiseksi
Sosiaalihuollon asiakastiedon arkiston Medical Records -sanomat, versio 4.3 RC1 (zip) Release Candidate versiosta on poistettu metatieto totalRetentionPeriodClass (Asiakastietojen kokonaissäilytysaika). Julkaisupäivä 2.4.2025. RC  

Sosiaalihuollon asiakastietovarannon viestinvälityksen skeemat ja esimerkkiasiakirjat

Julkaisu sisältää Sosiaalihuollon asiakastietovarannon viestinvälityksessä käytetyt skeemat sekä sanomaesimerkkejä kehittämisen tueksi.

Taulukko: Sosiaalihuollon viestinvälityksen skeemat ja esimerkkiasiakirjat. Päivitetty 18.12.2024

Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Skeemat ja esimerkkiasiakirjat.zip Julkaisupäivä 18.12.2024    

Tekninen ohje, Sosiaalihuollon asiakastietovarannon organisaatiotiedot HL7-sanomissa ja asiakirjoissa

Tekninen ohje kuvaa organisaatiotietojen käytön Sosiaalihuollon asiakastietovarannon HL7 Medical Records -sanomissa ja CDA R2 -asiakirjoissa erilaisissa käyttötilanteissa.

Taulukko: Tekninen ohje, organisaatiotiedot HL7-sanomissa ja asiakirjoissa. Päivitetty 18.6.2025

Määrittely Muutokset edelliseen versioon Voimassa tuotantokäytössä Voimassa sertifioinnissa
Tekninen ohje, organisaatiotiedot HL7 -sanomissa ja asiakirjoissa, versio 1.4 (xlsx) Haun käyttötilanne haettaessa asiakastietoja luovutuksena toisen rekisterinpitäjän rekisteristä. Julkaisupäivä 18.6.2025.    

Sosiaalihuollon luovutusilmoitus

Sosiaalihuollon luovutusilmoituksen määrittelyt on koottu Sosiaalihuollon asiakastietovarannon FHIR-määrittelyt -sivulle

Viestinvälityksen määrittelyjen aikaisemmat versiot

Sosiaalihuollon asiakastietovarannon HL7- määrittelyt

Sivua päivitetty 18.6.2025