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" : "ConceptMapGetCareDocumentationTKBToDocumentReference",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ConceptMap ConceptMapGetCareDocumentationTKBToDocumentReference</b></p><a name=\"ConceptMapGetCareDocumentationTKBToDocumentReference\"> </a><a name=\"hcConceptMapGetCareDocumentationTKBToDocumentReference\"> </a><p>Mapping from https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2 to <a href=\"http://hl7.org/fhir/R4/documentreference.html\">DocumentReference</a></p><br/><p><b>Group 1 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2</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 /DocumentReference?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 /DocumentReference?custodian.identifier=https://hsaid.se|SE2321000016-A001</td></tr><tr><td>sourceSystemHSAid (Query parameter: Filter by source system)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Used as search parameter or routing to specific system</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 /DocumentReference?date=ge2025-01-01&date=le2025-12-31</td></tr><tr><td>careContactId (Query parameter: Filter by specific care contact)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Used as search parameter: GET /DocumentReference?encounter=Encounter/{id}</td></tr></table><hr/><p><b>Group 2 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2</code> to <a href=\"http://hl7.org/fhir/R4/documentreference.html\">DocumentReference</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>careDocumentation.careDocumentationHeader.documentId (Document 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 document identifier within source system. Must be persistent across TKB versions. System derived from sourceSystemHSAid.</td></tr><tr><td>careDocumentation.careDocumentationHeader.patientId (Patient ID (personnummer/samordningsnummer/reservnummer))</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>careDocumentation.careDocumentationHeader.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). See tkb-header-mapping documentation.</td></tr><tr><td>careDocumentation.careDocumentationBody.documentType (Document type code (vårdkontaktanteckning, läkarintyg, etc.))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>type</td><td>Swedish document type. Use LOINC document codes or Swedish national codes. Examples: 11506-3 (progress note), 18842-5 (discharge summary), 57133-1 (referral note)</td></tr><tr><td>careDocumentation.careDocumentationBody.documentCategory (Document category (high-level classification))</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>High-level category. Use US Core categories: clinical-note, summary-of-episode-note, discharge-summary, etc.</td></tr><tr><td>careDocumentation.careDocumentationBody.documentStatus (Document status (preliminary, final, amended, entered-in-error))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto\" title=\"relatedto\">is related to</a></td><td>status</td><td>Maps to DocumentReference.status (current|superseded|entered-in-error) and docStatus (preliminary|final|amended|corrected|appended)</td></tr><tr><td>careDocumentation.careDocumentationBody.documentTitle (Document title/description)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>description</td><td>Human-readable title. Also used in Composition.title.</td></tr><tr><td>careDocumentation.careDocumentationHeader.documentTime (Document creation timestamp)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>date</td><td>When document was created/indexed. Note: TKB may use authorTime instead for some documents.</td></tr><tr><td>careDocumentation.careDocumentationHeader.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>context.encounter</td><td>Reference to Encounter resource. Links document to care contact.</td></tr><tr><td>careDocumentation.careDocumentationBody.content (Document content (binary or referenced))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>content.attachment</td><td>For unstructured content (PDF, XHTML, XML): use attachment.data (base64) or attachment.url. Set contentType (application/pdf, text/html, etc.)</td></tr><tr><td>careDocumentation.careDocumentationBody.format (Document format code)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>content.format</td><td>Format code from http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem or Swedish format codes</td></tr><tr><td>careDocumentation.careDocumentationBody.mimeType (MIME type (application/pdf, text/html, etc.))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>content.attachment.contentType</td><td>MIME type: application/pdf, text/html, application/fhir+xml, application/fhir+json, etc.</td></tr><tr><td>careDocumentation.careDocumentationHeader.nullified (Document 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. Use Provenance resource to capture nullifiedReason.</td></tr><tr><td>careDocumentation.careDocumentationHeader.nullifiedReason (Reason for nullification)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Provenance.reason</td><td>Reason for nullification/retraction. Map to Provenance resource with activity=DELETE or UPDATE, reason containing the nullification reason text.</td></tr></table><hr/><p><b>Group 3 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2</code> to <a href=\"http://hl7.org/fhir/R4/composition.html\">Composition</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>careDocumentation.careDocumentationHeader.documentId (Document ID)</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>Same identifier as DocumentReference for linking</td></tr><tr><td>careDocumentation.careDocumentationBody.documentStatus (Composition status)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto\" title=\"relatedto\">is related to</a></td><td>status</td><td>Composition.status: preliminary|final|amended|entered-in-error. Maps from TKB documentStatus.</td></tr><tr><td>careDocumentation.careDocumentationBody.documentType (Composition type)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>type</td><td>Same type code as DocumentReference.type. LOINC or Swedish document type codes.</td></tr><tr><td>careDocumentation.careDocumentationBody.documentCategory (Composition 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>High-level categorization matching DocumentReference.category</td></tr><tr><td>careDocumentation.careDocumentationHeader.patientId (Patient ID)</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 resource</td></tr><tr><td>careDocumentation.careDocumentationHeader.careContactId (Care contact/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 document created during care contact</td></tr><tr><td>careDocumentation.careDocumentationHeader.documentTime (Composition date)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>date</td><td>Composition edit/change time. May differ from authorTime.</td></tr><tr><td>careDocumentation.careDocumentationHeader.accountableHealthcareProfessional (Document author (healthcare professional))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>author</td><td>Reference to Practitioner. Can have multiple authors. Also mapped to Provenance for full metadata.</td></tr><tr><td>careDocumentation.careDocumentationBody.documentTitle (Composition title)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>title</td><td>Human-readable document title</td></tr><tr><td>careDocumentation.careDocumentationHeader.legalAuthenticator (Legal authenticator (attester))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>attester</td><td>Composition.attester with mode=#legal, time=signatureTime, party=Reference(Practitioner). Also creates Provenance.signature.</td></tr><tr><td>careDocumentation.careDocumentationBody.custodian (Document custodian (care provider organization))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>custodian</td><td>Reference to Organization (vårdgivare) responsible for document</td></tr><tr><td>careDocumentation.careDocumentationBody.section (Document sections (reason for visit, assessment, plan, etc.))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>section</td><td>Composition.section with code, title, text (narrative), and entry (references to resources). Common LOINC section codes: 10154-3 (chief complaint), 10164-2 (history), 29545-1 (physical exam), 51847-2 (assessment), 18776-5 (plan)</td></tr></table><hr/><p><b>Group 4 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2</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>careDocumentation.careDocumentationHeader.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 DocumentReference.meta.source as https://hsaid.se/{HSA-ID}. Provenance.entity.role=source.</td></tr><tr><td>careDocumentation.careDocumentationHeader.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 document information was recorded. Also mapped to DocumentReference.meta.lastUpdated.</td></tr><tr><td>careDocumentation.careDocumentationHeader.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 Composition.author and DocumentReference.author.</td></tr><tr><td>careDocumentation.careDocumentationHeader.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>careDocumentation.careDocumentationHeader.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). Map to Provenance.agent.role or store in Practitioner.qualification.</td></tr><tr><td>careDocumentation.careDocumentationHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit (Organization unit (where professional works))</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). Full details (HSA-ID, name, telecom, address, location) in Organization resource.</td></tr><tr><td>careDocumentation.careDocumentationHeader.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. Also in DocumentReference.custodian.</td></tr><tr><td>careDocumentation.careDocumentationHeader.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. Reference to Organization.</td></tr><tr><td>careDocumentation.careDocumentationHeader.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 document was digitally signed. Also in Composition.attester.time.</td></tr><tr><td>careDocumentation.careDocumentationHeader.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 document. Provenance.agent.type=legal.</td></tr><tr><td>careDocumentation.careDocumentationHeader.legalAuthenticator.signatureData (Digital signature (cryptographic))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>signature.data</td><td>Base64 encoded signature. Set sigFormat (application/jose, application/xmldsig+xml, etc.). Type code: 1.2.840.10065.1.12.1.1 (Author's Signature)</td></tr></table><hr/><p><b>Group 5 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2</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>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. Bundle-level OperationOutcome for details.</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/getcaredocumentation-tkb-to-documentreference",
"version" : "0.2.0",
"name" : "ConceptMapGetCareDocumentationTKBToDocumentReference",
"title" : "ConceptMap GetCareDocumentation TKB to FHIR DocumentReference/Composition",
"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 GetCareDocumentation TKB service to FHIR DocumentReference, Composition, and Provenance resources",
"jurisdiction" : [
{
"coding" : [
{
"system" : "urn:iso:std:iso:3166",
"code" : "SE",
"display" : "Sweden"
}
]
}
],
"sourceUri" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2",
"targetCanonical" : "http://hl7.org/fhir/StructureDefinition/DocumentReference",
"group" : [
{
"source" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2",
"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 /DocumentReference?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 /DocumentReference?custodian.identifier=https://hsaid.se|SE2321000016-A001"
}
]
},
{
"code" : "sourceSystemHSAid",
"display" : "Query parameter: Filter by source system",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED. Used as search parameter or routing to specific system"
}
]
},
{
"code" : "timePeriod",
"display" : "Query parameter: Time period filter (from-to)",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED. Used as search parameter: GET /DocumentReference?date=ge2025-01-01&date=le2025-12-31"
}
]
},
{
"code" : "careContactId",
"display" : "Query parameter: Filter by specific care contact",
"target" : [
{
"equivalence" : "unmatched",
"comment" : "NOT MAPPED. Used as search parameter: GET /DocumentReference?encounter=Encounter/{id}"
}
]
}
]
},
{
"source" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2",
"target" : "http://hl7.org/fhir/StructureDefinition/DocumentReference",
"element" : [
{
"code" : "careDocumentation.careDocumentationHeader.documentId",
"display" : "Document ID (unique business identifier)",
"target" : [
{
"code" : "identifier",
"equivalence" : "equivalent",
"comment" : "Unique document identifier within source system. Must be persistent across TKB versions. System derived from sourceSystemHSAid."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.patientId",
"display" : "Patient ID (personnummer/samordningsnummer/reservnummer)",
"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" : "careDocumentation.careDocumentationHeader.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). See tkb-header-mapping documentation."
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.documentType",
"display" : "Document type code (vårdkontaktanteckning, läkarintyg, etc.)",
"target" : [
{
"code" : "type",
"equivalence" : "equivalent",
"comment" : "Swedish document type. Use LOINC document codes or Swedish national codes. Examples: 11506-3 (progress note), 18842-5 (discharge summary), 57133-1 (referral note)"
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.documentCategory",
"display" : "Document category (high-level classification)",
"target" : [
{
"code" : "category",
"equivalence" : "equivalent",
"comment" : "High-level category. Use US Core categories: clinical-note, summary-of-episode-note, discharge-summary, etc."
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.documentStatus",
"display" : "Document status (preliminary, final, amended, entered-in-error)",
"target" : [
{
"code" : "status",
"equivalence" : "relatedto",
"comment" : "Maps to DocumentReference.status (current|superseded|entered-in-error) and docStatus (preliminary|final|amended|corrected|appended)"
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.documentTitle",
"display" : "Document title/description",
"target" : [
{
"code" : "description",
"equivalence" : "equivalent",
"comment" : "Human-readable title. Also used in Composition.title."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.documentTime",
"display" : "Document creation timestamp",
"target" : [
{
"code" : "date",
"equivalence" : "equivalent",
"comment" : "When document was created/indexed. Note: TKB may use authorTime instead for some documents."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.careContactId",
"display" : "Care contact ID (encounter context)",
"target" : [
{
"code" : "context.encounter",
"equivalence" : "equivalent",
"comment" : "Reference to Encounter resource. Links document to care contact."
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.content",
"display" : "Document content (binary or referenced)",
"target" : [
{
"code" : "content.attachment",
"equivalence" : "equivalent",
"comment" : "For unstructured content (PDF, XHTML, XML): use attachment.data (base64) or attachment.url. Set contentType (application/pdf, text/html, etc.)"
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.format",
"display" : "Document format code",
"target" : [
{
"code" : "content.format",
"equivalence" : "equivalent",
"comment" : "Format code from http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem or Swedish format codes"
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.mimeType",
"display" : "MIME type (application/pdf, text/html, etc.)",
"target" : [
{
"code" : "content.attachment.contentType",
"equivalence" : "equivalent",
"comment" : "MIME type: application/pdf, text/html, application/fhir+xml, application/fhir+json, etc."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.nullified",
"display" : "Document nullified flag",
"target" : [
{
"code" : "status",
"equivalence" : "equivalent",
"comment" : "If nullified=true, set status=entered-in-error. Use Provenance resource to capture nullifiedReason."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.nullifiedReason",
"display" : "Reason for nullification",
"target" : [
{
"code" : "Provenance.reason",
"equivalence" : "equivalent",
"comment" : "Reason for nullification/retraction. Map to Provenance resource with activity=DELETE or UPDATE, reason containing the nullification reason text."
}
]
}
]
},
{
"source" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2",
"target" : "http://hl7.org/fhir/StructureDefinition/Composition",
"element" : [
{
"code" : "careDocumentation.careDocumentationHeader.documentId",
"display" : "Document ID",
"target" : [
{
"code" : "identifier",
"equivalence" : "equivalent",
"comment" : "Same identifier as DocumentReference for linking"
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.documentStatus",
"display" : "Composition status",
"target" : [
{
"code" : "status",
"equivalence" : "relatedto",
"comment" : "Composition.status: preliminary|final|amended|entered-in-error. Maps from TKB documentStatus."
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.documentType",
"display" : "Composition type",
"target" : [
{
"code" : "type",
"equivalence" : "equivalent",
"comment" : "Same type code as DocumentReference.type. LOINC or Swedish document type codes."
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.documentCategory",
"display" : "Composition category",
"target" : [
{
"code" : "category",
"equivalence" : "equivalent",
"comment" : "High-level categorization matching DocumentReference.category"
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.patientId",
"display" : "Patient ID",
"target" : [
{
"code" : "subject",
"equivalence" : "equivalent",
"comment" : "Reference to Patient resource"
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.careContactId",
"display" : "Care contact/encounter context",
"target" : [
{
"code" : "encounter",
"equivalence" : "equivalent",
"comment" : "Reference to Encounter when document created during care contact"
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.documentTime",
"display" : "Composition date",
"target" : [
{
"code" : "date",
"equivalence" : "equivalent",
"comment" : "Composition edit/change time. May differ from authorTime."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.accountableHealthcareProfessional",
"display" : "Document author (healthcare professional)",
"target" : [
{
"code" : "author",
"equivalence" : "equivalent",
"comment" : "Reference to Practitioner. Can have multiple authors. Also mapped to Provenance for full metadata."
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.documentTitle",
"display" : "Composition title",
"target" : [
{
"code" : "title",
"equivalence" : "equivalent",
"comment" : "Human-readable document title"
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.legalAuthenticator",
"display" : "Legal authenticator (attester)",
"target" : [
{
"code" : "attester",
"equivalence" : "equivalent",
"comment" : "Composition.attester with mode=#legal, time=signatureTime, party=Reference(Practitioner). Also creates Provenance.signature."
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.custodian",
"display" : "Document custodian (care provider organization)",
"target" : [
{
"code" : "custodian",
"equivalence" : "equivalent",
"comment" : "Reference to Organization (vårdgivare) responsible for document"
}
]
},
{
"code" : "careDocumentation.careDocumentationBody.section",
"display" : "Document sections (reason for visit, assessment, plan, etc.)",
"target" : [
{
"code" : "section",
"equivalence" : "equivalent",
"comment" : "Composition.section with code, title, text (narrative), and entry (references to resources). Common LOINC section codes: 10154-3 (chief complaint), 10164-2 (history), 29545-1 (physical exam), 51847-2 (assessment), 18776-5 (plan)"
}
]
}
]
},
{
"source" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2",
"target" : "http://hl7.org/fhir/StructureDefinition/Provenance",
"element" : [
{
"code" : "careDocumentation.careDocumentationHeader.sourceSystemHSAid",
"display" : "Source system HSA-ID",
"target" : [
{
"code" : "entity.what",
"equivalence" : "equivalent",
"comment" : "HSA-ID of source system. Also mapped to DocumentReference.meta.source as https://hsaid.se/{HSA-ID}. Provenance.entity.role=source."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.accountableHealthcareProfessional.authorTime",
"display" : "Author time (registration timestamp)",
"target" : [
{
"code" : "recorded",
"equivalence" : "equivalent",
"comment" : "When document information was recorded. Also mapped to DocumentReference.meta.lastUpdated."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.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 Composition.author and DocumentReference.author."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.accountableHealthcareProfessional.healthcareProfessionalName",
"display" : "Healthcare professional name",
"target" : [
{
"code" : "agent.who.display",
"equivalence" : "equivalent",
"comment" : "Display name. Full Practitioner resource should have structured name."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.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). Map to Provenance.agent.role or store in Practitioner.qualification."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit",
"display" : "Organization unit (where professional works)",
"target" : [
{
"code" : "agent.onBehalfOf",
"equivalence" : "equivalent",
"comment" : "Reference to Organization (organizational unit). Full details (HSA-ID, name, telecom, address, location) in Organization resource."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.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. Also in DocumentReference.custodian."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.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. Reference to Organization."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.legalAuthenticator.signatureTime",
"display" : "Signature timestamp",
"target" : [
{
"code" : "signature.when",
"equivalence" : "equivalent",
"comment" : "When document was digitally signed. Also in Composition.attester.time."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.legalAuthenticator.legalAuthenticatorHSAid",
"display" : "Legal authenticator HSA-ID",
"target" : [
{
"code" : "signature.who",
"equivalence" : "equivalent",
"comment" : "Reference to Practitioner who signed document. Provenance.agent.type=legal."
}
]
},
{
"code" : "careDocumentation.careDocumentationHeader.legalAuthenticator.signatureData",
"display" : "Digital signature (cryptographic)",
"target" : [
{
"code" : "signature.data",
"equivalence" : "equivalent",
"comment" : "Base64 encoded signature. Set sigFormat (application/jose, application/xmldsig+xml, etc.). Type code: 1.2.840.10065.1.12.1.1 (Author's Signature)"
}
]
}
]
},
{
"source" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetCareDocumentationResponder/2",
"target" : "http://hl7.org/fhir/StructureDefinition/Bundle",
"element" : [
{
"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. Bundle-level OperationOutcome for details."
}
]
},
{
"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."
}
]
}
]
}
]
}