Hae toimintakykytieto

Hae toimintakykytieto -käyttötapaus kuvaa merkinnän toimintakyvystä ja toimintakykyarvion haun Kanta-palveluista. Käyttötapaus kuvaa seuraavat tilanteet:

• Tilanne A: Sosiaali- tai terveydenhuollon palvelunantaja hakee omaan rekisteriinsä tallennettuja toimintakykytietoja.
• Tilanne B: Sosiaali- tai terveydenhuollon palveluntuottaja hakee ostopalvelutilanteessa palvelunjärjestäjän rekisteriin tallennettuja toimintakykytietoja.
  • Potilastietovarannossa tilanteessa käytetään ostopalvelun valtuutusta.
  • Sosiaalihuollon asiakastietovarannossa tilanteessa käytetään perusmuotoista rekisterinkäyttöoikeutta.
• Tilanne C: Sosiaalihuollon turvakotipalveluntuottaja hakee THL Turvakotipalvelut rekisteriin tallennetuja toimintakykytietoja.
  • Tilanteessa käytetään laajaa rekisterinkäyttöoikeutta.
• Tilanne D: Sosiaalihuollon palvelunantaja hakee toisen sosiaalihuollon palvelunantajan rekisteriin tallennettuja toimintakykytietoja luovutuksena.
• Tilanne E: Terveydenhuollon palvelunantaja hakee toisen terveydenhuollon palvelunantajan rekisteriin tallennettuja toimintakykytietoja luovutuksena.

Käyttötapaukseen on tarkennettu tällä hetkellä toimintakykytietojen hakeminen Sosiaalihuollon asiakastietovarannosta tilanteissa A–D. Tarkennukset toimintakykytietojen hakemisesta Potilastietovarannosta tilanteissa A–B ja E julkaistaan syksyllä 2025.

Toimintakykytietojen hakua Kanta-palveluista kehitetään vaiheittain. Kanta-palveluihin tullaan toteuttamaan sosiaali- ja terveydenhuollon välinen toimintakykytietojen luovuttaminen. Toteutus tehdään Kanta-palveluihin vuonna 2026.

Käyttäjäroolit

1. Hakeva järjestelmä
   • Asiakastietojärjestelmä
   • Potilastietojärjestelmä
2. Kanta-palvelut
   • Sosiaalihuollon asiakastietovaranto
   • Potilastietovaranto

Esiehdot

Potilastietovaranto

Potilastietovarantoon tallennetun toimintakykytiedon haun tarkemmat, toimialakohtaiset esiehdot tarkennetaan syksyllä 2025.

Sosiaalihuollon asiakastietovaranto

• Tilanteessa B ja C palveluntuottajalla on oltava voimassa oleva rekisterinkäyttöoikeus palvelunjärjestäjän rekisterissä.

Normaali tapahtumankulku

1. Hakeva järjestelmä tuottaa hakusanoman REST-rajapinta/Haku- ja vastaussanomat luvun mukaan. (V1)
   • Hakuparametreina voidaan käyttää toimintakykytiedon haussa käytettävissä olevia hakuparametreja (ks. REST-rajapinta/Haku- ja vastaussanomat).
   • Kaikissa hauissa haun kohteena olevan henkilön (asiakas tai potilas) yksilöivä tunnus on pakollinen hakuparametri.
     • Tilanteissa A, B ja C haun kohteena oleva henkilö yksilöidään joko henkilötunnuksella tai tilapäisellä yksilöintitunnuksella.
     • Tilanteissa D ja E haun kohteena oleva henkilö yksilöidään henkilötunnuksella.
   • Sosiaalihuollon asiakastietovarannossa tilanteessa B ja C palvelunjärjestäjän yksilöivä tunnus on pakollinen hakuparametri.
2. Hakeva järjestelmä muodostaa Kanta JSON Web Tokenin määrittelyn mukaan. (V2)
   • Jos kyseessä on yksityisen palvelunantajan toimintakykytietojen haku, tokenin connection_model-tiedossa ilmoitetaan käytetty liittymismalli luokituksella Kanta-palvelut – Yksityisten toimijoiden liittymismallit (1.2.246.537.5.40200.2014).
   • Sosiaalihuollon asiakastietovarannossa tokenin request_purpose-tiedossa ilmoitetaan haun käyttötilanne luokituksella Sosiaalihuolto – Asiakastiedon arkiston käyttötilanne (1.2.246.537.6.1289.201901).
3. Hakeva järjestelmä allekirjoittaa Kanta JSON Web Tokenin. (V3)
4. Hakeva järjestelmä lähettää hakusanoman Kanta-palveluihin. (V4)
5. Kanta-palvelut suorittaa haun.
6. Kanta-palvelut palauttaa haun vastauksen.
   • Kanta-palvelujen palauttama vastaussanoma on kuvattu tarkemmin sivulla REST-rajapinta/Haku- ja vastaussanomat.
   • Jos haku päättyy virheeseen, Kanta-palvelut palauttaa HTTP-virhestatuskoodin sekä HTTP-bodyssa OperationOutcome resurssi-instanssin, jolla ilmoitetaan tarkempi virhe.
7. Hakeva järjestelmä vastaanottaa hakuvastauksen. (V5)
8. Käyttötapaus jatkuu hakevan järjestelmän oman logiikan mukaan, esim. järjestelmä näyttää hakutulokset.

Virhetilanteet

1. Hakusanoman muodostaminen epäonnistuu.
2. Kanta JSON Web Token -operaation muodostaminen epäonnistuu.
3. Kanta JSON Web Token -operaation allekirjoittaminen epäonnistuu.
4. Hakusanoman lähettäminen epäonnistuu.
5. Hakuvastauksen vastaanottaminen epäonnistuu.