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

: ConceptMap GetCareContacts TKB to FHIR Encounter - XML Representation

Draft as of 2025-11-24

Raw xml | Download


<ConceptMap xmlns="http://hl7.org/fhir">
  <id value="ConceptMapGetCareContactsTKBToEncounter"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: ConceptMap ConceptMapGetCareContactsTKBToEncounter</b></p><a name="ConceptMapGetCareContactsTKBToEncounter"> </a><a name="hcConceptMapGetCareContactsTKBToEncounter"> </a><p>Mapping from https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2 to <a href="http://hl7.org/fhir/R4/encounter.html">Encounter</a></p><br/><p><b>Group 1 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/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>GetCareContactsResponse.patient-id (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 resource with Swedish national identifier</td></tr><tr><td>GetCareContactsResponse.careContact.careContactId (Care contact ID (unique 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>Business identifier for care contact. Use system from source system URL.</td></tr><tr><td>GetCareContactsResponse.careContact.contactStatus (Contact status (planned, arrived, in-progress, finished))</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>Encounter status: planned|arrived|triaged|in-progress|onleave|finished|cancelled|entered-in-error|unknown</td></tr><tr><td>GetCareContactsResponse.careContact.careContactType.class (Care contact class (inpatient, outpatient, emergency))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>class</td><td>Encounter class. System: http://terminology.hl7.org/CodeSystem/v3-ActCode. Values: IMP (inpatient), AMB (ambulatory/outpatient), EMER (emergency), HH (home health), VR (virtual)</td></tr><tr><td>GetCareContactsResponse.careContact.careContactType.code (Care contact type code (detailed Swedish contact 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.coding.code</td><td>Swedish care contact type codes. System: https://terminologitjansten.inera.se/inera-kodverksforvaltning/kodverk/kv_vardkontakttyp (OID: 1.2.752.129.2.2.2.25). Examples: läkarbesök, sjuksköterskebesök, hembesök, telefonkontakt</td></tr><tr><td>GetCareContactsResponse.careContact.serviceType.code (Service type (specialty, clinic type))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>serviceType.coding.code</td><td>Type of service provided. Swedish specialty codes or clinic types.</td></tr><tr><td>GetCareContactsResponse.careContact.priority (Contact priority (routine, urgent, emergency))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>priority</td><td>Encounter priority. System: http://terminology.hl7.org/CodeSystem/v3-ActPriority</td></tr><tr><td>GetCareContactsResponse.careContact.period.start (Contact start 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>period.start</td><td>When care contact started (admission time for inpatient, arrival time for outpatient)</td></tr><tr><td>GetCareContactsResponse.careContact.period.end (Contact end 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>period.end</td><td>When care contact ended (discharge time for inpatient, departure time for outpatient)</td></tr><tr><td>GetCareContactsResponse.careContact.length (Contact length/duration)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>length</td><td>Quantity of time the encounter lasted. Can be calculated from period if not explicitly provided.</td></tr><tr><td>GetCareContactsResponse.careContact.reasonCode.code (Reason for contact (chief complaint, diagnosis))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>reasonCode.coding.code</td><td>Coded reason for encounter. ICD-10-SE, SNOMED CT, or Swedish symptom codes.</td></tr><tr><td>GetCareContactsResponse.careContact.reasonReference (Reason reference (condition, observation))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>reasonReference</td><td>Reference to Condition, Observation, or Procedure representing reason for encounter</td></tr><tr><td>GetCareContactsResponse.careContact.diagnosis.diagnosisCode (Encounter diagnosis)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>diagnosis.condition</td><td>Reference to Condition resource. Can have multiple diagnoses with different uses (admission, discharge, billing).</td></tr><tr><td>GetCareContactsResponse.careContact.diagnosis.use (Diagnosis use (admission, discharge, billing))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>diagnosis.use</td><td>Role of diagnosis. System: http://terminology.hl7.org/CodeSystem/diagnosis-role. Values: AD (admission), DD (discharge), CC (chief complaint), billing</td></tr><tr><td>GetCareContactsResponse.careContact.diagnosis.rank (Diagnosis rank (primary, secondary))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>diagnosis.rank</td><td>Ranking of diagnosis (1 = primary diagnosis)</td></tr><tr><td>GetCareContactsResponse.careContact.participant.healthcareProfessionalHSAId (Participant HSA-ID (physician, nurse, etc.))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>participant.individual</td><td>Reference to Practitioner participating in encounter. Can have multiple participants.</td></tr><tr><td>GetCareContactsResponse.careContact.participant.participantType (Participant type/role (attending, consulting, etc.))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>participant.type.coding.code</td><td>Type of participation. System: http://terminology.hl7.org/CodeSystem/v3-ParticipationType. Values: ATND (attender), CON (consultant), ADM (admitter), DIS (discharger)</td></tr><tr><td>GetCareContactsResponse.careContact.participant.period (Participant period (when participant was involved))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>participant.period</td><td>Time period during which participant was involved in encounter</td></tr><tr><td>GetCareContactsResponse.careContact.appointmentId (Appointment ID (if contact was pre-scheduled))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>appointment</td><td>Reference to Appointment resource if encounter was scheduled</td></tr><tr><td>GetCareContactsResponse.careContact.basedOn (Based on (referral, service request))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>basedOn</td><td>Reference to ServiceRequest, CarePlan, or other request that initiated the encounter</td></tr><tr><td>GetCareContactsResponse.careContact.partOf (Part of (parent encounter))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>partOf</td><td>Reference to parent Encounter. Example: outpatient visit as part of inpatient stay.</td></tr><tr><td>GetCareContactsResponse.careContact.serviceProvider.organizationHSAId (Service provider HSA-ID (care unit))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>serviceProvider</td><td>Reference to Organization (care unit) providing the encounter</td></tr><tr><td>GetCareContactsResponse.careContact.location.locationId (Location ID (room, ward, clinic))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>location.location</td><td>Reference to Location resource (room, ward, clinic, building)</td></tr><tr><td>GetCareContactsResponse.careContact.location.status (Location status (planned, active, completed))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>location.status</td><td>Status of location during encounter: planned|active|reserved|completed</td></tr><tr><td>GetCareContactsResponse.careContact.location.period (Location period (time at this location))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>location.period</td><td>Time period patient was at this location. Can have multiple locations during one encounter.</td></tr><tr><td>GetCareContactsResponse.careContact.hospitalization.preAdmissionIdentifier (Pre-admission identifier)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>hospitalization.preAdmissionIdentifier</td><td>Pre-admission identifier (e.g., pre-registration number)</td></tr><tr><td>GetCareContactsResponse.careContact.hospitalization.origin (Admission origin (from where patient came))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>hospitalization.origin</td><td>Reference to Location from where patient came (e.g., home, other hospital, nursing home)</td></tr><tr><td>GetCareContactsResponse.careContact.hospitalization.admitSource (Admit source (how patient was admitted))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>hospitalization.admitSource</td><td>From where patient was admitted. System: http://terminology.hl7.org/CodeSystem/admit-source</td></tr><tr><td>GetCareContactsResponse.careContact.hospitalization.reAdmission (Re-admission indicator)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>hospitalization.reAdmission</td><td>Whether this hospitalization is a re-admission</td></tr><tr><td>GetCareContactsResponse.careContact.hospitalization.dietPreference (Dietary preference)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>hospitalization.dietPreference</td><td>Diet preferences or restrictions during hospitalization</td></tr><tr><td>GetCareContactsResponse.careContact.hospitalization.specialArrangement (Special arrangements (interpreter, wheelchair, etc.))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>hospitalization.specialArrangement</td><td>Special arrangements needed during encounter</td></tr><tr><td>GetCareContactsResponse.careContact.hospitalization.destination (Discharge destination (to where patient discharged))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>hospitalization.destination</td><td>Reference to Location to where patient was discharged (e.g., home, other hospital, nursing home, deceased)</td></tr><tr><td>GetCareContactsResponse.careContact.hospitalization.dischargeDisposition (Discharge disposition (outcome of hospitalization))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>hospitalization.dischargeDisposition</td><td>Category or kind of location after discharge. System: http://terminology.hl7.org/CodeSystem/discharge-disposition</td></tr></table><hr/><p><b>Group 2 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2</code> to <a href="http://hl7.org/fhir/R4/encounter.html">Encounter</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>careContact.careContactHeader.documentId (Care contact 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>Business identifier for care contact. System derived from sourceSystemHSAId. Must be consistent across TKB contract versions.</td></tr><tr><td>careContact.careContactHeader.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 resource with Swedish national identifier (OID 1.2.752.129.2.1.3.1 for personnummer, 1.2.752.129.2.1.3.3 for samordningsnummer)</td></tr><tr><td>careContact.careContactHeader.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 (http://terminology.hl7.org/CodeSystem/v3-ActCode#NOPATIENT) to restrict patient access. See menprövningsflagga documentation.</td></tr><tr><td>careContact.careContactBody.careContactCode (Care contact type code (vårdkontakttyp))</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 care contact type. System: https://terminologitjansten.inera.se/inera-kodverksforvaltning/kodverk/kv_vardkontakttyp (OID 1.2.752.129.2.2.2.25). Maps to both Encounter.class (high-level) and Encounter.type (detailed).</td></tr><tr><td>careContact.careContactBody.careContactReason (Care contact reason (free text from patient))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>reasonCode.text</td><td>Free text reason for care contact as stated by patient or representative. Can also create Condition/Observation and reference via reasonReference.</td></tr><tr><td>careContact.careContactBody.careContactTimePeriod.start (Care contact start time)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>period.start</td><td>Start time of care contact (admission for inpatient, arrival for outpatient). For outpatient visits, start and end may be same value.</td></tr><tr><td>careContact.careContactBody.careContactTimePeriod.end (Care contact end time)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>period.end</td><td>End time of care contact (discharge for inpatient, departure for outpatient). For outpatient visits, start and end may be same value.</td></tr><tr><td>careContact.careContactBody.careContactStatus (Care contact status (SNOMED CT SE codes))</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 from SNOMED CT SE (SCTID 53761000052103) to FHIR status. SNOMED 53631000052103 (tidbokad)→planned, 53651000052107 (pågående)→in-progress, 53671000052101 (avslutad)→finished, 53661000052105 (avbruten)→cancelled, 53641000052109 (inställd)→cancelled, 53691000052102 (makulerad)→entered-in-error</td></tr><tr><td>careContact.careContactBody.additionalPatientInformation.dateOfBirth (Patient date of birth)</td><td colspan="2" style="background-color: #efefef">(not mapped)</td><td style="background-color: #efefef">NOT MAPPED to Encounter. Belongs in Patient.birthDate. Included in TKB for cases without PU lookup. Format can be YYYY, YYYYMM, or YYYYMMDD.</td></tr><tr><td>careContact.careContactBody.additionalPatientInformation.gender (Patient gender)</td><td colspan="2" style="background-color: #efefef">(not mapped)</td><td style="background-color: #efefef">NOT MAPPED to Encounter. Belongs in Patient.gender. Included in TKB for cases without PU lookup. Use KV Kön (OID 1.2.752.129.2.2.1.1).</td></tr></table><hr/><p><b>Group 3 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/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>careContact.careContactHeader.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 Encounter.meta.source as URI: https://hsaid.se/{HSA-ID}. In Provenance.entity with role=source.</td></tr><tr><td>careContact.careContactHeader.accountableHealthcareProfessional.authorTime (Author time (when information was registered))</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>Timestamp when care contact information was recorded/registered. Also mapped to Encounter.meta.lastUpdated.</td></tr><tr><td>careContact.careContactHeader.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 identifier. Agent.type=author. Also mapped to Encounter.participant for clinical involvement.</td></tr><tr><td>careContact.careContactHeader.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 for practitioner. Full Practitioner resource should include structured name.</td></tr><tr><td>careContact.careContactHeader.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). Mapped to Provenance.agent.role or stored in Practitioner.qualification.</td></tr><tr><td>careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitHSAid (Organization unit HSA-ID (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 representing organizational unit. Part of organization hierarchy (orgUnit → careUnit → careGiver).</td></tr><tr><td>careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitName (Organization unit name)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Name of organizational unit. Stored in referenced Organization resource, not in Provenance directly.</td></tr><tr><td>careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitTelecom (Organization unit telephone)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Phone number. Stored in Organization.telecom with system=phone.</td></tr><tr><td>careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitEmail (Organization unit email)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Email address. Stored in Organization.telecom with system=email.</td></tr><tr><td>careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitAddress (Organization unit postal address)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Postal address in natural format. Stored in Organization.address.text and parsed into structured elements if possible.</td></tr><tr><td>careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitLocation (Organization unit location (city/place))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Physical location name/city. Stored in Organization.address.city or as Location resource.</td></tr><tr><td>careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalCareUnitHSAid (Care unit HSA-ID (vårdenhet - PDL enhet))</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 (vårdenhet). Reference to Organization. Part of hierarchy chain. Also in Encounter.serviceProvider.</td></tr><tr><td>careContact.careContactHeader.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 (vårdgivare). Top-level organization in hierarchy. Reference to Organization.</td></tr><tr><td>careContact.careContactBody.careContactOrgUnit.orgUnitHSAid (Care contact org unit HSA-ID (where contact occurred))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Organization unit where care contact was performed. Can differ from professional's home unit. Mapped to Encounter.serviceProvider or Encounter.location.</td></tr><tr><td>careContact.careContactBody.careContactOrgUnit.orgUnitName (Care contact org unit name)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Name of unit where contact occurred. Stored in Organization or Location resource.</td></tr><tr><td>careContact.careContactBody.careContactOrgUnit.orgUnitTelecom (Care contact org unit telephone)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Phone for unit where contact occurred.</td></tr><tr><td>careContact.careContactBody.careContactOrgUnit.orgUnitEmail (Care contact org unit email)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Email for unit where contact occurred.</td></tr><tr><td>careContact.careContactBody.careContactOrgUnit.orgUnitAddress (Care contact org unit address)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Address of unit where contact occurred.</td></tr><tr><td>careContact.careContactBody.careContactOrgUnit.orgUnitLocation (Care contact org unit location (city/place))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td/><td>Physical location/city where contact occurred.</td></tr></table><hr/><p><b>Group 4 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/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>careContact.careContactHeader.documentTitle (Document title (DEPRECATED - shall not be used))</td><td colspan="2" style="background-color: #efefef">(not mapped)</td><td style="background-color: #efefef">NOT MAPPED. TKB specifies cardinality 0..0 - this field shall not be populated.</td></tr><tr><td>careContact.careContactHeader.documentTime (Document time (DEPRECATED - shall not be used))</td><td colspan="2" style="background-color: #efefef">(not mapped)</td><td style="background-color: #efefef">NOT MAPPED. TKB specifies cardinality 0..0 - use accountableHealthcareProfessional.authorTime instead.</td></tr><tr><td>careContact.careContactHeader.legalAuthenticator (Legal authenticator (DEPRECATED - shall not be used))</td><td colspan="2" style="background-color: #efefef">(not mapped)</td><td style="background-color: #efefef">NOT MAPPED. TKB specifies cardinality 0..0 - not used for care contacts.</td></tr><tr><td>careContact.careContactHeader.nullified (Nullified flag (DEPRECATED - shall not be used))</td><td colspan="2" style="background-color: #efefef">(not mapped)</td><td style="background-color: #efefef">NOT MAPPED. TKB specifies cardinality 0..0 - use careContactStatus=makulerad (53691000052102) instead.</td></tr><tr><td>careContact.careContactHeader.nullifiedReason (Nullified reason (DEPRECATED - shall not be used))</td><td colspan="2" style="background-color: #efefef">(not mapped)</td><td style="background-color: #efefef">NOT MAPPED. TKB specifies cardinality 0..0.</td></tr><tr><td>careContact.careContactHeader.careContactId (Care contact ID in header (DEPRECATED - use documentId))</td><td colspan="2" style="background-color: #efefef">(not mapped)</td><td style="background-color: #efefef">NOT MAPPED. TKB specifies cardinality 0..0 - use careContactHeader.documentId 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. Used in Bundle-level OperationOutcome or HTTP status codes. OK→200, INFO→200 with warnings, ERROR→4xx/5xx.</td></tr><tr><td>result.errorCode (Error code (when resultCode=ERROR))</td><td colspan="2" style="background-color: #efefef">(not mapped)</td><td style="background-color: #efefef">NOT MAPPED to resources. Used in OperationOutcome.issue.code for error responses.</td></tr><tr><td>result.subCode (Error sub-code)</td><td colspan="2" style="background-color: #efefef">(not mapped)</td><td style="background-color: #efefef">NOT MAPPED. No subcodes specified in GetCareContacts v2.0/v3.0.</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. Used in OperationOutcome.issue.diagnostics or X-Request-Id header for error tracking.</td></tr><tr><td>result.message (Result message (descriptive text))</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 or Bundle.entry.response.outcome.</td></tr></table></div>
  </text>
  <url
       value="https://inera.se/fhir/core/ConceptMap/getcarecontacts-tkb-to-encounter"/>
  <version value="0.2.0"/>
  <name value="ConceptMapGetCareContactsTKBToEncounter"/>
  <title value="ConceptMap GetCareContacts TKB to FHIR Encounter"/>
  <status value="draft"/>
  <experimental value="true"/>
  <date value="2025-11-24"/>
  <publisher value="Inera AB"/>
  <contact>
    <name value="Inera AB"/>
    <telecom>
      <system value="url"/>
      <value value="https://www.inera.se"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="info@inera.se"/>
    </telecom>
  </contact>
  <contact>
    <name value="Inera AB"/>
    <telecom>
      <system value="url"/>
      <value value="https://www.inera.se"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="info@inera.se"/>
    </telecom>
  </contact>
  <description
               value="Complete mapping from GetCareContacts TKB logical model to FHIR Encounter and Provenance resources"/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="SE"/>
      <display value="Sweden"/>
    </coding>
  </jurisdiction>
  <sourceUri
             value="https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2"/>
  <targetCanonical value="http://hl7.org/fhir/StructureDefinition/Encounter"/>
  <group>
    <source
            value="https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2"/>
    <target value="http://hl7.org/fhir/StructureDefinition/Bundle"/>
    <element>
      <code value="GetCareContactsResponse.patient-id"/>
      <display value="Patient ID (personnummer/samordningsnummer)"/>
      <target>
        <code value="subject"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Patient resource with Swedish national identifier"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.careContactId"/>
      <display value="Care contact ID (unique identifier)"/>
      <target>
        <code value="identifier"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Business identifier for care contact. Use system from source system URL."/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.contactStatus"/>
      <display
               value="Contact status (planned, arrived, in-progress, finished)"/>
      <target>
        <code value="status"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Encounter status: planned|arrived|triaged|in-progress|onleave|finished|cancelled|entered-in-error|unknown"/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.careContactType.class"/>
      <display value="Care contact class (inpatient, outpatient, emergency)"/>
      <target>
        <code value="class"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Encounter class. System: http://terminology.hl7.org/CodeSystem/v3-ActCode. Values: IMP (inpatient), AMB (ambulatory/outpatient), EMER (emergency), HH (home health), VR (virtual)"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.careContactType.code"/>
      <display
               value="Care contact type code (detailed Swedish contact type)"/>
      <target>
        <code value="type.coding.code"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Swedish care contact type codes. System: https://terminologitjansten.inera.se/inera-kodverksforvaltning/kodverk/kv_vardkontakttyp (OID: 1.2.752.129.2.2.2.25). Examples: läkarbesök, sjuksköterskebesök, hembesök, telefonkontakt"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.serviceType.code"/>
      <display value="Service type (specialty, clinic type)"/>
      <target>
        <code value="serviceType.coding.code"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Type of service provided. Swedish specialty codes or clinic types."/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.priority"/>
      <display value="Contact priority (routine, urgent, emergency)"/>
      <target>
        <code value="priority"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Encounter priority. System: http://terminology.hl7.org/CodeSystem/v3-ActPriority"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.period.start"/>
      <display value="Contact start date/time"/>
      <target>
        <code value="period.start"/>
        <equivalence value="equivalent"/>
        <comment
                 value="When care contact started (admission time for inpatient, arrival time for outpatient)"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.period.end"/>
      <display value="Contact end date/time"/>
      <target>
        <code value="period.end"/>
        <equivalence value="equivalent"/>
        <comment
                 value="When care contact ended (discharge time for inpatient, departure time for outpatient)"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.length"/>
      <display value="Contact length/duration"/>
      <target>
        <code value="length"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Quantity of time the encounter lasted. Can be calculated from period if not explicitly provided."/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.reasonCode.code"/>
      <display value="Reason for contact (chief complaint, diagnosis)"/>
      <target>
        <code value="reasonCode.coding.code"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Coded reason for encounter. ICD-10-SE, SNOMED CT, or Swedish symptom codes."/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.reasonReference"/>
      <display value="Reason reference (condition, observation)"/>
      <target>
        <code value="reasonReference"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Condition, Observation, or Procedure representing reason for encounter"/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.diagnosis.diagnosisCode"/>
      <display value="Encounter diagnosis"/>
      <target>
        <code value="diagnosis.condition"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Condition resource. Can have multiple diagnoses with different uses (admission, discharge, billing)."/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.diagnosis.use"/>
      <display value="Diagnosis use (admission, discharge, billing)"/>
      <target>
        <code value="diagnosis.use"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Role of diagnosis. System: http://terminology.hl7.org/CodeSystem/diagnosis-role. Values: AD (admission), DD (discharge), CC (chief complaint), billing"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.diagnosis.rank"/>
      <display value="Diagnosis rank (primary, secondary)"/>
      <target>
        <code value="diagnosis.rank"/>
        <equivalence value="equivalent"/>
        <comment value="Ranking of diagnosis (1 = primary diagnosis)"/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.participant.healthcareProfessionalHSAId"/>
      <display value="Participant HSA-ID (physician, nurse, etc.)"/>
      <target>
        <code value="participant.individual"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Practitioner participating in encounter. Can have multiple participants."/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.participant.participantType"/>
      <display value="Participant type/role (attending, consulting, etc.)"/>
      <target>
        <code value="participant.type.coding.code"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Type of participation. System: http://terminology.hl7.org/CodeSystem/v3-ParticipationType. Values: ATND (attender), CON (consultant), ADM (admitter), DIS (discharger)"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.participant.period"/>
      <display value="Participant period (when participant was involved)"/>
      <target>
        <code value="participant.period"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Time period during which participant was involved in encounter"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.appointmentId"/>
      <display value="Appointment ID (if contact was pre-scheduled)"/>
      <target>
        <code value="appointment"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Appointment resource if encounter was scheduled"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.basedOn"/>
      <display value="Based on (referral, service request)"/>
      <target>
        <code value="basedOn"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to ServiceRequest, CarePlan, or other request that initiated the encounter"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.partOf"/>
      <display value="Part of (parent encounter)"/>
      <target>
        <code value="partOf"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to parent Encounter. Example: outpatient visit as part of inpatient stay."/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.serviceProvider.organizationHSAId"/>
      <display value="Service provider HSA-ID (care unit)"/>
      <target>
        <code value="serviceProvider"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Organization (care unit) providing the encounter"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.location.locationId"/>
      <display value="Location ID (room, ward, clinic)"/>
      <target>
        <code value="location.location"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Location resource (room, ward, clinic, building)"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.location.status"/>
      <display value="Location status (planned, active, completed)"/>
      <target>
        <code value="location.status"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Status of location during encounter: planned|active|reserved|completed"/>
      </target>
    </element>
    <element>
      <code value="GetCareContactsResponse.careContact.location.period"/>
      <display value="Location period (time at this location)"/>
      <target>
        <code value="location.period"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Time period patient was at this location. Can have multiple locations during one encounter."/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.hospitalization.preAdmissionIdentifier"/>
      <display value="Pre-admission identifier"/>
      <target>
        <code value="hospitalization.preAdmissionIdentifier"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Pre-admission identifier (e.g., pre-registration number)"/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.hospitalization.origin"/>
      <display value="Admission origin (from where patient came)"/>
      <target>
        <code value="hospitalization.origin"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Location from where patient came (e.g., home, other hospital, nursing home)"/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.hospitalization.admitSource"/>
      <display value="Admit source (how patient was admitted)"/>
      <target>
        <code value="hospitalization.admitSource"/>
        <equivalence value="equivalent"/>
        <comment
                 value="From where patient was admitted. System: http://terminology.hl7.org/CodeSystem/admit-source"/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.hospitalization.reAdmission"/>
      <display value="Re-admission indicator"/>
      <target>
        <code value="hospitalization.reAdmission"/>
        <equivalence value="equivalent"/>
        <comment value="Whether this hospitalization is a re-admission"/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.hospitalization.dietPreference"/>
      <display value="Dietary preference"/>
      <target>
        <code value="hospitalization.dietPreference"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Diet preferences or restrictions during hospitalization"/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.hospitalization.specialArrangement"/>
      <display value="Special arrangements (interpreter, wheelchair, etc.)"/>
      <target>
        <code value="hospitalization.specialArrangement"/>
        <equivalence value="equivalent"/>
        <comment value="Special arrangements needed during encounter"/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.hospitalization.destination"/>
      <display value="Discharge destination (to where patient discharged)"/>
      <target>
        <code value="hospitalization.destination"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Location to where patient was discharged (e.g., home, other hospital, nursing home, deceased)"/>
      </target>
    </element>
    <element>
      <code
            value="GetCareContactsResponse.careContact.hospitalization.dischargeDisposition"/>
      <display value="Discharge disposition (outcome of hospitalization)"/>
      <target>
        <code value="hospitalization.dischargeDisposition"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Category or kind of location after discharge. System: http://terminology.hl7.org/CodeSystem/discharge-disposition"/>
      </target>
    </element>
  </group>
  <group>
    <source
            value="https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2"/>
    <target value="http://hl7.org/fhir/StructureDefinition/Encounter"/>
    <element>
      <code value="careContact.careContactHeader.documentId"/>
      <display value="Care contact document ID (unique business identifier)"/>
      <target>
        <code value="identifier"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Business identifier for care contact. System derived from sourceSystemHSAId. Must be consistent across TKB contract versions."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactHeader.patientId"/>
      <display
               value="Patient ID (personnummer/samordningsnummer/reservnummer)"/>
      <target>
        <code value="subject"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Patient resource with Swedish national identifier (OID 1.2.752.129.2.1.3.1 for personnummer, 1.2.752.129.2.1.3.3 for samordningsnummer)"/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactHeader.approvedForPatient"/>
      <display value="Approved for patient access (true/false)"/>
      <target>
        <code value="meta.security"/>
        <equivalence value="equivalent"/>
        <comment
                 value="If false, add security label NOPATIENT (http://terminology.hl7.org/CodeSystem/v3-ActCode#NOPATIENT) to restrict patient access. See menprövningsflagga documentation."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactBody.careContactCode"/>
      <display value="Care contact type code (vårdkontakttyp)"/>
      <target>
        <code value="type"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Swedish care contact type. System: https://terminologitjansten.inera.se/inera-kodverksforvaltning/kodverk/kv_vardkontakttyp (OID 1.2.752.129.2.2.2.25). Maps to both Encounter.class (high-level) and Encounter.type (detailed)."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactBody.careContactReason"/>
      <display value="Care contact reason (free text from patient)"/>
      <target>
        <code value="reasonCode.text"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Free text reason for care contact as stated by patient or representative. Can also create Condition/Observation and reference via reasonReference."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactBody.careContactTimePeriod.start"/>
      <display value="Care contact start time"/>
      <target>
        <code value="period.start"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Start time of care contact (admission for inpatient, arrival for outpatient). For outpatient visits, start and end may be same value."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactBody.careContactTimePeriod.end"/>
      <display value="Care contact end time"/>
      <target>
        <code value="period.end"/>
        <equivalence value="equivalent"/>
        <comment
                 value="End time of care contact (discharge for inpatient, departure for outpatient). For outpatient visits, start and end may be same value."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactBody.careContactStatus"/>
      <display value="Care contact status (SNOMED CT SE codes)"/>
      <target>
        <code value="status"/>
        <equivalence value="relatedto"/>
        <comment
                 value="Maps from SNOMED CT SE (SCTID 53761000052103) to FHIR status. SNOMED 53631000052103 (tidbokad)→planned, 53651000052107 (pågående)→in-progress, 53671000052101 (avslutad)→finished, 53661000052105 (avbruten)→cancelled, 53641000052109 (inställd)→cancelled, 53691000052102 (makulerad)→entered-in-error"/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactBody.additionalPatientInformation.dateOfBirth"/>
      <display value="Patient date of birth"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED to Encounter. Belongs in Patient.birthDate. Included in TKB for cases without PU lookup. Format can be YYYY, YYYYMM, or YYYYMMDD."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactBody.additionalPatientInformation.gender"/>
      <display value="Patient gender"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED to Encounter. Belongs in Patient.gender. Included in TKB for cases without PU lookup. Use KV Kön (OID 1.2.752.129.2.2.1.1)."/>
      </target>
    </element>
  </group>
  <group>
    <source
            value="https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2"/>
    <target value="http://hl7.org/fhir/StructureDefinition/Provenance"/>
    <element>
      <code value="careContact.careContactHeader.sourceSystemHSAid"/>
      <display value="Source system HSA-ID"/>
      <target>
        <code value="entity.what"/>
        <equivalence value="equivalent"/>
        <comment
                 value="HSA-ID of source system. Also mapped to Encounter.meta.source as URI: https://hsaid.se/{HSA-ID}. In Provenance.entity with role=source."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.authorTime"/>
      <display value="Author time (when information was registered)"/>
      <target>
        <code value="recorded"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Timestamp when care contact information was recorded/registered. Also mapped to Encounter.meta.lastUpdated."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalHSAid"/>
      <display value="Healthcare professional HSA-ID"/>
      <target>
        <code value="agent.who"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Practitioner with HSA-ID identifier. Agent.type=author. Also mapped to Encounter.participant for clinical involvement."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalName"/>
      <display value="Healthcare professional name"/>
      <target>
        <code value="agent.who.display"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Display name for practitioner. Full Practitioner resource should include structured name."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalRoleCode"/>
      <display value="Healthcare professional role/befattning"/>
      <target>
        <code value="agent.role"/>
        <equivalence value="relatedto"/>
        <comment
                 value="Professional role (befattning). Use KV Befattning (OID 1.2.752.129.2.2.1.4). Mapped to Provenance.agent.role or stored in Practitioner.qualification."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitHSAid"/>
      <display value="Organization unit HSA-ID (where professional works)"/>
      <target>
        <code value="agent.onBehalfOf"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Reference to Organization representing organizational unit. Part of organization hierarchy (orgUnit → careUnit → careGiver)."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitName"/>
      <display value="Organization unit name"/>
      <target>
        <equivalence value="relatedto"/>
        <comment
                 value="Name of organizational unit. Stored in referenced Organization resource, not in Provenance directly."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitTelecom"/>
      <display value="Organization unit telephone"/>
      <target>
        <equivalence value="relatedto"/>
        <comment
                 value="Phone number. Stored in Organization.telecom with system=phone."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitEmail"/>
      <display value="Organization unit email"/>
      <target>
        <equivalence value="relatedto"/>
        <comment
                 value="Email address. Stored in Organization.telecom with system=email."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitAddress"/>
      <display value="Organization unit postal address"/>
      <target>
        <equivalence value="relatedto"/>
        <comment
                 value="Postal address in natural format. Stored in Organization.address.text and parsed into structured elements if possible."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitLocation"/>
      <display value="Organization unit location (city/place)"/>
      <target>
        <equivalence value="relatedto"/>
        <comment
                 value="Physical location name/city. Stored in Organization.address.city or as Location resource."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalCareUnitHSAid"/>
      <display value="Care unit HSA-ID (vårdenhet - PDL enhet)"/>
      <target>
        <code value="entity.what"/>
        <equivalence value="equivalent"/>
        <comment
                 value="HSA-ID for care unit (vårdenhet). Reference to Organization. Part of hierarchy chain. Also in Encounter.serviceProvider."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalCareGiverHSAid"/>
      <display value="Care provider HSA-ID (vårdgivare)"/>
      <target>
        <code value="entity.what"/>
        <equivalence value="equivalent"/>
        <comment
                 value="HSA-ID for care provider (vårdgivare). Top-level organization in hierarchy. Reference to Organization."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactBody.careContactOrgUnit.orgUnitHSAid"/>
      <display value="Care contact org unit HSA-ID (where contact occurred)"/>
      <target>
        <equivalence value="relatedto"/>
        <comment
                 value="Organization unit where care contact was performed. Can differ from professional's home unit. Mapped to Encounter.serviceProvider or Encounter.location."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactBody.careContactOrgUnit.orgUnitName"/>
      <display value="Care contact org unit name"/>
      <target>
        <equivalence value="relatedto"/>
        <comment
                 value="Name of unit where contact occurred. Stored in Organization or Location resource."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactBody.careContactOrgUnit.orgUnitTelecom"/>
      <display value="Care contact org unit telephone"/>
      <target>
        <equivalence value="relatedto"/>
        <comment value="Phone for unit where contact occurred."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactBody.careContactOrgUnit.orgUnitEmail"/>
      <display value="Care contact org unit email"/>
      <target>
        <equivalence value="relatedto"/>
        <comment value="Email for unit where contact occurred."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactBody.careContactOrgUnit.orgUnitAddress"/>
      <display value="Care contact org unit address"/>
      <target>
        <equivalence value="relatedto"/>
        <comment value="Address of unit where contact occurred."/>
      </target>
    </element>
    <element>
      <code
            value="careContact.careContactBody.careContactOrgUnit.orgUnitLocation"/>
      <display value="Care contact org unit location (city/place)"/>
      <target>
        <equivalence value="relatedto"/>
        <comment value="Physical location/city where contact occurred."/>
      </target>
    </element>
  </group>
  <group>
    <source
            value="https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2"/>
    <target value="http://hl7.org/fhir/StructureDefinition/Bundle"/>
    <element>
      <code value="careContact.careContactHeader.documentTitle"/>
      <display value="Document title (DEPRECATED - shall not be used)"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED. TKB specifies cardinality 0..0 - this field shall not be populated."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactHeader.documentTime"/>
      <display value="Document time (DEPRECATED - shall not be used)"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED. TKB specifies cardinality 0..0 - use accountableHealthcareProfessional.authorTime instead."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactHeader.legalAuthenticator"/>
      <display value="Legal authenticator (DEPRECATED - shall not be used)"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED. TKB specifies cardinality 0..0 - not used for care contacts."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactHeader.nullified"/>
      <display value="Nullified flag (DEPRECATED - shall not be used)"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED. TKB specifies cardinality 0..0 - use careContactStatus=makulerad (53691000052102) instead."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactHeader.nullifiedReason"/>
      <display value="Nullified reason (DEPRECATED - shall not be used)"/>
      <target>
        <equivalence value="unmatched"/>
        <comment value="NOT MAPPED. TKB specifies cardinality 0..0."/>
      </target>
    </element>
    <element>
      <code value="careContact.careContactHeader.careContactId"/>
      <display
               value="Care contact ID in header (DEPRECATED - use documentId)"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED. TKB specifies cardinality 0..0 - use careContactHeader.documentId instead."/>
      </target>
    </element>
    <element>
      <code value="result.resultCode"/>
      <display value="Result code (OK, INFO, ERROR)"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED to resources. Used in Bundle-level OperationOutcome or HTTP status codes. OK→200, INFO→200 with warnings, ERROR→4xx/5xx."/>
      </target>
    </element>
    <element>
      <code value="result.errorCode"/>
      <display value="Error code (when resultCode=ERROR)"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED to resources. Used in OperationOutcome.issue.code for error responses."/>
      </target>
    </element>
    <element>
      <code value="result.subCode"/>
      <display value="Error sub-code"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED. No subcodes specified in GetCareContacts v2.0/v3.0."/>
      </target>
    </element>
    <element>
      <code value="result.logId"/>
      <display value="Log ID (UUID for troubleshooting)"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED to resources. Used in OperationOutcome.issue.diagnostics or X-Request-Id header for error tracking."/>
      </target>
    </element>
    <element>
      <code value="result.message"/>
      <display value="Result message (descriptive text)"/>
      <target>
        <equivalence value="unmatched"/>
        <comment
                 value="NOT MAPPED to resources. User-facing message in OperationOutcome.issue.diagnostics or Bundle.entry.response.outcome."/>
      </target>
    </element>
  </group>
</ConceptMap>