<StructureDefinition xmlns="http://hl7.org/fhir">
  <url value="https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationAssessment" />
  <version value="3.0.0" />
  <name value="KantaObservationAssessment" />
  <title value="KantaObservationAssessment" />
  <status value="draft" />
  <date value="2026-04-09" />
  <publisher value="Kela" />
  <description value="Profiili, jota käytetään toimintakykyarvion tallentamiseen Kanta-palveluihin. Toimintakykyarvion tietorakenne on mallinnettu Termeta-palvelussa." />
  <fhirVersion value="4.0.1" />
  <kind value="resource" />
  <abstract value="false" />
  <type value="Observation" />
  <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Observation" />
  <derivation value="constraint" />
  <differential>
    <element id="Observation">
      <path value="Observation" />
      <short value="Toimintakykyarvio" />
      <definition value="Toimintakykyarvio voi koskea tiettyä toimintakyvyn osa-aluetta, kuten fyysistä tai psyykkistä toimintakykyä." />
    </element>
    <element id="Observation.id">
      <path value="Observation.id" />
      <short value="Toimintakykyarvion yksilöivä tunnus" />
      <definition value="Lähettävän järjestelmän tuottama tunnus, joka on voimassa tiedonsiirron ajan" />
      <min value="1" />
    </element>
    <element id="Observation.meta">
      <path value="Observation.meta" />
    </element>
    <element id="Observation.meta.profile">
      <path value="Observation.meta.profile" />
      <min value="1" />
      <max value="1" />
      <fixedCanonical value="https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationAssessment" />
    </element>
    <element id="Observation.meta.security">
      <path value="Observation.meta.security" />
      <short value="Toimintakykyarvion näyttämisen rajoitukset" />
      <definition value="Sosiaalihuollon toimintakykyarvion haussa Kanta-palvelut lisää Observation.meta.security-elementtiin:&#xD;&#xA;&#xD;&#xA;1) 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.&#xD;&#xA;&#xD;&#xA;2) 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.&#xD;&#xA;&#xD;&#xA;3) Tiedon Erityissisältö-tiedon perustelusta (SpecialContent). Tieto on sama kuin Provenance.extension.ProvenanceSpecialContent.extension.ReasonForRestriction-laajennoksessa ilmoitettu perustelu.&#xD;&#xA;&#xD;&#xA;Nä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." />
    </element>
    <element id="Observation.language">
      <path value="Observation.language" />
      <short value="Asiakirjan kieli" />
      <definition value="Asiakirjan ja siitä generoidun näyttömuodon kieli koodiston arvona." />
      <min value="1" />
    </element>
    <element id="Observation.text">
      <path value="Observation.text" />
      <short value="Asiakirjan tiedot ihmisluettavassa muodossa" />
      <definition value="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." />
      <min value="1" />
    </element>
    <element id="Observation.text.status">
      <path value="Observation.text.status" />
      <definition value="Sallitut arvot generated, extensions, additional. &#xD;&#xA;Arvo empty ei ole sallittu, koska näyttämuoto on Toimintakykyarvio-asiakirjalla pakollinen." />
    </element>
    <element id="Observation.text.div">
      <path value="Observation.text.div" />
      <short value="Asiakirjan XHTML-muotoinen näyttömuoto" />
      <definition value="Toimintakykyarvio -asiakirjan näyttömuotoa koskevat vaatimukset on kuvattu Termeta-palvelussa." />
    </element>
    <element id="Observation.extension:functionalAssessmentPurpose">
      <path value="Observation.extension" />
      <sliceName value="functionalAssessmentPurpose" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalAssessmentPurpose" />
      </type>
      <isModifier value="false" />
    </element>
    <element id="Observation.extension:functionalAssessmentPurpose.value[x]">
      <path value="Observation.extension.value[x]" />
      <short value="Toimintakykyarvion tarkoitus" />
      <definition value="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." />
    </element>
    <element id="Observation.extension:functionalAssessmentRelatedNotations">
      <path value="Observation.extension" />
      <sliceName value="functionalAssessmentRelatedNotations" />
      <type>
        <code value="Extension" />
        <profile value="https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalAssessmentRelatedNotations" />
      </type>
      <isModifier value="false" />
    </element>
    <element id="Observation.extension:functionalAssessmentSubjectBackround">
      <path value="Observation.extension" />
      <sliceName value="functionalAssessmentSubjectBackround" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalAssessmentSubjectBackround" />
      </type>
      <isModifier value="false" />
    </element>
    <element id="Observation.extension:functionalAssessmentRelatedDocuments">
      <path value="Observation.extension" />
      <sliceName value="functionalAssessmentRelatedDocuments" />
      <type>
        <code value="Extension" />
        <profile value="https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalAssessmentRelatedDocuments" />
      </type>
      <isModifier value="false" />
    </element>
    <element id="Observation.extension:functionalCapacityOwnEstimation">
      <path value="Observation.extension" />
      <sliceName value="functionalCapacityOwnEstimation" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalCapacityOwnEstimation" />
      </type>
      <isModifier value="false" />
    </element>
    <element id="Observation.identifier">
      <path value="Observation.identifier" />
      <short value="Toimintakykyarvion yksilöivä tunnus organisaatiossa" />
      <definition value="Organisaation antama toimintakykyarvion yksilöivä tunnus. Yksilöivän tunnuksen on oltava globaalisti yksilöivä.&#xD;&#xA;&#xD;&#xA;Lähettävä järjestelmä voi tuottaa organisaation käyttämän yksilöivän tunnuksen toimintakykyarviolle, jota voidaan hyödyntää esimerkiksi virhetilanteiden selvittämisessä." />
      <min value="1" />
      <max value="1" />
    </element>
    <element id="Observation.identifier.system">
      <path value="Observation.identifier.system" />
      <min value="1" />
    </element>
    <element id="Observation.identifier.value">
      <path value="Observation.identifier.value" />
      <min value="1" />
    </element>
    <element id="Observation.basedOn">
      <path value="Observation.basedOn" />
      <max value="0" />
    </element>
    <element id="Observation.partOf">
      <path value="Observation.partOf" />
      <max value="0" />
    </element>
    <element id="Observation.status">
      <path value="Observation.status" />
      <fixedCode value="final" />
    </element>
    <element id="Observation.category">
      <path value="Observation.category" />
      <max value="0" />
    </element>
    <element id="Observation.code">
      <path value="Observation.code" />
      <short value="Type of observation (code/type)" />
      <binding>
        <strength value="required" />
        <valueSet value="https://gen.kanta.fi/ValueSet/figen-vs-observationcode" />
      </binding>
    </element>
    <element id="Observation.code.coding">
      <path value="Observation.code.coding" />
      <short value="Observation typecode" />
      <min value="1" />
      <max value="1" />
    </element>
    <element id="Observation.code.coding.system">
      <path value="Observation.code.coding.system" />
      <min value="1" />
    </element>
    <element id="Observation.code.coding.code">
      <path value="Observation.code.coding.code" />
      <short value="Toimintakykyarvio" />
      <min value="1" />
      <fixedCode value="2" />
    </element>
    <element id="Observation.code.coding.display">
      <path value="Observation.code.coding.display" />
      <min value="1" />
      <fixedString value="Toimintakykyarvio" />
    </element>
    <element id="Observation.subject">
      <path value="Observation.subject" />
      <min value="1" />
      <type>
        <code value="Reference" />
        <targetProfile value="https://gen.kanta.fi/fhir/StructureDefinition/KantaPatientV2" />
        <aggregation value="contained" />
      </type>
    </element>
    <element id="Observation.subject.reference">
      <path value="Observation.subject.reference" />
      <short value="Viittaus käytettävään resurssiin" />
      <min value="1" />
    </element>
    <element id="Observation.focus">
      <path value="Observation.focus" />
      <max value="0" />
      <type>
        <code value="Reference" />
        <aggregation value="contained" />
      </type>
    </element>
    <element id="Observation.focus.id">
      <path value="Observation.focus.id" />
      <max value="0" />
    </element>
    <element id="Observation.focus.identifier">
      <path value="Observation.focus.identifier" />
      <max value="0" />
    </element>
    <element id="Observation.focus.display">
      <path value="Observation.focus.display" />
      <max value="0" />
    </element>
    <element id="Observation.encounter">
      <path value="Observation.encounter" />
      <max value="0" />
    </element>
    <element id="Observation.effective[x]">
      <path value="Observation.effective[x]" />
      <short value="Toimintakykyarvion ajanjakso aikavälinä" />
      <definition value="Toimintakyvyn arvioinnin ajanjakso aikavälinä. Tietokokonaisuutta käytetään, jos arvioidaan toimintakyvyn muutosta tietyllä aikavälillä." />
      <type>
        <code value="Period" />
      </type>
    </element>
    <element id="Observation.effective[x].extension:functionalAssessmentPeriodDescription">
      <path value="Observation.effective[x].extension" />
      <sliceName value="functionalAssessmentPeriodDescription" />
      <type>
        <code value="Extension" />
        <profile value="https://gen.kanta.fi/fhir/StructureDefinition/extension/FunctionalAssessmentPeriodDescription" />
      </type>
      <isModifier value="false" />
    </element>
    <element id="Observation.effective[x].start">
      <path value="Observation.effective[x].start" />
      <short value="Alkamispäivä" />
      <definition value="Toimintakykyvyn arvioinnin alkamispäivä päivämääränä." />
      <min value="1" />
    </element>
    <element id="Observation.effective[x].end">
      <path value="Observation.effective[x].end" />
      <short value="Päättymispäivä" />
      <definition value="Toimintakyvyn arvioinnin päättymispäivä päivämääränä." />
      <min value="1" />
    </element>
    <element id="Observation.issued">
      <path value="Observation.issued" />
      <short value="Toimintakykyarvion laatimispäivämäärä" />
    </element>
    <element id="Observation.performer">
      <path value="Observation.performer" />
      <min value="1" />
      <type>
        <code value="Reference" />
        <targetProfile value="https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationPractitionerRole" />
        <aggregation value="contained" />
      </type>
    </element>
    <element id="Observation.performer.reference">
      <path value="Observation.performer.reference" />
      <short value="viittaus käytettävään resurssiin" />
      <min value="1" />
    </element>
    <element id="Observation.value[x]">
      <path value="Observation.value[x]" />
      <short value="Ammattihenkilön johtopäätökset ja tarvittavat jatkotoimenpiteet" />
      <definition value="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." />
      <min value="1" />
      <type>
        <code value="string" />
      </type>
    </element>
    <element id="Observation.dataAbsentReason">
      <path value="Observation.dataAbsentReason" />
      <max value="0" />
    </element>
    <element id="Observation.interpretation">
      <path value="Observation.interpretation" />
      <max value="0" />
    </element>
    <element id="Observation.note">
      <path value="Observation.note" />
      <short value="Toimintakyvyn arviointitilanne" />
      <definition value="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." />
    </element>
    <element id="Observation.bodySite">
      <path value="Observation.bodySite" />
      <max value="0" />
    </element>
    <element id="Observation.method">
      <path value="Observation.method" />
      <short value="Toimintakykyhavainnon menetelmä" />
      <max value="0" />
    </element>
    <element id="Observation.method.coding">
      <path value="Observation.method.coding" />
      <short value="Havainnointimenetelmä" />
    </element>
    <element id="Observation.method.coding.id">
      <path value="Observation.method.coding.id" />
      <max value="0" />
    </element>
    <element id="Observation.method.coding.system">
      <path value="Observation.method.coding.system" />
      <min value="1" />
    </element>
    <element id="Observation.method.coding.version">
      <path value="Observation.method.coding.version" />
      <max value="0" />
    </element>
    <element id="Observation.method.coding.code">
      <path value="Observation.method.coding.code" />
      <min value="1" />
    </element>
    <element id="Observation.method.coding.display">
      <path value="Observation.method.coding.display" />
      <min value="1" />
    </element>
    <element id="Observation.method.coding.userSelected">
      <path value="Observation.method.coding.userSelected" />
      <max value="0" />
    </element>
    <element id="Observation.specimen">
      <path value="Observation.specimen" />
      <max value="0" />
    </element>
    <element id="Observation.device">
      <path value="Observation.device" />
      <max value="0" />
    </element>
    <element id="Observation.referenceRange">
      <path value="Observation.referenceRange" />
      <max value="0" />
    </element>
    <element id="Observation.hasMember">
      <path value="Observation.hasMember" />
      <type>
        <code value="Reference" />
        <targetProfile value="https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationVariation" />
        <aggregation value="contained" />
      </type>
    </element>
    <element id="Observation.hasMember.reference">
      <path value="Observation.hasMember.reference" />
      <short value="viittaus käytettävään resurssiin" />
      <min value="1" />
    </element>
    <element id="Observation.derivedFrom">
      <path value="Observation.derivedFrom" />
      <max value="0" />
      <type>
        <code value="Reference" />
        <targetProfile value="http://hl7.org/fhir/StructureDefinition/Observation" />
        <aggregation value="contained" />
      </type>
    </element>
    <element id="Observation.derivedFrom.id">
      <path value="Observation.derivedFrom.id" />
      <max value="0" />
    </element>
    <element id="Observation.derivedFrom.reference">
      <path value="Observation.derivedFrom.reference" />
      <short value="Viittaus arvioon liittyvän toimintakykyhavainnon yksilöivään tunnukseen" />
      <min value="1" />
    </element>
    <element id="Observation.derivedFrom.type">
      <path value="Observation.derivedFrom.type" />
      <max value="0" />
    </element>
    <element id="Observation.component">
      <path value="Observation.component" />
      <max value="0" />
    </element>
  </differential>
</StructureDefinition>