Tallenna toimintakykyarvio

Tallenna toimintakykyarvio -käyttötapaus kuvaa toimintakykyarvion 1. version tallentamisen Kanta-palveluihin. Käyttötapaus kuvaa seuraavat tilanteet:

  • Tilanne A: Sosiaali- tai terveydenhuollon palvelunantaja tallentaa toimintakykyarvion omaan rekisteriinsä.
  • Tilanne B: Sosiaali- tai terveydenhuollon palveluntuottaja tallentaa ostopalvelutilanteessa toimintakykyarvion palvelunjärjestäjän rekisteriin.
    • Potilastietovarannossa tilanteessa käytetään ostopalvelun valtuutusta.
    • Sosiaalihuollon asiakastietovarannossa tilanteessa käytetään perusmuotoista rekisterinkäyttöoikeutta.
  • Tilanne C: Sosiaalihuollon turvakotipalveluntuottaja tallentaa toimintakykyarvion THL Turvakotipalvelut rekisteriin.
    • Tilanteessa käytetään laajaa rekisterinkäyttöoikeutta.

Käyttötapaukseen on tarkennettu tällä hetkellä Sosiaalihuollon asiakastietovarantoon tallennettavan toimintakykyarvion tallentaminen. Tarkennukset Potilastietovarantoon tallennettavan toimintakykyarvion tallentamisesta julkaistaan vuonna 2026.

Toimintakykyarvion tallentamisen operaatiot

Toimintakykyarvion tallentavan järjestelmän ja Kanta-palvelujen käyttämät operaatiot on kuvattu kuvassa 4.

  Tallenna toimintakykytieto

Kuva 4 Toimintakykyarvion tallentamisen operaatiot

Käyttäjäroolit

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

Esiehdot

Potilastietovaranto

Potilastietovarantoon tallennettavan toimintakykyarvion 1. version tallentamisen esiehdot tarkennetaan vuonna 2026.

Sosiaalihuollon asiakastietovaranto

  • Sosiaalihuollon asiakastietovarantoon on tallennettu asia-asiakirja, johon toimintakykyarvio 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ä.

Normaali tapahtumankulku

  1. Tallentava järjestelmä muodostaa toimintakykyarvion pääresurssin KantaObservationAssessment-profiilin mukaan. (V1)
  2. Jos toimintakykykyarvioon liittyy toimintakyvyn muutoksen arviointi, tallentava järjestelmä muodostaa siitä KantaObservationVariation-profiilin mukaisen/mukaiset Observation-resurssin/-resurssit. (V1)
  3. Jos toimintakykykyarvioon liittyy toimintakyvyn muutoksen arviointi, tallentava järjestelmä liittää ne pääresurssiin. (V2)
    • Toimintakyvyn muutoksen arvioinnin 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 toimintakykyarvio tallennetaan.
    • Sosiaalihuollon asiakastietovarannossa toimintakykyarvio pitää liittää asiaan.
      • Asian yksilöivänä tunnuksena (serviceEvent) ilmoitetaan sen asia-asiakirjan Asiatunnus (ClinicalDocument.componentOf.encompassingEncounter.id), johon toimintakykyarvio liittyy.
  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 sosiaalihuollon tai terveydenhuollon palvelunantajan toimintakykyarvion 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ä toimintakykyarvio, tokenin request_record-tiedossa ilmoitetaan kaikkien yhteisen asian 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 Kanta-palveluun. (V8)
  10. Kanta-palvelut tallentaa Observation- ja Provenance -resurssit.
  11. Kanta-palvelut lähettää järjestelmälle kuittauksena transaction-response-tyyppisen Bundle-resurssin.
    • Kanta-palvelujen palauttama vastaussanoma on kuvattu tarkemmin osiossa REST-rajapinta/Tallennus- ja vastaussanomat.
    • Jos toimintakykyarvion tallennus 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 muodostaminen epäonnistuu.
  2. Observation-resurssin 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.