Sosiaalihuollon asiakastietovarannon viimeisimmät määrittelyjulkaisut

Tälle sivulle on koottu yhteenveto Sosiaalihuollon asiakastietovarannon määrittelyjen viimeisimmistä julkaisuista. Sosiaalihuollon asiakastietovarannon määrittelyt ovat pääosin saatavilla vain suomeksi.

18.12.2025 on julkaistu seuraavat Sosiaalihuollon asiakastietovarannon määrittelyjen päivitykset

  • Kanta-palvelujen käsikirja sosiaalihuollon toimijoille (yhteistyötilat)
  • ATJ-vaatimukset
  • Rajapintakäyttötapaukset
  • Sosiaalihuollon asiakastietovarannon Medical Records -sanomat
  • Asiakirjastandardi
  • Toimintakykytietojen FHIR-määritysten päivityksiä

Määrittelyjulkaisun sisältö: ATJ-vaatimuksiin on tehty pienehköjä tarkennuksia ja selkeytetty vaatimusten ja lisätietojen sanamuotoja (vaatimukset AsiaY19, HaAsk01, AkrSi28, ArY48). Rajapintakäyttötapaukset -dokumenttiin ja Medical Records -määrittelyyn on päivitetty liiteasiakirjan tallennuksessa pääasiakirjasta ilmoitettavia tietoja. Asiakirjastandardiin on lisätty päivitetyn CSS-tyylitiedoston mukainen HTML-esimerkki. Kanta-käsikirjaan on päivitetty mm. yhteisen asian linjauksia sekä lisätty alaluku kuraattoritietojen käsittelystä. Lisäksi toimintakykytietojen FHIR-määrityksiin on julkaistu päivityksiä.
Rajapintakäyttötapaukset ja Medical Records -sanomat on julkaistu RC-versioina.

5.12.2025 on julkaistu FHIR-implementointiopas Sosiaali- ja terveydenhuollon välinen luovutuslupa R4(avautuu uuteen ikkunaan)  v. 1.0.0 RC1 Simplifierissa. Tähän liittyy jo aiemmin julkaistu dokumentti  Sosiaali- ja terveydenhuollon tahdonilmaisuja käsittelevien tietojärjestelmien vaatimukset ja toiminnallinen määrittely(avautuu uuteen ikkunaan).

21.11.2025 on julkaistu seuraavat Sosiaalihuollon asiakastietovarannon määrittelyjen päivitykset

  • SOTE-yhteisten toimintakykytietojen FHIR-määritykset

Määrittelyjulkaisun sisältö: Päivitetty toimintakykytietojen tallentamisessa käytettäviä profiileita ja laajennoksia sekä julkaistu soveltamisoppaasta versio 1.0.0_rc3. Soveltamisoppaan versioon 1.0.0_rc3 on tarkennettu Sosiaalihuollon asiakastietovarannon palauttamaa haun vastaussanomaa. 

1.10.2025 on julkaistu seuraavat Sosiaalihuollon asiakastietovarannon määrittelyjen päivitykset

  • SOTE-yhteisten toimintakykytietojen FHIR-määritykset
  • Kanta-palvelujen käsikirja sosiaalihuollon toimijoille (yhteistyötilat)
  • ATJ-vaatimukset
  • Rajapintakäyttötapaukset

Määrittelyjulkaisun sisältö:  Toimintakykytietojen määrittelykokonaisuus, joka sisältää FHIR-muotoisten toimintakykyasiakirjojen käsittelyn määrittelyt Sosiaalihuollon asiakastietovarannossa sekä Kanta-palveluiden yhteisiä määrittelyjä. ATJ-vaatimuksiin on lisätty FHIR-muotoisten asiakastietojen käsittelyä ja mitätöintiä koskevat vaatimukset sekä korjaus asian näyttämisen rajoitusten päivitystä koskevan vaatimuksen AsiaY19 lisätietoihin. Kanta-käsikirjaan on päivitetty toimintakykytietojen käsittelyä koskeva kappale lukuun 9.7 sekä tarkennettu varmennekortteihin ja asiakastietojen säilytysaikoihin liittyviä määrittelyjä. Rajapintakäyttötpaukset on julkaistu RC-versiona, johon on lisätty FHIR-muotoinen pääasiakirja liiteasiakirjojen käsittelyyn.

18.6.2025 on julkaistu seuraavat Sosiaalihuollon asiakastietovarannon määrittelyjen päivitykset

  • Kanta-palvelujen käsikirja sosiaalihuollon toimijoille (yhteistyötilat)
  • ATJ-vaatimukset
  • Metatietomalli (RC)

Määrittelyjulkaisun sisältä:  ATJ-vaatimuksiin on päivitetty allekirjoituksen vaatimukset vastaamaan toteutusta (YAl18) sekä tehty tarkennuksia ja selkeytetty tekstisisältöä (esim. YY05, YY16). Metatietomalliin on muutettu asiakirjan korjaamisen peruste valinnaiseksi metatiedoksi. Kanta-käsikirjaan on päivitetty esimerkiksi yhteisen asian sekä asiakirjan näyttämisen rajoitusten toiminnallisia määrityksiä. Metatietomalli on julkaistu RC-versiona.

5.5.2025 on alkanut sosiaali- ja terveydenhuollon toimitakykytietojen määrittelyn kommentointikierros

Sosiaalihuollossa otetaan käyttöön tietosisältö ja FHIR-rajapinta asiakkaan toimintakykyyn liittyvien tietojen kirjaamiseen ja hyödyntämiseen. Kommentointoitava sisältö ja vastausten Lyyti-kyselyn linkki löytyvät Kanta.fi -sivulta Määrittelyjen kommentointi. Kommentteja voi antaa 30.5.2025 saakka.

2.4.2025 on julkaistu seuraavat Sosiaalihuollon asiakastietovarannon määrittelyjen päivitykset

  • Kanta-palvelujen käsikirja sosiaalihuollon toimijoille (yhteistyötilat)
  • ATJ-vaatimukset
  • Rajapintakäyttötapaukset
  • Sosiaalihuollon asiakastietovarannon Medical Records -sanomat

Määrittelyjulkaisu sisältää: ATJ-vaatimuksiin on tehty pienehköjä tarkennuksia. Rajapintakäyttötapausten ja MR-dokumentin RC-versiot on nostettu virallisiksi. Kanta-käsikirjaan on täydennetty asianhallinnan määrittelyjä sekä asian tilan käsittelyn kuvausta (luku 8) sekä päivitetty lakiviittausten linkkejä useisiin lukuihin.  
MR-dokumentti on virallisen version lisäksi julkaistu RC-versiona.

18.12.2024 on julkaistu seuraavat Sosiaalihuollon asiakastietovarannon määrittelyjen päivitykset

  • Kanta-palvelujen käsikirja sosiaalihuollon toimijoille (yhteistyötilat)
  • ATJ-vaatimukset
  • Tiedonhallinnan tukiprosessit
  • Sosiaalihuollon asiakastietovarannon Medical Records -sanomat
  • Sosiaalihuollon metatietomalli

Määrittelyjulkaisu sisältää: ATJ-vaatimuksiin (AkrSi20 ja AkrSi21) ja tiedonhallinnan tukiprosessien määrittelyihin on tehty pienehköjä tarkennuksia. Metatietomallin ja MR-dokumentin säilytysajan määrittelyt on päivitetty asiakastietolain mukaisiksi. Kolmella ensiksi mainitulla on lisäksi palvelun nimeksi muutettu Sosiaalihuollon asiakastietovaranto. Kanta-käsikirjaan on lisätty uusi luku 12.6 (Asiakastietojärjestelmän vaihtuminen rekisterinpitäjällä) ja poistettu luvusta 4 (Liittyminen sosiaalihuollon Kanta-palvelujen käyttäjäksi) päällekkäisyydet Kanta.fi -sivujen kanssa sekä ajantasaistettu viittaukset  lainsäädäntöön.
Metatietomalli ja MR-dokumentti on julkaistu RC-versiona.

26.9.2024 on julkaistu seuraavat Sosiaalihuollon asiakastietovarannon määrittelyjen päivitykset

  • Kanta-palvelujen käsikirja sosiaalihuollon toimijoille (yhteistyötilat)
  • ATJ-vaatimukset
  • Sosiaalihuollon asiakastietovarannon Medical Records -sanomat
  • Sosiaalihuollon luovutusilmoituksen FHIR-määrittelyt

Määrittelyjulkaisu sisältää: Laajan tiedonsaantioikeuden määrittelyjä on tarkennettu Medical Records -sanomien määrittelyyn (julkaistu RC-versiona). ATJ-vaatimuksiin on lisätty 2 uutta haetun asiakirjan tietojen näyttämiseen liittyvää vaatimusta. 
Sosiaalihuollon luovutusilmoituksen FHIR-määrittelyihin on julkaistu uusia esimerkkisanomia ja Kanta sosiaalihuolto R4 simplifier -projektin etusivu on päivitetty.
Lisäksi Kanta-käsikirjaan on tehty päivityksiä, esimerkiksi ajantasaistettu luvun 5 (Sosiaalihuollon OmaKanta) määrittelyjä sekä tarkennettu lukuun 14 (Luovutustenhallinta) linjausta yhteisen asian asiakirjojen käsittelystä ja luovuttamisesta.

19.6.2024 on julkaistu seuraavat Sosiaalihuollon asiakastietovarannon määrittelyjen päivitykset

  • Kanta-palvelujen käsikirja sosiaalihuollon toimijoille (yhteistyötilat)
  •  Rajapintakäyttötapaukset
  •  Organisaatiotiedot HL7-sanomissa ja asiakirjoissa
  •  Sosiaalihuollon luovutusilmoituksen FHIR-määrittelyt 

Määrittelyjulkaisu sisältää laajan tiedonsaantioikeuden määrityksiin täydennyksiä, jotka on päivitetty seuraaviin määrittelyihin: rajapintakäyttötapaukset ja Organisaatiotiedot HL7-sanomissa ja asiakirjoissa. Sekä rajapintakäyttötapaukset että Organisaatiotiedot HL7-sanomissa ja asiakirjoissa on julkaistu RC-versioina. Sosiaalihuollon luovutusilmoituksen FHIR-määrittelyihin on tehty profiilien ja esimerkkisanomien versiopäivityksiä. Kanta-käsikirjaan on päivitetty asiakastietolain muutospaketin mukaiset siirtymäajat sekä Sosiaalihuollon asiakastietovarannon nimimuutos. 

27.3.2024 on julkaistu seuraavat Sosiaalihuollon asiakastiedon arkiston määrittelyjen päivitykset

  • Kanta-palvelujen käsikirja sosiaalihuollon toimijoille (yhteistyötilat)
  • ATJ-vaatimukset
  • Tiedonhallinnan tukiprosessit
  •  Rajapintakäyttötapaukset
  •  Sosiaalihuollon asiakastiedon arkiston Medical Records -sanomat
  •  Sosiaalihuollon luovutusilmoituksen FHIR-määrittelyt 

Määrittelyjulkaisu sisältää palvelunantajan ja viranomaisen laajan tiedonsaantioikeuden määritykset, jotka on lisätty seuraaviin määrittelyihin: ATJ-vaatimukset, tiedonhallinnan tukiprosessit, rajapintakäyttötapaukset ja MedicalRecords -sanomat. Rajapintakäyttötapaukset ja MR-dokumentti on julkaistu RC-versioina. Sosiaalihuollon luovutusilmoituksen FHIR-määrittelyihin on tehty profiilien ja esimerkkisanomien versiopäivityksiä sekä täydennetty toteutusoppaan vastaussanomia koskevaa osiota. Kanta-käsikirjaan on tehty päivityksiä, esimerkiksi lukuihin 10 ja 14.  Lisäksi tässä julkaisuissa on määrittelyiden yhteyteen lisätty tieto niiden voimassaolosta.