Versioi toimintakykyarvio

Versioi toimintakykyarvio -käyttötapaus kuvaa Kanta-palveluihin tallennetun toimintakykyarvion uuden version tallentamisen. Käyttötapaus kuvaa seuraavat tilanteet:

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

Kanta-palveluihin tallennettu toimintakykyarvio versioidaan kokonaisuudessaan eikä esimerkiksi toimintakykyarvioon sisältyvää yksittäistä toimintakyvyn muutoksen arviointia voi versioida.

Käyttötapaukseen on tarkennettu tällä hetkellä Sosiaalihuollon asiakastietovarantoon tallennetun toimintakykyarvion uuden version tallentaminen. Tarkennukset Potilastietovarantoon tallennetun toimintakykyarvion uuden version tallentamisesta julkaistaan syksyllä 2025.

Toimintakykyarvion uuden version tallentamisessa käytettävät tallentavan järjestelmän ja Kanta-palvelun käyttämät operaatiot on kuvattu sivulla Tallenna toimintakykyarvio kuvassa 2 Toimintakykyarvion tallentamisen operaatiot.

Käyttäjäroolit

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

Esiehdot

  • Ennen toimintakykyarvion muuttamista tallentava järjestelmä on hakenut muutettavan toimintakykyarvion Kanta-palveluista sen varmistamiseksi, että muutos tehdään arvion viimeisimpään versioon.
  • Kanta-palveluihin tallennettua toimintakykyarviota on muutettu tallentavassa järjestelmässä.

Potilastietovaranto

Potilastietovarantoon tallennettavan toimintakykyarvion uuden version tallentamisen tarkemmat, toimialakohtaiset 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ä.
  • Tilanteessa B versioitava toimintakykyarvio on palveluntuottajan itse tallentama.

Normaali tapahtumankulku

  1. Tallentava järjestelmä muodostaa uuden version toimintakykyarvion pääresurssista profiilin KantaObservationFunctionalCapacityAssessment 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 toimintakykyarviolla.
    • Asiakkaan henkilötietoja voidaan korjata. Esim. henkilötunnuksen vaihtuessa asiakkaan tiedoissa välitetään sekä vanha että uusi henkilötunnus. Toimintakykyarviota ei saa tallentaa toiselle henkilölle.
  2. Jos toimintakykykyarvioon liittyy toimintakyvyn muutoksen arviointi, tallentava järjestelmä muodostaa siitä uuden version/uudet versiot profiilin KantaObservationFunctionalCapacityVariation mukaan. (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.
    • Rekisterinpitäjänä (Custodian) ilmoitetaan se rekisterinpitäjä, jonka rekisteriin toimintakykyarvio tallennetaan.
    • Sosiaalihuollon asiakastietovarannossa uudessa versiossa ei voida muuttaa asiatunnusta vaan merkintä toimintakykyarvio pitää liittää samaan asiaan kuin edellinen versio.
    • Sosiaalihuollon asiakastietovarannossa uudessa versiossa ei muuttaa palveluntuottajan tietoja, jos toimintakykyarvio 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 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 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.