{
  "description": "Profiili, jota käytetään toimintakykyarvion tallentamiseen Kanta-palveluihin. Toimintakykyarvion tietorakenne on mallinnettu Termeta-palvelussa.",
  "_filename": "KantaObservationAssesment.StructureDefinition.json",
  "package_name": "fi.kela.kanta.gen.r4.toimintakyky",
  "date": "2025-11-19",
  "derivation": "constraint",
  "publisher": "Kela",
  "fhirVersion": "4.0.1",
  "name": "KantaObservationAssessment",
  "abstract": false,
  "type": "Observation",
  "experimental": null,
  "resourceType": "StructureDefinition",
  "title": "KantaObservationAssessment",
  "package_version": "1.0.0-rc3",
  "status": "draft",
  "id": "7b5ea81a-412a-49d1-83cf-f588af54c812",
  "kind": "resource",
  "url": "https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationAssessment",
  "version": "1.1.0",
  "differential": {
    "element": [ {
      "id": "Observation",
      "path": "Observation",
      "short": "Toimintakykyarvio",
      "definition": "Toimintakykyarvio voi koskea tiettyä toimintakyvyn osa-aluetta, kuten fyysistä tai psyykkistä toimintakykyä."
    }, {
      "id": "Observation.id",
      "min": 1,
      "path": "Observation.id",
      "short": "Toimintakykyarvion yksilöivä tunnus",
      "definition": "Lähettävän järjestelmän tuottama tunnus, joka on voimassa tiedonsiirron ajan"
    }, {
      "id": "Observation.meta",
      "path": "Observation.meta"
    }, {
      "id": "Observation.meta.profile",
      "max": "1",
      "min": 1,
      "path": "Observation.meta.profile",
      "fixedCanonical": "https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationAssessment"
    }, {
      "id": "Observation.meta.security",
      "path": "Observation.meta.security",
      "short": "Toimintakykyarvion näyttämisen rajoitukset",
      "definition": "Sosiaalihuollon toimintakykyarvion haussa Kanta-palvelut lisää Observation.meta.security-elementtiin:\r\n\r\n1) Tiedon Huoltajaa koskevasta luovutuskiellosta (AuthorizationConsent), jos asiakas on alaikäinen. Huoltajaa koskeva luovutuskielto on sama tieto kuin Provenance.extension.ProvenanceAuthorizationConsent.extension.AuthorizationConsent -laajennoksessa ilmoitettu tieto.\r\n\r\n2) Tiedon asiakirjan näyttämisen viivästämisen perustelusta (ReasonForRestriction), jos merkinnän toimintakyvystä näyttäminen kansalaiselle on viivästetytty. Tieto on sama kuin Provenance.extension.ProvenanceReleaseForPatientViewing.extension.ReasonForRestriction-laajennoksessa ilmoitettu perustelu.\r\n\r\n3) Tiedon Erityissisältö-tiedon perustelusta (SpecialContent). Tieto on sama kuin Provenance.extension.ProvenanceSpecialContent.extension.ReasonForRestriction-laajennoksessa ilmoitettu perustelu.\r\n\r\nNäiden kolmen tiedon perusteella hakeva järjestelmä päättelee saako toimintakykyarvion näyttää asiakkaalle tai hänen huoltajalleen, jos asiakas on alaikäinen. Toimintakykyarvion näyttämisen säännöt asiakkaalle tai hänen huoltajalleen on kuvattu Kanta-palvelujen käsikirjassa sosiaalihuollon toimijoille luvuissa 5.3 Tilannekohtaiset rajoitukset asiakastietojen näyttämiseen ja 5.4 Lapsen asiakirjojen näyttäminen puolesta-asioivalle huoltajalle. "
    }, {
      "id": "Observation.language",
      "min": 1,
      "path": "Observation.language",
      "short": "Asiakirjan kieli",
      "definition": "Asiakirjan ja siitä generoidun näyttömuodon kieli koodiston arvona."
    }, {
      "id": "Observation.text",
      "min": 1,
      "path": "Observation.text",
      "short": "Asiakirjan tiedot ihmisluettavassa muodossa",
      "definition": "Asiakirjan näyttömuoto, joka sisältää asiakirjan tietosisällön ihmisluettavassa muodossa. Toimintakykyarvion pääprofiilin tulee sisältää tietosisällön näyttömuotoinen esitys."
    }, {
      "id": "Observation.text.status",
      "path": "Observation.text.status",
      "definition": "Sallitut arvot generated, extensions, additional. \r\nArvo empty ei ole sallittu, koska näyttämuoto on Toimintakykyarvio-asiakirjalla pakollinen."
    }, {
      "id": "Observation.text.div",
      "path": "Observation.text.div",
      "short": "Asiakirjan XHTML-muotoinen näyttömuoto",
      "definition": "Toimintakykyarvio -asiakirjan näyttömuotoa koskevat vaatimukset on kuvattu Termeta-palvelussa."
    }, {
      "id": "Observation.extension:functionalAssessmentPurpose",
      "max": "1",
      "path": "Observation.extension",
      "type": [ {
        "code": "Extension",
        "profile": [ "https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalAssessmentPurpose" ]
      } ],
      "sliceName": "functionalAssessmentPurpose",
      "isModifier": false
    }, {
      "id": "Observation.extension:functionalAssessmentPurpose.value[x]",
      "path": "Observation.extension.value[x]",
      "short": "Toimintakykyarvion tarkoitus",
      "definition": "Tieto sisältää tekstimuotoisen kuvauksen siitä, mihin tarkoitukseen toimintakykyarvio laaditaan. Arvio voidaan laatia esimerkiksi päätöksenteon tueksi. Kenttään voidaan myös kirjata, että tarkoituksena on tietyn toimintakyvyn osa-alueen, kuten sosiaalisen toimintakyvyn, arviointi. Toimintakykyä voidaan tarkastella monenlaisista ammatillisista näkökulmista ja moniin eri tarpeisiin ja tarkoituksiin liittyen."
    }, {
      "id": "Observation.extension:functionalAssessmentRelatedNotations",
      "path": "Observation.extension",
      "type": [ {
        "code": "Extension",
        "profile": [ "https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalAssessmentRelatedNotations" ]
      } ],
      "sliceName": "functionalAssessmentRelatedNotations",
      "isModifier": false
    }, {
      "id": "Observation.extension:functionalAssessmentSubjectBackround",
      "max": "1",
      "path": "Observation.extension",
      "type": [ {
        "code": "Extension",
        "profile": [ "https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalAssessmentSubjectBackround" ]
      } ],
      "sliceName": "functionalAssessmentSubjectBackround",
      "isModifier": false
    }, {
      "id": "Observation.extension:functionalAssessmentRelatedDocuments",
      "path": "Observation.extension",
      "type": [ {
        "code": "Extension",
        "profile": [ "https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalAssessmentRelatedDocuments" ]
      } ],
      "sliceName": "functionalAssessmentRelatedDocuments",
      "isModifier": false
    }, {
      "id": "Observation.extension:functionalCapacityOwnEstimation",
      "max": "1",
      "path": "Observation.extension",
      "type": [ {
        "code": "Extension",
        "profile": [ "https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalCapacityOwnEstimation" ]
      } ],
      "sliceName": "functionalCapacityOwnEstimation",
      "isModifier": false
    }, {
      "id": "Observation.identifier",
      "max": "1",
      "min": 1,
      "path": "Observation.identifier",
      "short": "Toimintakykyarvion yksilöivä tunnus organisaatiossa",
      "definition": "Organisaation antama toimintakykyarvion yksilöivä tunnus. Yksilöivän tunnuksen on oltava globaalisti yksilöivä.\r\n\r\nLähettävä järjestelmä voi tuottaa organisaation käyttämän yksilöivän tunnuksen toimintakykyarviolle, jota voidaan hyödyntää esimerkiksi virhetilanteiden selvittämisessä."
    }, {
      "id": "Observation.basedOn",
      "max": "0",
      "path": "Observation.basedOn"
    }, {
      "id": "Observation.partOf",
      "max": "0",
      "path": "Observation.partOf"
    }, {
      "id": "Observation.status",
      "path": "Observation.status",
      "fixedCode": "final"
    }, {
      "id": "Observation.category",
      "max": "0",
      "path": "Observation.category"
    }, {
      "id": "Observation.code",
      "path": "Observation.code",
      "short": "Type of observation (code/type)",
      "binding": {
        "strength": "required",
        "valueSet": "https://gen.kanta.fi/ValueSet/figen-vs-observationcode"
      }
    }, {
      "id": "Observation.code.coding",
      "max": "1",
      "min": 1,
      "path": "Observation.code.coding",
      "short": "Observation typecode"
    }, {
      "id": "Observation.code.coding.system",
      "min": 1,
      "path": "Observation.code.coding.system"
    }, {
      "id": "Observation.code.coding.code",
      "min": 1,
      "path": "Observation.code.coding.code",
      "short": "Toimintakykyarvio",
      "fixedCode": "2"
    }, {
      "id": "Observation.code.coding.display",
      "min": 1,
      "path": "Observation.code.coding.display",
      "fixedString": "Toimintakykyarvio"
    }, {
      "id": "Observation.subject",
      "min": 1,
      "path": "Observation.subject",
      "type": [ {
        "code": "Reference",
        "aggregation": [ "contained" ],
        "targetProfile": [ "https://gen.kanta.fi/fhir/StructureDefinition/KantaPatientV2", "https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationGroup" ]
      } ]
    }, {
      "id": "Observation.subject.reference",
      "min": 1,
      "path": "Observation.subject.reference",
      "short": "Viittaus käytettävään resurssiin"
    }, {
      "id": "Observation.focus",
      "max": "0",
      "path": "Observation.focus",
      "type": [ {
        "code": "Reference",
        "aggregation": [ "contained" ]
      } ]
    }, {
      "id": "Observation.focus.id",
      "max": "0",
      "path": "Observation.focus.id"
    }, {
      "id": "Observation.focus.identifier",
      "max": "0",
      "path": "Observation.focus.identifier"
    }, {
      "id": "Observation.focus.display",
      "max": "0",
      "path": "Observation.focus.display"
    }, {
      "id": "Observation.encounter",
      "max": "0",
      "path": "Observation.encounter"
    }, {
      "id": "Observation.effective[x]",
      "path": "Observation.effective[x]",
      "type": [ {
        "code": "Period"
      } ],
      "short": "Toimintakykyarvion ajanjakso aikavälinä",
      "definition": "Toimintakyvyn arvioinnin ajanjakso aikavälinä. Tietokokonaisuutta käytetään, jos arvioidaan toimintakyvyn muutosta tietyllä aikavälillä."
    }, {
      "id": "Observation.effective[x].extension:functionalAssessmentPeriodDescription",
      "path": "Observation.effective[x].extension",
      "type": [ {
        "code": "Extension",
        "profile": [ "https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalAssessmentPeriodDescription" ]
      } ],
      "sliceName": "functionalAssessmentPeriodDescription",
      "isModifier": false
    }, {
      "id": "Observation.effective[x].start",
      "path": "Observation.effective[x].start",
      "short": "Alkamispäivä",
      "definition": "Toimintakykyvyn arvioinnin alkamispäivä päivämääränä. "
    }, {
      "id": "Observation.effective[x].end",
      "path": "Observation.effective[x].end",
      "short": "Päättymispäivä",
      "definition": "Toimintakyvyn arvioinnin päättymispäivä päivämääränä. "
    }, {
      "id": "Observation.issued",
      "path": "Observation.issued",
      "short": "Toimintakykyarvion laatimispäivämäärä"
    }, {
      "id": "Observation.performer",
      "min": 1,
      "path": "Observation.performer",
      "type": [ {
        "code": "Reference",
        "aggregation": [ "contained" ],
        "targetProfile": [ "https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationPractitionerRole" ]
      } ]
    }, {
      "id": "Observation.performer.reference",
      "min": 1,
      "path": "Observation.performer.reference",
      "short": "viittaus käytettävään resurssiin"
    }, {
      "id": "Observation.value[x]",
      "min": 1,
      "path": "Observation.value[x]",
      "type": [ {
        "code": "string"
      } ],
      "short": "Ammattihenkilön johtopäätökset ja tarvittavat jatkotoimenpiteet",
      "definition": "Tietoon kirjataan ammattihenkilön näkemys ja yhteenveto henkilön toimintakyvystä ja tarvittavista jatkotoimenpiteistä. Tietoon voidaan kirjata myös kokonaisarvio toimintakyvystä silloin, kun ei arvioida toimintakyvyn muutosta. Johtopäätökset voivat sisältää ennusteen toimintakyvyn kehittymisestä interventioilla tai ilman sekä ehdotukset toimintakyvyn ylläpitämiseksi tai parantamiseksi."
    }, {
      "id": "Observation.dataAbsentReason",
      "max": "0",
      "path": "Observation.dataAbsentReason"
    }, {
      "id": "Observation.interpretation",
      "max": "0",
      "path": "Observation.interpretation"
    }, {
      "id": "Observation.note",
      "path": "Observation.note",
      "short": "Toimintakyvyn arviointitilanne",
      "definition": "Tietoon kirjataan kuvaus tilanteesta, jossa ammattihenkilö arvioi henkilön toimintakykyä. Tietoon kirjataan esimerkiksi seuraavat tiedot: milloin ja miten toimintakykyä arvioidaan ja missä sitä arvioidaan. Toimintakykyä voidaan arvioida esimerkiksi henkilön kotona, koulussa, työpaikalla, vuodeosastolla, kuntoutumisen aikana tai sen jälkeen, muiden tukemana, apuvälineiden tuella tai omatoimisesti ilman tukea."
    }, {
      "id": "Observation.bodySite",
      "max": "0",
      "path": "Observation.bodySite"
    }, {
      "id": "Observation.method",
      "max": "0",
      "path": "Observation.method",
      "short": "Toimintakykyhavainnon menetelmä"
    }, {
      "id": "Observation.method.coding",
      "path": "Observation.method.coding",
      "short": "Havainnointimenetelmä"
    }, {
      "id": "Observation.method.coding.id",
      "max": "0",
      "path": "Observation.method.coding.id"
    }, {
      "id": "Observation.method.coding.system",
      "min": 1,
      "path": "Observation.method.coding.system"
    }, {
      "id": "Observation.method.coding.version",
      "max": "0",
      "path": "Observation.method.coding.version"
    }, {
      "id": "Observation.method.coding.code",
      "min": 1,
      "path": "Observation.method.coding.code"
    }, {
      "id": "Observation.method.coding.display",
      "min": 1,
      "path": "Observation.method.coding.display"
    }, {
      "id": "Observation.method.coding.userSelected",
      "max": "0",
      "path": "Observation.method.coding.userSelected"
    }, {
      "id": "Observation.specimen",
      "max": "0",
      "path": "Observation.specimen"
    }, {
      "id": "Observation.device",
      "max": "0",
      "path": "Observation.device"
    }, {
      "id": "Observation.referenceRange",
      "max": "0",
      "path": "Observation.referenceRange"
    }, {
      "id": "Observation.hasMember",
      "path": "Observation.hasMember",
      "type": [ {
        "code": "Reference",
        "aggregation": [ "contained" ],
        "targetProfile": [ "https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationVariation" ]
      } ]
    }, {
      "id": "Observation.hasMember.reference",
      "min": 1,
      "path": "Observation.hasMember.reference",
      "short": "viittaus käytettävään resurssiin"
    }, {
      "id": "Observation.derivedFrom",
      "max": "0",
      "path": "Observation.derivedFrom",
      "type": [ {
        "code": "Reference",
        "aggregation": [ "contained" ],
        "targetProfile": [ "http://hl7.org/fhir/StructureDefinition/Observation" ]
      } ]
    }, {
      "id": "Observation.derivedFrom.id",
      "max": "0",
      "path": "Observation.derivedFrom.id"
    }, {
      "id": "Observation.derivedFrom.reference",
      "min": 1,
      "path": "Observation.derivedFrom.reference",
      "short": "Viittaus arvioon liittyvän toimintakykyhavainnon yksilöivään tunnukseen"
    }, {
      "id": "Observation.derivedFrom.type",
      "max": "0",
      "path": "Observation.derivedFrom.type"
    }, {
      "id": "Observation.component",
      "max": "0",
      "path": "Observation.component"
    } ]
  },
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Observation"
}