Versioi merkintä toimintakyvystä

Versioi merkintä toimintakyvystä -käyttötapaus kuvaa Kanta-palveluihin tallennetun merkinnän toimintakyvystä uuden version tallentamisen. Käyttötapaus kuvaa seuraavat tilanteet:

• Tilanne A: Sosiaali- tai terveydenhuollon palvelunantaja tallentaa uuden version merkinnästä toimintakyvystä omaan rekisteriinsä.
• Tilanne B: Sosiaali- tai terveydenhuollon palveluntuottaja tallentaa ostopalvelutilanteessa uuden version merkinnästä toimintakyvystä palvelunjärjestäjän rekisteriin. Palveluntuottaja voi versioida vain itse tallentamiaan merkintöjä toimintakyvystä.
  • Potilastietovarannossa tilanteessa käytetään ostopalvelun valtuutusta.
  • Sosiaalihuollon asiakastietovarannossa tilanteessa käytetään perusmuotoista rekisterinkäyttöoikeutta.
• Tilanne C: Sosiaalihuollon turvakotipalveluntuottaja tallentaa uuden version merkinnästä toimintakyvystä THL Turvakotipalvelut rekisteriin.
  • Tilanteessa käytetään laajaa rekisterinkäyttöoikeutta.

Kanta-palveluihin tallennettu merkintä toimintakyvystä versioidaan kokonaisuudessaan eikä merkintään toimintakyvystä sisältyvää yksittäistä toimintakykyhavaintoa voida versioida itsenäisenä.

Käyttötapaukseen on tarkennettu tällä hetkellä Sosiaalihuollon asiakastietovarantoon tallennetun merkinnän toimintakyvystä uuden version tallentaminen. Tarkennukset Potilastietovarantoon tallennetun merkinnän toimintakyvystä uuden version tallentamisesta julkaistaan vuonna 2026.

Toimintakykymerkinnän uuden version tallentamisessa käytettävät tallentavan järjestelmän ja Kanta-palvelun käyttämät operaatiot on kuvattu sivulla Tallenna merkintä toimintakyvystä kuvassa 3 Toimintakykymerkinnän tallentamisen operaatiot.

Käyttäjäroolit

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

Esiehdot

• Ennen merkinnän toimintakyvystä muuttamista tallentava järjestelmä on hakenut muutettavan merkinnän toimintakyvystä Kanta-palveluista sen varmistamiseksi, että muutos tehdään merkinnän viimeisimpään versioon ellei voida olla varmoja, että tallentavassa järjestelmässä on merkinnän viimeisin versio.
• Kanta-palveluihin tallennettua merkintää toimintakyvystä on muutettu tallentavassa järjestelmässä.

Potilastietovaranto

Potilastietovarantoon tallennettavan merkinnän toimintakyvystä uuden version tallentamisen tarkemmat, toimialakohtaiset esiehdot tarkennetaan vuonna 2026.

Sosiaalihuollon asiakastietovaranto

• Sosiaalihuollon asiakastietovarantoon on tallennettu asia-asiakirja, johon merkintä toimintakyvystä liittyy.
• Asia-asiakirjan asian tilan on oltava Avoin tai Avattu uudelleen.
• Tilanteessa B ja C palveluntuottajalla on oltava voimassa oleva rekisterinkäyttöoikeus palvelunjärjestäjän rekisterissä.
• Tilanteessa B versioitava merkintä toimintakyvystä on palveluntuottajan itse tallentama.

Normaali tapahtumankulku

1. Tallentava järjestelmä muodostaa uuden version merkinnän toimintakyvystä pääresurssista profiilin KantaObservationNotation mukaan. (V1)
   • Globaalisti yksilöivänä tunnuksena (Observation.id) käytetään Kanta-palvelujen tuottamaa yksilöintitunnusta, jonka Kanta-palvelut on palauttanut haun vastaussanomassa.
   • Observation.identifier -tiedon tulee olla sama kuin korvattavalla merkinnällä toimintakyvystä.
   • Potilastietovarannossa asiakkaan henkilötietoja voidaan korjata. Esim. henkilötunnuksen vaihtuessa asiakkaan tiedoissa välitetään sekä vanha että uusi henkilötunnus. Merkintää toimintakyvystä ei saa tallentaa toiselle henkilölle.
   • Sosiaalihuollon asiakastietovarannossa asiakkaan tilapäinen yksilöintitunnus voidaan muuttaa henkilötunnukseksi. Asiakkaan tiedoissa välitetään sekä tilapäinen yksilöintitunnus että henkilötunnus. Merkintää toimintakyvystä ei saa tallentaa toiselle henkilölle.
2. Tallentava järjestelmä muodostaa uuden version/uudet versiot toimintakykykyhavainnon Observation-resurssista/resursseista profiilin KantaObservationObservation mukaan. (V1)
3. Tallentava järjestelmä liittää toimintakykyhavainnon/-havainnot pääresurssiin. (V2)
   • Toimintakykyhavaintojen Observation-resurssit liitetään pääresurssiin hasMember-rakenteella contained-resursseina.
4. Tallentava järjestelmä muodostaa toimialakohtaisen Provenance-profiilin mukaisen Provenance-resurssin. (V3)
   • Potilastietovarannossa käytettävä profiili tarkennetaan vuonna 2026.
   • Sosiaalihuollon asiakastietovarannossa käytetään profiilia SocialWelfareProvenance.
   • Resurssin target.reference-tiedossa ilmoitetaan pääresurssin yksilöivä tunnus (observation.id).
   • Rekisterinpitäjänä (Custodian) ilmoitetaan se rekisterinpitäjä, jonka rekisteriin merkintä toimintakyvystä tallennetaan.
   • Sosiaalihuollon asiakastietovarannossa uudessa versiossa ei voi muuttaa asiatunnusta vaan merkintä toimintakyvystä pitää liittää samaan asiaan kuin edellinen versio.
   • Sosiaalihuollon asiakastietovarannossa uudessa versiossa ei voi muuttaa palveluntuottajan tietoja, jos merkintä toimintakyvystä tallennetaan perusmuotoisen rekisterinkäyttöoikeuden perusteella.
5. Tallentava järjestelmä muodostaa transaction-tyyppisen Bundle-resurssin ja liittää siihen Observation- ja Provenance -resurssit. (V4)
6. Tallentava järjestelmä allekirjoittaa Bundle-resurssin FHIR-allekirjoitus määrittelyn mukaan. (V5)
7. Tallentava järjestelmä muodostaa Kanta JSON Web Tokenin määrittelyn mukaan. (V6)
   • Jos kyseessä on yksityisen palvelunantajan merkinnän toimintakyvystä tallentaminen, 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 tallentamisen käyttötilanne luokituksella Sosiaalihuolto – Asiakastiedon arkiston käyttötilanne (1.2.246.537.6.1289.201901).
   • Jos kyseessä on sosiaalihuollon yhteiseen asiaan liittyvä merkintä toimintakyvystä, tokenin request_record-tiedossa ilmoitetaan kaikkien tallennushetkellä asiassa asiakkaina olevien asiakkaiden yksilöivät tunnisteet (henkilötunnus tai tilapäinen yksilöintitunnus).
8. Tallentava järjestelmä allekirjoittaa Kanta JSON Web Tokenin. (V7)
9. Tallentava järjestelmä lähettää transaction-tyyppisen Bundle-resurssin ja Kanta JSON Web Tokenin Kanta-palveluun. (V8)
10. Kanta-palvelut tallentaa Observation- ja Provenance -resurssit sekä Bundle-resurssin.
11. Kanta-palvelut lähettää järjestelmälle kuittauksen transaction-response.
    • Kanta-palvelujen palauttama vastaussanoma on kuvattu tarkemmin osiossa REST-rajapinta/Tallennus- ja vastaussanomat.
    • Jos uuden version tallentaminen ei onnistu, Kanta-palvelut palauttaa HTTP virhestatuskoodin sekä HTTP bodyssa OperationOutcome resurssi-instanssin, jolla ilmoitetaan tarkempi virhe.
12. Käyttötapaus jatkuu tallentavan järjestelmän oman logiikan mukaan.

Virhetilanteet

1. Observation-resurssin uuden version muodostaminen epäonnistuu.
2. Resurssien liittäminen epäonnistuu.
3. Provenance-resurssin muodostaminen epäonnistuu.
4. Bundle-resurssin muodostaminen epäonnistuu.
5. Bundle-resurssin allekirjoittaminen epäonnistuu.
6. Kanta JSON Web Token -operaation muodostaminen epäonnistuu.
7. Kanta JSON Web Token -operaation allekirjoittaminen epäonnistuu.
8. Operaation lähettäminen epäonnistuu.