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 syksyllä 2025.

Toimintakykymerkinnän uuden verison tallentamisessa käytettävät tallentavan järjestelmän ja Kanta-palvelun käyttämät operaatiot on kuvattu sivulla Tallenna merkintä toimintakyvystä kuvassa 1 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.
  • Kanta-palveluihin tallennettua merkintää toimintakyvystä on muutettu tallentavassa järjestelmässä.

Potilastietovaranto

Potilastietovarantoon tallennettavan merkinnän toimintakyvystä uuden version tallentamisen tarkemmat, toimialakohtaiset esiehdot tarkennetaan syksyllä 2025.

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 merkintä toimintakyvystä on palveluntuottajan itse tallentama.

Normaali tapahtumankulku

  1. Tallentava järjestelmä muodostaa uuden version merkinnän toimintakyvystä pääresurssista profiilin KantaObservationFunctionalCapacityNotation 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ä.
    • 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.
  2. Tallentava järjestelmä muodostaa uuden version/uudet versiot toimintakykykyhavainnon Observation-resurssista/resursseista profiilin KantaObservationFunctionalCapacityObservation mukaan. (V1)
  3. Tallentava järjestelmä liittää toimintakykyhavainnon/-havainnot pääresurssiin. (V2)
    • Toimintakykyhavaintojen 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 merkintä toimintakyvystä tallennetaan.
    • Sosiaalihuollon asiakastietovarannossa uudessa versiossa ei voida muuttaa asiatunnusta vaan merkintä toimintakyvystä pitää liittää samaan asiaan kuin edellinen versio.
    • Sosiaalihuollon asiakastietovarannossa uudessa versiossa ei 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 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.