Mitätöi toimintakykytieto

Mitätöi toimintakykytieto -käyttötapaus kuvaa Kanta-palveluihin tallennetun merkinnän toimintakyvystä tai toimintakykyarvion mitätöinnin. Käyttötapaus kuvaa seuraavat tilanteet:

• Tilanne A: Sosiaali- tai terveydenhuollon palvelunantaja mitätöi omaan rekisteriinsä tallennetun toimintakykytiedon.
• Tilanne B: Sosiaali- tai terveydenhuollon palveluntuottaja mitätöi ostopalvelutilanteessa palvelunjärjestäjän rekisteriin tallennetun toimintakykytiedon. Palveluntuottaja voi mitätöidä vain itse tallentamiaan toimintakykytietoja.
  • Potilastietovarannossa tilanteessa käytetään ostopalvelun valtuutusta.
  • Sosiaalihuollon asiakastietovarannossa tilanteessa käytetään perusmuotoista rekisterinkäyttöoikeutta.
• Tilanne C: Sosiaalihuollon turvakotipalveluntuottaja mitätöi THL Turvakotipalvelut rekisteriin tallennetun toimintakykytiedon. Turvakotipalveluntuottaja voi mitätöidä vain itse tallentamansa toimintakykytiedon.
  • Tilanteessa käytetään laajaa rekisterinkäyttöoikeutta.

Merkintä toimintakyvystä tai toimintakykyarvio voidaan mitätöidä, jos se on esimerkiksi tallennettu vahingossa väärälle henkilölle Kanta-palveluissa. Kanta-palveluihin tallennettu merkintä toimintakyvystä tai toimintakykyarvio mitätöidään kokonaisuudessaan eikä esimerkiksi merkintään toimintakyvystä sisältyvää yksittäistä toimintakykyhavaintoa voida mitätöidä.

Käyttötapaukseen on tarkennettu tällä hetkellä Sosiaalihuollon asiakastietovarantoon tallennetun toimintakykytiedon mitätöinti. Tarkennukset Potilastietovarantoon tallennetun toimintakykytiedon mitätöinnistä julkaistaan syksyllä 2025.

Toimintakykytiedon mitätöimisen profiili ja operaatiot

Merkinnän toimintakyvystä ja toimintakykyarvion mitätöimisessä käytetään MitatointiProvenance -profiilia. Profiilin sisältö on kuvattu Profiilit-osiossa.

Toimintakykytiedon mitätöivän järjestelmän ja Kanta-palvelun käyttämät operaatiot on kuvattu kuvassa 2.

 

Kuva 2 Toimintakykytiedon mitätöimisen operaatiot

Käyttäjäroolit

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

Esiehdot

• Kanta-palveluihin on tallennettu merkintä toimintakyvystä tai toimintakykyarvio, joka voidaan mitätöidä.

Potilastietovaranto

Potilastietovarantoon tallennetun toimintakykytiedon mitätöinnin tarkemmat, toimialakohtaiset esiehdot tarkennetaan syksyllä 2025.

Sosiaalihuollon asiakastietovaranto

• Merkintään toimintakyvystä tai toimintakykyarvioon ei liity asiakastietovarantoon tallennettua liiteasiakirjaa.
• Tilanteessa B ja C palveluntuottajalla on oltava voimassa oleva rekisterinkäyttöoikeus palvelunjärjestäjän rekisterissä.
• Tilanteessa B ja C mitätöitävä toimintakykytieto on palveluntuottajan itse tallentama.

Normaali tapahtumankulku

1. Tallentava järjestelmä muodostaa MitatointiProvenance-profiilin mukaisen Provenance-resurssin. (V1)
   • Resurssin target.reference-tiedossa ilmoitetaan mitätöitävän pääresurssin yksilöivä tunnus (observation.id).
   • Valmistumisen tilan tulee olla ’Poistettu’.
   • Resurssin activity-rakenteessa ilmoitetaan mitätöinnin syy.
     • Sosiaalihuollon asiakastietovarannossa mitätöinnin syy ilmoitetaan coding-rakenteessa luokituksella Sosiaalihuolto - Asiakirjan mitätöinnin syy (1.2.246.537.6.1278.201701).
     • Potilastietovarannossa mitätöinnin syyn ilmoittaminen tarkennetaan syksyllä 2025.
2. Tallentava järjestelmä muodostaa transaction-tyyppisen Bundle-resurssin ja liittää siihen Provenance-resurssin. (V2)
3. Tallentava järjestelmä allekirjoittaa Bundle-resurssin FHIR-allekirjoitus määrittelyn mukaan. (V3)
4. Tallentava järjestelmä muodostaa Kanta JSON Web Tokenin määrittelyn mukaan. (V4)
   • Jos kyseessä on yksityisen palvelunantajan toimintakykytietojen mitätöiminen, 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 mitätöinnin käyttötilanne luokituksella Sosiaalihuolto – Asiakastiedon arkiston käyttötilanne (1.2.246.537.6.1289.201901).
   • Jos kyseessä on sosiaalihuollon yhteiseen asiaan liittyvän toimintakykytiedon mitätöiminen, tokenin request_record-tiedossa ilmoitetaan kaikkien yhteisen asian asiakkaiden yksilöivät tunnisteet (henkilötunnus tai tilapäinen yksilöintitunnus).
5. Tallentava järjestelmä allekirjoittaa Kanta JSON Web Tokenin. (V5)
6. Tallentava järjestelmä lähettää transaction-tyyppisen Bundle-resurssin ja Kanta JSON Web Tokenin Kanta-palveluihin. (V6)
7. Kanta-palvelut tallentaa Provenance-resurssin sekä Bundle-resurssin.
8. Kanta-palvelut lähettää järjestelmälle kuittauksen transaction-response.
   • Kanta-palvelujen palauttama vastaussanoma on kuvattu tarkemmin sivulla REST-rajapinta/Mitätöinti- ja vastaussanomat.
   • Jos mitätöinti ei onnistu, Kanta-palvelut palauttaa HTTP virhestatuskoodin sekä HTTP bodyssa OperationOutcome resurssi-instanssin, jolla ilmoitetaan tarkempi virhe.
9. Käyttötapaus jatkuu tallentavan järjestelmän oman logiikan mukaan.

Virhetilanteet

1. Provenance-resurssin muodostaminen epäonnistuu.
2. Bundle-resurssin muodostaminen epäonnistuu.
3. Bundle-resurssin allekirjoittaminen epäonnistuu.
4. Kanta JSON Web Token -operaation muodostaminen epäonnistuu.
5. Kanta JSON Web Token -operaation allekirjoittaminen epäonnistuu.
6. Operaation lähettäminen epäonnistuu.