<StructureDefinition xmlns="http://hl7.org/fhir">
  <url value="https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationNotation" />
  <version value="2.0.0" />
  <name value="KantaObservationNotation" />
  <title value="Kanta Observation Notation" />
  <status value="draft" />
  <date value="2026-04-09" />
  <publisher value="Kela" />
  <description value="Profiili, jota käytetään merkinnän toimintakyvystä tallentamiseen Kanta-palveluihin. Merkintään on kirjattu havaintoja sosiaali- tai terveydenhuollon asiakkaan toimintakyvystä. Merkinnän toimintakyvystä 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="Merkintä toimintakyvystä" />
      <definition value="Kertomusmerkintä, johon on kirjattu havaintoja sosiaali- tai terveydenhuollon asiakkaan toimintakyvystä." />
    </element>
    <element id="Observation.id">
      <path value="Observation.id" />
      <short value="Toimintakykymerkinnän yksilöivä tunnus" />
      <definition value="Toimintakykymerkinnän globaalisti yksilöivä tunnus. Lähettävän järjestelmän on tuottama tieto, 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/KantaObservationNotation" />
    </element>
    <element id="Observation.meta.security">
      <path value="Observation.meta.security" />
      <short value="Merkinnän toimintakyvystä näyttämisen rajoitukset" />
      <definition value="Sosiaalihuollon merkinnän toimintakyvyn 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 merkintää toimintakyvystä näyttää asiakkaalle tai hänen huoltajalleen, jos asiakas on alaikäinen. Merkinnän toimintakyvystä 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. Tallennettavan Merkintä toimintakyvystä -asiakirjan 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 merkintä toimintakyvystä-asiakirjalla pakollinen." />
    </element>
    <element id="Observation.text.div">
      <path value="Observation.text.div" />
      <short value="Asiakirjan XHTML-muotoinen näyttömuoto" />
      <definition value="Merkintä toimintakyvystä -asiakirjan näyttömuotoa koskevat vaatimukset on kuvattu Termeta-palvelussa." />
    </element>
    <element id="Observation.extension:observationPlace">
      <path value="Observation.extension" />
      <sliceName value="observationPlace" />
      <type>
        <code value="Extension" />
        <profile value="https://gen.kanta.fi/fhir/StructureDefinition/extension/ObservationPlace" />
      </type>
      <isModifier value="false" />
    </element>
    <element id="Observation.extension:observationPlace.value[x].text">
      <path value="Observation.extension.value[x].text" />
      <definition value="lisätietoja havainnointipaikasta ja kuvataan luokituksesta valittua luokkaa tarkemmin. Lisätietoja annetaan erityisesti silloin, kun luokituksesta on valittu luokka &quot;Muu&quot;." />
    </element>
    <element id="Observation.identifier">
      <path value="Observation.identifier" />
      <short value="Merkinnän toimintakyvystä yksilöivä tunnus organisaatiossa" />
      <definition value="Organisaation antama merkinnän toimintakyvystä 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 merkinnälle toimintakyvystä, 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" />
      <binding>
        <strength value="required" />
        <description value="Toimintakykytiedon ilmaiseva koodi" />
        <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="Toimintakykymerkintä" />
      <min value="1" />
      <fixedCode value="1" />
    </element>
    <element id="Observation.code.coding.display">
      <path value="Observation.code.coding.display" />
      <short value="Toimintakykymerkintä tietojen Observation-profiili" />
      <min value="1" />
      <fixedString value="Toimintakykymerkintä" />
    </element>
    <element id="Observation.subject">
      <path value="Observation.subject" />
      <short value="Henkilö" />
      <definition value="Toimintakykymerkinnän kohteena olevan henkilön tiedot." />
      <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" />
    </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="Toimintakyvyn havainnointipäivämäärä" />
      <definition value="Tietoon kirjataan päivämäärä, jolloin henkilön toimintakykyä on havainnoitu. Havainnointiajankohta ei ole välttämättä sama kuin toimintakykytiedon tai -havainnon kirjaamisen ajankohta." />
      <min value="1" />
      <type>
        <code value="dateTime" />
      </type>
    </element>
    <element id="Observation.issued">
      <path value="Observation.issued" />
      <short value="Toimintakykymerkinnän laatimispäivä" />
    </element>
    <element id="Observation.performer">
      <path value="Observation.performer" />
      <short value="Toimintakykymerkinnän laatijan tiedot" />
      <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.performer.identifier.type.coding.id">
      <path value="Observation.performer.identifier.type.coding.id" />
      <max value="0" />
    </element>
    <element id="Observation.performer.identifier.type.coding.system">
      <path value="Observation.performer.identifier.type.coding.system" />
      <min value="1" />
    </element>
    <element id="Observation.performer.identifier.type.coding.display">
      <path value="Observation.performer.identifier.type.coding.display" />
      <short value="Asiakirjan laatinut ammattihenkilö" />
      <definition value="Ammattihenkilö, joka on laatinut asiakirjan" />
      <min value="1" />
    </element>
    <element id="Observation.performer.identifier.system">
      <path value="Observation.performer.identifier.system" />
      <min value="1" />
    </element>
    <element id="Observation.performer.identifier.period">
      <path value="Observation.performer.identifier.period" />
      <max value="0" />
    </element>
    <element id="Observation.value[x]">
      <path value="Observation.value[x]" />
      <max value="0" />
    </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.bodySite">
      <path value="Observation.bodySite" />
      <max value="0" />
    </element>
    <element id="Observation.method">
      <path value="Observation.method" />
      <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" />
      <min value="1" />
      <type>
        <code value="Reference" />
        <targetProfile value="https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationObservation" />
        <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" />
    </element>
    <element id="Observation.component">
      <path value="Observation.component" />
      <max value="0" />
    </element>
    <element id="Observation.component.dataAbsentReason">
      <path value="Observation.component.dataAbsentReason" />
      <max value="0" />
    </element>
    <element id="Observation.component.interpretation">
      <path value="Observation.component.interpretation" />
      <max value="0" />
    </element>
    <element id="Observation.component.referenceRange">
      <path value="Observation.component.referenceRange" />
      <max value="0" />
    </element>
  </differential>
</StructureDefinition>