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 - JSON Representation

Draft as of 2025-11-24

Raw json | Download

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