Tallenna merkintä toimintakyvystä

Tallenna merkintä toimintakyvystä -käyttötapaus kuvaa merkinnän toimintakyvystä tallentamisen Kanta-palveluihin. Käyttötapaus kuvaa seuraavat tilanteet:

  • Tilanne A: Sosiaali- tai terveydenhuollon palvelunantaja tallentaa merkinnän toimintakyvystä omaan rekisteriinsä.
  • Tilanne B: Sosiaali- tai terveydenhuollon palveluntuottaja tallentaa ostopalvelutilanteessa merkinnän toimintakyvystä 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 merkinnän toimintakyvystä THL Turvakotipalvelut rekisteriin.
    • Tilanteessa käytetään laajaa rekisterinkäyttöoikeutta.

Käyttötapaukseen on tarkennettu tällä hetkellä Sosiaalihuollon asiakastietovarantoon tallennettavan merkinnän toimintakyvystä tallentaminen. Tarkennukset Potilastietovarantoon tallennettavan merkinnän toimintakyvystä tallentamisesta julkaistaan syksyllä 2025.

Merkinnän toimintakyvystä tallentamisen operaatiot

Merkinnän toimintakyvystä tallentavan järjestelmän ja Kanta-palvelujen käyttämät operaatiot on kuvattu kuvassa 1.

  Tallenna toimintakykytieto

Kuva 1 Merkinnän toimintakyvystä tallentamisen operaatiot

Käyttäjäroolit

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

Esiehdot

Potilastietovaranto

Potilastietovarantoon tallennettavan merkinnän toimintakyvystä ensimmäisen version tallentamisen 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ä.

Normaali tapahtumankulku

  1. Tallentava järjestelmä muodostaa merkinnän toimintakyvystä pääresurssin profiilin KantaObservationFunctionalCapacityNotation mukaan. (V1)
  2. Tallentava järjestelmä muodostaa toimintakykykyhavainnosta Observation-resurssin/resurssit 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 merkintä toimintakyvystä pitää liittää asiaan.
      • Asian yksilöivänä tunnuksena (encompassingEncounterId) ilmoitetaan sen asia-asiakirjan Asiatunnus (ClinicalDocument.componentOf.encompassingEncounter.id), johon merkintä toimintakyvystä 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 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 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ä 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.