Tallenna toimintakykyarvio

Tallenna toimintakykyarvio -käyttötapaus kuvaa toimintakykyarvion 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 syksyllä 2025.

Toimintakykyarvion tallentamisen operaatiot

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

  Tallenna toimintakykytieto

Kuva 2 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 ensimmäisen version tallentamisen esiehdot tarkennetaan syksyllä 2025.

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 profiilin KantaObservationFunctionalCapacityAssessment mukaan. (V1)
  2. Jos toimintakykykyarvioon liittyy toimintakyvyn muutoksen arviointi, tallentava järjestelmä muodostaa siitä profiilin KantaObservationFunctionalCapacityVariation mukaisen/mukaiset Observation-resurssin/-resurssit. (V1)
  3. Jos toimintakykykyarvioon liittyy toimintakyvyn muutoksen arviointi, tallentava järjestelmä liittää ne päärerurssiin. (V2)
    • Toimintakyvyn muutoksen arvioinnin Observation-resurssit liitetään pääresurssiin hasMember-rakenteella.
  4. Tallentava järjestelmä muodostaa toimialakohtaisen Provenance-profiilin mukaisen Provenance-resurssin. (V3)
    • Potilastietovarannossa käytettävä profiili tarkennetaan syksyllä 2025.
    • 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 (encompassingEncounterId) 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 merkinnän toimintakyvystä/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.