Inera Core Implementation Guide
0.2.0 - ci-build
Sweden
Inera Core Implementation Guide - Local Development build (v0.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft as of 2025-11-24 |
{
"resourceType" : "ConceptMap",
"id" : "ConceptMapGetObservationsTKBToObservation",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ConceptMap ConceptMapGetObservationsTKBToObservation</b></p><a name=\"ConceptMapGetObservationsTKBToObservation\"> </a><a name=\"hcConceptMapGetObservationsTKBToObservation\"> </a><p>Mapping from https://rivta.se/domains/clinicalprocess/healthcond/actoutcome/GetObservationsResponder/1 to <a href=\"http://hl7.org/fhir/R4/observation.html\">Observation</a></p><br/><p><b>Group 1 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/actoutcome/GetObservationsResponder/1</code> to <a href=\"http://hl7.org/fhir/R4/bundle.html\">Bundle</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>patientId (Query parameter: Patient ID filter)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Used as search parameter: GET /Observation?subject=Patient/191212121212</td></tr><tr><td>careUnitHSAid (Query parameter: Filter by care unit HSA-ID)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Used as search parameter: GET /Observation?performer.identifier=https://hsaid.se|SE2321000016-A001</td></tr><tr><td>timePeriod (Query parameter: Time period filter (from-to))</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Used as search parameter: GET /Observation?date=ge2025-01-01&date=le2025-12-31</td></tr><tr><td>observationType (Query parameter: Filter by observation type)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Used as search parameter: GET /Observation?code=http://loinc.org|85354-9</td></tr></table><hr/><p><b>Group 2 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/actoutcome/GetObservationsResponder/1</code> to <a href=\"http://hl7.org/fhir/R4/observation.html\">Observation</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>observation.observationHeader.documentId (Observation ID (unique business identifier))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>identifier</td><td>Unique observation identifier within source system. System derived from sourceSystemHSAid.</td></tr><tr><td>observation.observationHeader.patientId (Patient ID (personnummer/samordningsnummer))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>subject</td><td>Reference to Patient with Swedish national identifier. OID 1.2.752.129.2.1.3.1 (personnummer), 1.2.752.129.2.1.3.3 (samordningsnummer)</td></tr><tr><td>observation.observationHeader.approvedForPatient (Approved for patient access (true/false))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>meta.security</td><td>If false, add security label NOPATIENT to restrict patient access (menprövningsflagga).</td></tr><tr><td>observation.observationBody.observationType (Observation type code (LOINC, NPU, SNOMED CT))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code</td><td>Observation code. Preferred: LOINC (http://loinc.org), NPU (http://npu-terminology.org), SNOMED CT (http://snomed.info/sct). Examples: BP 85354-9, HR 8867-4, Temp 8310-5, Weight 29463-7, Height 8302-2</td></tr><tr><td>observation.observationBody.observationType.code (Observation code value)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code.coding.code</td><td>Code value (e.g., LOINC 8867-4 for heart rate)</td></tr><tr><td>observation.observationBody.observationType.codeSystem (Code system OID)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto\" title=\"relatedto\">is related to</a></td><td>code.coding.system</td><td>OID → FHIR URL. LOINC OID 2.16.840.1.113883.6.1 → http://loinc.org, NPU → http://npu-terminology.org, SNOMED CT → http://snomed.info/sct</td></tr><tr><td>observation.observationBody.observationType.displayName (Observation name)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code.coding.display</td><td>Human-readable observation name. Also populate code.text.</td></tr><tr><td>observation.observationBody.observationCategory (Observation category)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>category</td><td>FHIR category: vital-signs, exam, laboratory, procedure, imaging, survey, social-history. System: http://terminology.hl7.org/CodeSystem/observation-category</td></tr><tr><td>observation.observationBody.observationStatus (Observation status)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>status</td><td>FHIR ObservationStatus: registered|preliminary|final|amended|corrected|cancelled|entered-in-error|unknown. Swedish status codes may need mapping.</td></tr><tr><td>observation.observationBody.observationTime (Observation date/time)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>effectiveDateTime</td><td>When observation was made. Use effectiveDateTime for point in time, effectivePeriod for time range.</td></tr><tr><td>observation.observationBody.observationValue.quantity (Observation numeric value with unit)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>valueQuantity</td><td>Numeric value with UCUM unit. valueQuantity.value + valueQuantity.unit + valueQuantity.system (http://unitsofmeasure.org)</td></tr><tr><td>observation.observationBody.observationValue.quantity.value (Numeric value)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>valueQuantity.value</td><td>Numeric measurement value (e.g., 120 for systolic BP)</td></tr><tr><td>observation.observationBody.observationValue.quantity.unit (Unit of measure)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>valueQuantity.unit</td><td>Unit with UCUM code. Examples: mm[Hg] (blood pressure), /min (heart rate), Cel (temperature), kg (weight), cm (height). System: http://unitsofmeasure.org</td></tr><tr><td>observation.observationBody.observationValue.codeableConcept (Coded observation value)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>valueCodeableConcept</td><td>When observation value is coded (e.g., interpretation codes, categorical values)</td></tr><tr><td>observation.observationBody.observationValue.string (Text observation value)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>valueString</td><td>Free text value when no structured value available</td></tr><tr><td>observation.observationBody.interpretation (Observation interpretation (high, low, normal))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>interpretation</td><td>Interpretation codes from http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation: H (high), L (low), N (normal), HH (critically high), LL (critically low)</td></tr><tr><td>observation.observationBody.referenceRange (Reference range (normal values))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>referenceRange</td><td>Normal range for observation. referenceRange.low and referenceRange.high with Quantity values</td></tr><tr><td>observation.observationBody.referenceRange.low (Reference range low value)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>referenceRange.low</td><td>Lower bound of normal range (e.g., 60 /min for heart rate)</td></tr><tr><td>observation.observationBody.referenceRange.high (Reference range high value)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>referenceRange.high</td><td>Upper bound of normal range (e.g., 100 /min for heart rate)</td></tr><tr><td>observation.observationBody.method (Observation method)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>method</td><td>Method used for observation (e.g., auscultation, oscillometric for BP)</td></tr><tr><td>observation.observationBody.bodySite (Body site (anatomical location))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>bodySite</td><td>Anatomical location. Use SNOMED CT body structure codes (e.g., 368209003 for right arm)</td></tr><tr><td>observation.observationHeader.careContactId (Care contact ID (encounter context))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>encounter</td><td>Reference to Encounter when observation made during care contact.</td></tr><tr><td>observation.observationBody.component (Observation components (for panels))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>component</td><td>For panel observations (e.g., blood pressure with systolic/diastolic components). Each component has code and value[x].</td></tr><tr><td>observation.observationBody.hasMember (Related observations (battery/panel))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>hasMember</td><td>References to related Observation resources in a panel/battery (e.g., vital signs panel)</td></tr><tr><td>observation.observationHeader.nullified (Observation nullified flag)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>status</td><td>If nullified=true, set status=entered-in-error. Store nullifiedReason in Provenance.</td></tr></table><hr/><p><b>Group 3 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/actoutcome/GetObservationsResponder/1</code> to <a href=\"http://hl7.org/fhir/R4/provenance.html\">Provenance</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>observation.observationHeader.sourceSystemHSAid (Source system HSA-ID)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>entity.what</td><td>HSA-ID of source system. Also mapped to Observation.meta.source as https://hsaid.se/{HSA-ID}. Provenance.entity.role=source.</td></tr><tr><td>observation.observationHeader.accountableHealthcareProfessional.authorTime (Author time (registration timestamp))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>recorded</td><td>When observation was recorded. Also mapped to Observation.issued.</td></tr><tr><td>observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalHSAid (Healthcare professional HSA-ID)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>agent.who</td><td>Reference to Practitioner with HSA-ID. Provenance.agent.type=author. Also in Observation.performer.</td></tr><tr><td>observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalName (Healthcare professional name)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>agent.who.display</td><td>Display name. Full Practitioner resource should have structured name.</td></tr><tr><td>observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalRoleCode (Healthcare professional role/befattning)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto\" title=\"relatedto\">is related to</a></td><td>agent.role</td><td>Professional role (befattning). Use KV Befattning (OID 1.2.752.129.2.2.1.4).</td></tr><tr><td>observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit (Organization unit)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>agent.onBehalfOf</td><td>Reference to Organization (organizational unit).</td></tr><tr><td>observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalCareUnitHSAid (Care unit HSA-ID (vårdenhet))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>entity.what</td><td>HSA-ID for care unit. Reference to Organization. Part of PDL hierarchy.</td></tr><tr><td>observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalCareGiverHSAid (Care provider HSA-ID (vårdgivare))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>entity.what</td><td>HSA-ID for care provider. Top-level organization in PDL hierarchy.</td></tr><tr><td>observation.observationHeader.legalAuthenticator.signatureTime (Signature timestamp)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>signature.when</td><td>When observation was digitally signed (if applicable).</td></tr><tr><td>observation.observationHeader.legalAuthenticator.legalAuthenticatorHSAid (Legal authenticator HSA-ID)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>signature.who</td><td>Reference to Practitioner who signed observation. Provenance.agent.type=legal.</td></tr><tr><td>observation.observationHeader.nullifiedReason (Reason for nullification)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto\" title=\"relatedto\">is related to</a></td><td>reason</td><td>Why observation was nullified. Store in Provenance.reason when status=entered-in-error.</td></tr></table><hr/><p><b>Group 4 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/actoutcome/GetObservationsResponder/1</code> to <a href=\"http://hl7.org/fhir/R4/bundle.html\">Bundle</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>observation.observationHeader.documentTitle (Document title)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Cardinality 0..0 for GetObservations.</td></tr><tr><td>observation.observationHeader.documentTime (Document time)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Cardinality 0..0 for GetObservations. Use authorTime or observationTime instead.</td></tr><tr><td>result.resultCode (Result code (OK, INFO, ERROR))</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED to resources. HTTP status: OK→200, INFO→200 with warnings, ERROR→4xx/5xx.</td></tr><tr><td>result.errorCode (Error code)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED to resources. Use in OperationOutcome.issue.code when resultCode=ERROR.</td></tr><tr><td>result.logId (Log ID (UUID for troubleshooting))</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED to resources. Use in OperationOutcome.issue.diagnostics or X-Request-Id header.</td></tr><tr><td>result.message (Result message)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED to resources. User-facing message in OperationOutcome.issue.diagnostics.</td></tr></table></div>"
},
"url" : "https://inera.se/fhir/core/ConceptMap/getobservations-tkb-to-observation",
"version" : "0.2.0",
"name" : "ConceptMapGetObservationsTKBToObservation",
"title" : "ConceptMap GetObservations TKB to FHIR Observation",
"status" : "draft",
"experimental" : true,
"date" : "2025-11-24",
"publisher" : "Inera AB",
"contact" : [
{
"name" : "Inera AB",
"telecom" : [
{
"system" : "url",
"value" : "https://www.inera.se"
},
{
"system" : "email",
"value" : "info@inera.se"
}
]
},
{
"name" : "Inera AB",
"telecom" : [
{
"system" : "url",
"value" : "https://www.inera.se"
},
{
"system" : "email",
"value" : "info@inera.se"
}
]
}
],
"description" : "Complete mapping from GetObservations TKB service to FHIR Observation and Provenance resources",
"jurisdiction" : [
{
"coding" : [
{
"system" : "urn:iso:std:iso:3166",
"code" : "SE",
"display" : "Sweden"
}
]
}
],
"sourceUri" : "https://rivta.se/domains/clinicalprocess/healthcond/actoutcome/GetObservationsResponder/1",
"targetCanonical" : "http://hl7.org/fhir/StructureDefinition/Observation",
"group" : [
{
"source" : "https://rivta.se/domains/clinicalprocess/healthcond/actoutcome/GetObservationsResponder/1",
"target" : "http://hl7.org/fhir/StructureDefinition/Bundle",
"element" : [
{
"code" : "patientId",
"display" : "Query parameter: Patient ID filter",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED. Used as search parameter: GET /Observation?subject=Patient/191212121212"
}
]
},
{
"code" : "careUnitHSAid",
"display" : "Query parameter: Filter by care unit HSA-ID",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED. Used as search parameter: GET /Observation?performer.identifier=https://hsaid.se|SE2321000016-A001"
}
]
},
{
"code" : "timePeriod",
"display" : "Query parameter: Time period filter (from-to)",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED. Used as search parameter: GET /Observation?date=ge2025-01-01&date=le2025-12-31"
}
]
},
{
"code" : "observationType",
"display" : "Query parameter: Filter by observation type",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED. Used as search parameter: GET /Observation?code=http://loinc.org|85354-9"
}
]
}
]
},
{
"source" : "https://rivta.se/domains/clinicalprocess/healthcond/actoutcome/GetObservationsResponder/1",
"target" : "http://hl7.org/fhir/StructureDefinition/Observation",
"element" : [
{
"code" : "observation.observationHeader.documentId",
"display" : "Observation ID (unique business identifier)",
"target" : [
{
"code" : "identifier",
"equivalence" : "equivalent",
"comment" : "Unique observation identifier within source system. System derived from sourceSystemHSAid."
}
]
},
{
"code" : "observation.observationHeader.patientId",
"display" : "Patient ID (personnummer/samordningsnummer)",
"target" : [
{
"code" : "subject",
"equivalence" : "equivalent",
"comment" : "Reference to Patient with Swedish national identifier. OID 1.2.752.129.2.1.3.1 (personnummer), 1.2.752.129.2.1.3.3 (samordningsnummer)"
}
]
},
{
"code" : "observation.observationHeader.approvedForPatient",
"display" : "Approved for patient access (true/false)",
"target" : [
{
"code" : "meta.security",
"equivalence" : "equivalent",
"comment" : "If false, add security label NOPATIENT to restrict patient access (menprövningsflagga)."
}
]
},
{
"code" : "observation.observationBody.observationType",
"display" : "Observation type code (LOINC, NPU, SNOMED CT)",
"target" : [
{
"code" : "code",
"equivalence" : "equivalent",
"comment" : "Observation code. Preferred: LOINC (http://loinc.org), NPU (http://npu-terminology.org), SNOMED CT (http://snomed.info/sct). Examples: BP 85354-9, HR 8867-4, Temp 8310-5, Weight 29463-7, Height 8302-2"
}
]
},
{
"code" : "observation.observationBody.observationType.code",
"display" : "Observation code value",
"target" : [
{
"code" : "code.coding.code",
"equivalence" : "equivalent",
"comment" : "Code value (e.g., LOINC 8867-4 for heart rate)"
}
]
},
{
"code" : "observation.observationBody.observationType.codeSystem",
"display" : "Code system OID",
"target" : [
{
"code" : "code.coding.system",
"equivalence" : "relatedto",
"comment" : "OID → FHIR URL. LOINC OID 2.16.840.1.113883.6.1 → http://loinc.org, NPU → http://npu-terminology.org, SNOMED CT → http://snomed.info/sct"
}
]
},
{
"code" : "observation.observationBody.observationType.displayName",
"display" : "Observation name",
"target" : [
{
"code" : "code.coding.display",
"equivalence" : "equivalent",
"comment" : "Human-readable observation name. Also populate code.text."
}
]
},
{
"code" : "observation.observationBody.observationCategory",
"display" : "Observation category",
"target" : [
{
"code" : "category",
"equivalence" : "equivalent",
"comment" : "FHIR category: vital-signs, exam, laboratory, procedure, imaging, survey, social-history. System: http://terminology.hl7.org/CodeSystem/observation-category"
}
]
},
{
"code" : "observation.observationBody.observationStatus",
"display" : "Observation status",
"target" : [
{
"code" : "status",
"equivalence" : "wider",
"comment" : "FHIR ObservationStatus: registered|preliminary|final|amended|corrected|cancelled|entered-in-error|unknown. Swedish status codes may need mapping."
}
]
},
{
"code" : "observation.observationBody.observationTime",
"display" : "Observation date/time",
"target" : [
{
"code" : "effectiveDateTime",
"equivalence" : "equivalent",
"comment" : "When observation was made. Use effectiveDateTime for point in time, effectivePeriod for time range."
}
]
},
{
"code" : "observation.observationBody.observationValue.quantity",
"display" : "Observation numeric value with unit",
"target" : [
{
"code" : "valueQuantity",
"equivalence" : "equivalent",
"comment" : "Numeric value with UCUM unit. valueQuantity.value + valueQuantity.unit + valueQuantity.system (http://unitsofmeasure.org)"
}
]
},
{
"code" : "observation.observationBody.observationValue.quantity.value",
"display" : "Numeric value",
"target" : [
{
"code" : "valueQuantity.value",
"equivalence" : "equivalent",
"comment" : "Numeric measurement value (e.g., 120 for systolic BP)"
}
]
},
{
"code" : "observation.observationBody.observationValue.quantity.unit",
"display" : "Unit of measure",
"target" : [
{
"code" : "valueQuantity.unit",
"equivalence" : "wider",
"comment" : "Unit with UCUM code. Examples: mm[Hg] (blood pressure), /min (heart rate), Cel (temperature), kg (weight), cm (height). System: http://unitsofmeasure.org"
}
]
},
{
"code" : "observation.observationBody.observationValue.codeableConcept",
"display" : "Coded observation value",
"target" : [
{
"code" : "valueCodeableConcept",
"equivalence" : "equivalent",
"comment" : "When observation value is coded (e.g., interpretation codes, categorical values)"
}
]
},
{
"code" : "observation.observationBody.observationValue.string",
"display" : "Text observation value",
"target" : [
{
"code" : "valueString",
"equivalence" : "equivalent",
"comment" : "Free text value when no structured value available"
}
]
},
{
"code" : "observation.observationBody.interpretation",
"display" : "Observation interpretation (high, low, normal)",
"target" : [
{
"code" : "interpretation",
"equivalence" : "equivalent",
"comment" : "Interpretation codes from http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation: H (high), L (low), N (normal), HH (critically high), LL (critically low)"
}
]
},
{
"code" : "observation.observationBody.referenceRange",
"display" : "Reference range (normal values)",
"target" : [
{
"code" : "referenceRange",
"equivalence" : "equivalent",
"comment" : "Normal range for observation. referenceRange.low and referenceRange.high with Quantity values"
}
]
},
{
"code" : "observation.observationBody.referenceRange.low",
"display" : "Reference range low value",
"target" : [
{
"code" : "referenceRange.low",
"equivalence" : "equivalent",
"comment" : "Lower bound of normal range (e.g., 60 /min for heart rate)"
}
]
},
{
"code" : "observation.observationBody.referenceRange.high",
"display" : "Reference range high value",
"target" : [
{
"code" : "referenceRange.high",
"equivalence" : "equivalent",
"comment" : "Upper bound of normal range (e.g., 100 /min for heart rate)"
}
]
},
{
"code" : "observation.observationBody.method",
"display" : "Observation method",
"target" : [
{
"code" : "method",
"equivalence" : "equivalent",
"comment" : "Method used for observation (e.g., auscultation, oscillometric for BP)"
}
]
},
{
"code" : "observation.observationBody.bodySite",
"display" : "Body site (anatomical location)",
"target" : [
{
"code" : "bodySite",
"equivalence" : "equivalent",
"comment" : "Anatomical location. Use SNOMED CT body structure codes (e.g., 368209003 for right arm)"
}
]
},
{
"code" : "observation.observationHeader.careContactId",
"display" : "Care contact ID (encounter context)",
"target" : [
{
"code" : "encounter",
"equivalence" : "equivalent",
"comment" : "Reference to Encounter when observation made during care contact."
}
]
},
{
"code" : "observation.observationBody.component",
"display" : "Observation components (for panels)",
"target" : [
{
"code" : "component",
"equivalence" : "equivalent",
"comment" : "For panel observations (e.g., blood pressure with systolic/diastolic components). Each component has code and value[x]."
}
]
},
{
"code" : "observation.observationBody.hasMember",
"display" : "Related observations (battery/panel)",
"target" : [
{
"code" : "hasMember",
"equivalence" : "equivalent",
"comment" : "References to related Observation resources in a panel/battery (e.g., vital signs panel)"
}
]
},
{
"code" : "observation.observationHeader.nullified",
"display" : "Observation nullified flag",
"target" : [
{
"code" : "status",
"equivalence" : "equivalent",
"comment" : "If nullified=true, set status=entered-in-error. Store nullifiedReason in Provenance."
}
]
}
]
},
{
"source" : "https://rivta.se/domains/clinicalprocess/healthcond/actoutcome/GetObservationsResponder/1",
"target" : "http://hl7.org/fhir/StructureDefinition/Provenance",
"element" : [
{
"code" : "observation.observationHeader.sourceSystemHSAid",
"display" : "Source system HSA-ID",
"target" : [
{
"code" : "entity.what",
"equivalence" : "equivalent",
"comment" : "HSA-ID of source system. Also mapped to Observation.meta.source as https://hsaid.se/{HSA-ID}. Provenance.entity.role=source."
}
]
},
{
"code" : "observation.observationHeader.accountableHealthcareProfessional.authorTime",
"display" : "Author time (registration timestamp)",
"target" : [
{
"code" : "recorded",
"equivalence" : "equivalent",
"comment" : "When observation was recorded. Also mapped to Observation.issued."
}
]
},
{
"code" : "observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalHSAid",
"display" : "Healthcare professional HSA-ID",
"target" : [
{
"code" : "agent.who",
"equivalence" : "equivalent",
"comment" : "Reference to Practitioner with HSA-ID. Provenance.agent.type=author. Also in Observation.performer."
}
]
},
{
"code" : "observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalName",
"display" : "Healthcare professional name",
"target" : [
{
"code" : "agent.who.display",
"equivalence" : "equivalent",
"comment" : "Display name. Full Practitioner resource should have structured name."
}
]
},
{
"code" : "observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalRoleCode",
"display" : "Healthcare professional role/befattning",
"target" : [
{
"code" : "agent.role",
"equivalence" : "relatedto",
"comment" : "Professional role (befattning). Use KV Befattning (OID 1.2.752.129.2.2.1.4)."
}
]
},
{
"code" : "observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit",
"display" : "Organization unit",
"target" : [
{
"code" : "agent.onBehalfOf",
"equivalence" : "equivalent",
"comment" : "Reference to Organization (organizational unit)."
}
]
},
{
"code" : "observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalCareUnitHSAid",
"display" : "Care unit HSA-ID (vårdenhet)",
"target" : [
{
"code" : "entity.what",
"equivalence" : "equivalent",
"comment" : "HSA-ID for care unit. Reference to Organization. Part of PDL hierarchy."
}
]
},
{
"code" : "observation.observationHeader.accountableHealthcareProfessional.healthcareProfessionalCareGiverHSAid",
"display" : "Care provider HSA-ID (vårdgivare)",
"target" : [
{
"code" : "entity.what",
"equivalence" : "equivalent",
"comment" : "HSA-ID for care provider. Top-level organization in PDL hierarchy."
}
]
},
{
"code" : "observation.observationHeader.legalAuthenticator.signatureTime",
"display" : "Signature timestamp",
"target" : [
{
"code" : "signature.when",
"equivalence" : "equivalent",
"comment" : "When observation was digitally signed (if applicable)."
}
]
},
{
"code" : "observation.observationHeader.legalAuthenticator.legalAuthenticatorHSAid",
"display" : "Legal authenticator HSA-ID",
"target" : [
{
"code" : "signature.who",
"equivalence" : "equivalent",
"comment" : "Reference to Practitioner who signed observation. Provenance.agent.type=legal."
}
]
},
{
"code" : "observation.observationHeader.nullifiedReason",
"display" : "Reason for nullification",
"target" : [
{
"code" : "reason",
"equivalence" : "relatedto",
"comment" : "Why observation was nullified. Store in Provenance.reason when status=entered-in-error."
}
]
}
]
},
{
"source" : "https://rivta.se/domains/clinicalprocess/healthcond/actoutcome/GetObservationsResponder/1",
"target" : "http://hl7.org/fhir/StructureDefinition/Bundle",
"element" : [
{
"code" : "observation.observationHeader.documentTitle",
"display" : "Document title",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED. Cardinality 0..0 for GetObservations."
}
]
},
{
"code" : "observation.observationHeader.documentTime",
"display" : "Document time",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED. Cardinality 0..0 for GetObservations. Use authorTime or observationTime instead."
}
]
},
{
"code" : "result.resultCode",
"display" : "Result code (OK, INFO, ERROR)",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED to resources. HTTP status: OK→200, INFO→200 with warnings, ERROR→4xx/5xx."
}
]
},
{
"code" : "result.errorCode",
"display" : "Error code",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED to resources. Use in OperationOutcome.issue.code when resultCode=ERROR."
}
]
},
{
"code" : "result.logId",
"display" : "Log ID (UUID for troubleshooting)",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED to resources. Use in OperationOutcome.issue.diagnostics or X-Request-Id header."
}
]
},
{
"code" : "result.message",
"display" : "Result message",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED to resources. User-facing message in OperationOutcome.issue.diagnostics."
}
]
}
]
}
]
}