{
  "description": "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.",
  "_filename": "KantaObservationNotation.StructureDefinition.json",
  "package_name": "fi.kela.kanta.gen.r4.toimintakyky",
  "date": "2025-11-18",
  "derivation": "constraint",
  "publisher": "Kela",
  "fhirVersion": "4.0.1",
  "name": "KantaObservationNotation",
  "abstract": false,
  "type": "Observation",
  "experimental": null,
  "resourceType": "StructureDefinition",
  "title": "Kanta Observation Notation",
  "package_version": "1.0.0-rc3",
  "status": "draft",
  "id": "3af9515b-a065-4a8d-b456-416e4ba769db",
  "kind": "resource",
  "url": "https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationNotation",
  "version": "1.1.0",
  "differential": {
    "element": [ {
      "id": "Observation",
      "path": "Observation",
      "short": "Merkintä toimintakyvystä",
      "definition": "Kertomusmerkintä, johon on kirjattu havaintoja sosiaali- tai terveydenhuollon asiakkaan toimintakyvystä."
    }, {
      "id": "Observation.id",
      "min": 1,
      "path": "Observation.id",
      "short": "Toimintakykymerkinnän yksilöivä tunnus",
      "definition": "Toimintakykymerkinnän globaalisti yksilöivä tunnus. Lähettävän järjestelmän on tuottama tieto, 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/KantaObservationNotation"
    }, {
      "id": "Observation.meta.security",
      "path": "Observation.meta.security",
      "short": "Merkinnän toimintakyvystä näyttämisen rajoitukset",
      "definition": "Sosiaalihuollon merkinnän toimintakyvyn 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 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. "
    }, {
      "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. Tallennettavan Merkintä toimintakyvystä -asiakirjan 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 merkintä toimintakyvystä-asiakirjalla pakollinen."
    }, {
      "id": "Observation.text.div",
      "path": "Observation.text.div",
      "short": "Asiakirjan XHTML-muotoinen näyttömuoto",
      "definition": "Merkintä toimintakyvystä -asiakirjan näyttömuotoa koskevat vaatimukset on kuvattu Termeta-palvelussa."
    }, {
      "id": "Observation.extension:observationPlace",
      "path": "Observation.extension",
      "type": [ {
        "code": "Extension",
        "profile": [ "https://gen.kanta.fi/fhir/StructureDefinition/extension/ObservationPlace" ]
      } ],
      "sliceName": "observationPlace",
      "isModifier": false
    }, {
      "id": "Observation.extension:observationPlace.value[x].text",
      "path": "Observation.extension.value[x].text",
      "definition": "lisätietoja havainnointipaikasta ja kuvataan luokituksesta valittua luokkaa tarkemmin. Lisätietoja annetaan erityisesti silloin, kun luokituksesta on valittu luokka \"Muu\"."
    }, {
      "id": "Observation.identifier",
      "max": "1",
      "min": 1,
      "path": "Observation.identifier",
      "short": "Merkinnän toimintakyvystä yksilöivä tunnus organisaatiossa",
      "definition": "Organisaation antama merkinnän toimintakyvystä 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 merkinnälle toimintakyvystä, 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",
      "binding": {
        "strength": "required",
        "valueSet": "https://gen.kanta.fi/ValueSet/figen-vs-observationcode",
        "description": "Toimintakykytiedon ilmaiseva koodi"
      }
    }, {
      "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": "Toimintakykymerkintä",
      "fixedCode": "1"
    }, {
      "id": "Observation.code.coding.display",
      "min": 1,
      "path": "Observation.code.coding.display",
      "short": "Toimintakykymerkintä tietojen Observation-profiili",
      "fixedString": "Toimintakykymerkintä"
    }, {
      "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" ]
      } ],
      "short": "Henkilö tai henkilöt",
      "definition": "Toimintakykymerkinnän kohteena olevan henkilön tai henkilöiden tiedot."
    }, {
      "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"
    }, {
      "id": "Observation.encounter",
      "max": "0",
      "path": "Observation.encounter"
    }, {
      "id": "Observation.effective[x]",
      "min": 1,
      "path": "Observation.effective[x]",
      "type": [ {
        "code": "dateTime"
      } ],
      "short": "Toimintakyvyn havainnointipäivämäärä",
      "definition": "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."
    }, {
      "id": "Observation.issued",
      "path": "Observation.issued",
      "short": "Toimintakykymerkinnän laatimispäivä"
    }, {
      "id": "Observation.performer",
      "min": 1,
      "path": "Observation.performer",
      "type": [ {
        "code": "Reference",
        "aggregation": [ "contained" ],
        "targetProfile": [ "https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationPractitionerRole" ]
      } ],
      "short": "Toimintakykymerkinnän laatijan tiedot"
    }, {
      "id": "Observation.performer.reference",
      "min": 1,
      "path": "Observation.performer.reference",
      "short": "Viittaus käytettävään resurssiin"
    }, {
      "id": "Observation.performer.identifier.type.coding.id",
      "max": "0",
      "path": "Observation.performer.identifier.type.coding.id"
    }, {
      "id": "Observation.performer.identifier.type.coding.system",
      "min": 1,
      "path": "Observation.performer.identifier.type.coding.system"
    }, {
      "id": "Observation.performer.identifier.type.coding.display",
      "min": 1,
      "path": "Observation.performer.identifier.type.coding.display",
      "short": "Asiakirjan laatinut ammattihenkilö",
      "definition": "Ammattihenkilö, joka on laatinut asiakirjan"
    }, {
      "id": "Observation.performer.identifier.system",
      "min": 1,
      "path": "Observation.performer.identifier.system"
    }, {
      "id": "Observation.performer.identifier.period",
      "max": "0",
      "path": "Observation.performer.identifier.period"
    }, {
      "id": "Observation.value[x]",
      "max": "0",
      "path": "Observation.value[x]"
    }, {
      "id": "Observation.dataAbsentReason",
      "max": "0",
      "path": "Observation.dataAbsentReason"
    }, {
      "id": "Observation.interpretation",
      "max": "0",
      "path": "Observation.interpretation"
    }, {
      "id": "Observation.bodySite",
      "max": "0",
      "path": "Observation.bodySite"
    }, {
      "id": "Observation.method",
      "max": "0",
      "path": "Observation.method"
    }, {
      "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",
      "min": 1,
      "path": "Observation.hasMember",
      "type": [ {
        "code": "Reference",
        "aggregation": [ "contained" ],
        "targetProfile": [ "https://gen.kanta.fi/fhir/StructureDefinition/KantaObservationObservation" ]
      } ]
    }, {
      "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"
    }, {
      "id": "Observation.component",
      "max": "0",
      "path": "Observation.component"
    }, {
      "id": "Observation.component.dataAbsentReason",
      "max": "0",
      "path": "Observation.component.dataAbsentReason"
    }, {
      "id": "Observation.component.interpretation",
      "max": "0",
      "path": "Observation.component.interpretation"
    }, {
      "id": "Observation.component.referenceRange",
      "max": "0",
      "path": "Observation.component.referenceRange"
    } ]
  },
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Observation"
}