Etusivu
Sosiaali- ja terveydenhuollossa otetaan käyttöön yhteinen tietosisältö ja pääosin yhteinen FHIR-rajapinta asiakkaan toimintakykyyn liittyvien tietojen kirjaamiseen ja hyödyntämiseen. Tämä soveltamisopas on sosiaali- ja terveydenhuollon yhteisen toimintakykytiedon käsittelyn kehitysversio.
Soveltamisoppaassa on kuvattu toimintakykytietojen käsittelyn Kanta-palvelujen yhteiset määrittelyt ja Sosiaalihuollon asiakastietovarannon määrittelyt. Potilastietovarantoon tallennettavan toimintakykytiedon käsittelyn rajapinta tarkentuu vuonna 2026, ja näistä tarkennuksista järjestetään myöhemmin kommentointikierros.
Soveltamisoppaassa toimintakykytiedolla tarkoitetaan merkintää toimintakyvystä ja toimintakykyarviota. Soveltamisoppaassa kuvataan toimintakykytietojen käsittelyn FHIR-standardin mukainen tietojen siirto asiakas- ja potilastietojärjestelmien (jatkossa tallentava järjestelmä) ja Kanta-palvelujen välillä. Tallentavien järjestelmien ja Kanta-palvelujen välistä FHIR-rajapintaa kehitetään vaiheittain. Toteutus tehdään Sosiaalihuollon asiakastietovarantoon vuoden 2025 aikana ja Potilastietovarantoon vuonna 2026.
Sosiaalihuollossa toimintakykytietojen käsittely on osa lain sosiaali- ja terveydenhuollon asiakastietojen käsittelystä (703/2023) liittymisvelvoitteen mukaista toiminnallisuutta, joten se täytyy olla käyttöönotettuna sosiaalihuollon palvelunantajilla viimeistään 1.9.2026.
Terveyden ja hyvinvoinnin laitos (THL) on julkaissut toimintakykytiedon kirjaamisesta oppaan Kirjaamisopas: Toimintakyky. Kirjaamisoppaassa kuvataan mm. toimintakykytiedon rakenteisen kirjaamisen hyötyjä ja esimerkkejä toimintakykytiedon kirjaamisesta. THL julkaisee toimintakykytiedon kirjaamisoppaasta uuden version sen jälkeen, kun muut toimintakykytiedon tallentamisen määrittelyt ovat tarkentuneet.
Soveltamisoppaan osiossa Käyttötapaukset kuvataan merkinnän toimintakyvystä ja toimintakykyarvion tallentamisen, versioimisen, mitätöinnin ja haun käyttötapaukset. Metatiedot ja näyttömuoto -osiossa kuvataan toimintakykytiedon toimialakohtaiset metatiedot sekä näyttömuoto. Tällä hetkellä osioon on tarkennettu Sosiaalihuollon asiakastietovarantoon tallennettavien toimintakykytietojen metatiedot. Potilastietovarantoon tallennettavien toimintakykytietojen metatiedot tarkennetaan vuonna 2026. Terminologiat-osiossa kuvataan toimintakykytiedon toteutuksessa tarvittavat Valuesetit ja Codesystemit. Profiilit-osiossa kuvataan toimintakykytiedon tallentamisessa käytettävät FHIR-profiilit. Laajennokset-osiossa kuvataan toimintakykytiedon käsittelyssä käytettävät laajennokset. Esimerkit-osiossa on esimerkit sosiaalihuollossa laaditusta merkinnästä toimintakyvystä ja toimintakykyarviosta.
Kaikki tässä soveltamisoppaassa määritellyt profiilit perustuvat HL7® FHIR:n ® R4-versioon. Soveltamisoppaan lukijalla oletetaan olevan perustietämys FHIR-standardista.
Potilastietovarannon ja Sosiaalihuollon asiakastietovarannon FHIR-standardin mukaisissa toteutuksissa Kanta-palveluissa tuettu formaatti on JSON eikä muita formaatteja tueta.
Profiiliesimerkeissä käytetyt henkilötunnukset ovat testihenkilötunnuksia.
Yhteystiedot
FHIR-rajapinnan toteutukseen ja tähän soveltamisoppaaseen liittyvät kysymykset voi laittaa sähköpostilla osoitteeseen kanta@kanta.fi.
Sisältö
- Etusivu
- Johdanto
- Käyttötapaukset
- Tallenna merkintä toimintakyvystä
- Tallenna toimintakykyarvio
- Versioi merkintä toimintakyvystä
- Versioi toimintakykyarvio
- Mitätöi toimintakykytieto
- Hae toimintakykytieto
- Metatiedot ja näyttömuoto
- REST rajapinta
- HTTP header
- JSON Web Token
- FHIR allekirjoitus
- Tallennus- ja vastaussanomat
- Versiointi- ja vastaussanomat
- Mitätöinti- ja vastaussanomat
- Hakusanomat
- Haun vastaussanomat
- Terminologiat
- FHIR-tietosisältö
- Profiilit
- KantaObservationNotation
- KantaObservationObservation
- KantaObservationAssessment
- KantaObservationVariation
- KantaPatientV2
- KantaObservationGroup
- KantaPractitionerV2
- KantaOrganization
- KantaObservationPractitionerRole
- SocialWelfareProvenance
- MitatointiProvenance
- Laajennokset
- FunctionalCapacityOwnEstimation
- FunctionalAssessmentSubjectBackround
- FunctionalAssessmentPeriodDescription
- FunctionalAssessmentRelatedNotations
- FunctionalAssessmentRelatedDocuments
- FunctionalAssessmentPurpose
- ObservationFunctionalLimitation
- ObservationLimitationEndReason
- ObservationLimitationStability
- ObservationPlace
- RegisterType
- ProvenanceSpecialContent
- ProvenanceAuthorizationConsent
- ProvenanceReleaseForPatientViewing
- ServiceEvent
- SocialService
- DocumentType
- FunctionCode
- SpecificDocumentType
- ServiceProcess
- ObservationFunctionalAmendment
- ObservationICFSpecification
- RelatedEncompassingEncounterId
- PractitionerTitle
- Esimerkit
- Versiohistoria