ConceptMapGetCareContactsTKBToEncounter
type: ConceptMap
node role: treeRoot
id:
  v: ConceptMapGetCareContactsTKBToEncounter
text:
  status:
    v: generated
  div:
    v: Generated Narrative: ConceptMap ConceptMapGetCareContactsTKBToEncounter Mapping from https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2 to Encounter Group 1 Mapping from https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2 to Bundle Source Code Relationship Target Code Comment GetCareContactsResponse.patient-id (Patient ID (personnummer/samordningsnummer)) is equivalent to subject Reference to Patient resource with Swedish national identifier GetCareContactsResponse.careContact.careContactId (Care contact ID (unique identifier)) is equivalent to identifier Business identifier for care contact. Use system from source system URL. GetCareContactsResponse.careContact.contactStatus (Contact status (planned, arrived, in-progress, finished)) is equivalent to status Encounter status: planned|arrived|triaged|in-progress|onleave|finished|cancelled|entered-in-error|unknown GetCareContactsResponse.careContact.careContactType.class (Care contact class (inpatient, outpatient, emergency)) is equivalent to class Encounter class. System: http://terminology.hl7.org/CodeSystem/v3-ActCode. Values: IMP (inpatient), AMB (ambulatory/outpatient), EMER (emergency), HH (home health), VR (virtual) GetCareContactsResponse.careContact.careContactType.code (Care contact type code (detailed Swedish contact type)) is equivalent to type.coding.code 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 GetCareContactsResponse.careContact.serviceType.code (Service type (specialty, clinic type)) is equivalent to serviceType.coding.code Type of service provided. Swedish specialty codes or clinic types. GetCareContactsResponse.careContact.priority (Contact priority (routine, urgent, emergency)) is equivalent to priority Encounter priority. System: http://terminolo…
url:
  v: https://inera.se/fhir/core/ConceptMap/getcarecontacts-tkb-to-encounter
  l: getcarecontacts-tkb-to-encounter
version:
  v: 0.2.0
name:
  v: ConceptMapGetCareContactsTKBToEncounter
title:
  v: ConceptMap GetCareContacts TKB to FHIR Encounter
status:
  v: draft
experimental:
  v: true
date:
  v: 2025-11-24
publisher:
  v: Inera AB
contact:
  name:
    v: Inera AB
  telecom:
    system:
      v: url
    value:
      v: https://www.inera.se
  telecom:
    system:
      v: email
contact:
  name:
    v: Inera AB
  telecom:
    system:
      v: url
    value:
      v: https://www.inera.se
  telecom:
    system:
      v: email
description:
  v: Complete mapping from GetCareContacts TKB logical model to FHIR Encounter and Provenance resources
jurisdiction:
  coding:
    system:
      v: urn:iso:std:iso:3166
      l: 3166
    code:
      v: SE
    display:
      v: Sweden
source: Uri
  v: https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2
  l: https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2
target: Canonical
  v: http://hl7.org/fhir/StructureDefinition/Encounter
  l: Encounter
group:
  source:
    v: https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2
    l: https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2
  target:
    v: http://hl7.org/fhir/StructureDefinition/Bundle
    l: Bundle
  element:
    code:
      v: GetCareContactsResponse.patient-id
    display:
      v: Patient ID (personnummer/samordningsnummer)
    target:
      code:
        v: subject
      equivalence:
        v: equivalent
      comment:
        v: Reference to Patient resource with Swedish national identifier
  element:
    code:
      v: GetCareContactsResponse.careContact.careContactId
    display:
      v: Care contact ID (unique identifier)
    target:
      code:
        v: identifier
      equivalence:
        v: equivalent
      comment:
        v: Business identifier for care contact. Use system from source system URL.
  element:
    code:
      v: GetCareContactsResponse.careContact.contactStatus
    display:
      v: Contact status (planned, arrived, in-progress, finished)
    target:
      code:
        v: status
      equivalence:
        v: equivalent
      comment:
        v: Encounter status: planned|arrived|triaged|in-progress|onleave|finished|cancelled|entered-in-error|unknown
  element:
    code:
      v: GetCareContactsResponse.careContact.careContactType.class
    display:
      v: Care contact class (inpatient, outpatient, emergency)
    target:
      code:
        v: class
      equivalence:
        v: equivalent
      comment:
        v: Encounter class. System: http://terminology.hl7.org/CodeSystem/v3-ActCode. Values: IMP (inpatient), AMB (ambulatory/outpatient), EMER (emergency), HH (home health), VR (virtual)
  element:
    code:
      v: GetCareContactsResponse.careContact.careContactType.code
    display:
      v: Care contact type code (detailed Swedish contact type)
    target:
      code:
        v: type.coding.code
      equivalence:
        v: equivalent
      comment:
        v: 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
  element:
    code:
      v: GetCareContactsResponse.careContact.serviceType.code
    display:
      v: Service type (specialty, clinic type)
    target:
      code:
        v: serviceType.coding.code
      equivalence:
        v: equivalent
      comment:
        v: Type of service provided. Swedish specialty codes or clinic types.
  element:
    code:
      v: GetCareContactsResponse.careContact.priority
    display:
      v: Contact priority (routine, urgent, emergency)
    target:
      code:
        v: priority
      equivalence:
        v: equivalent
      comment:
        v: Encounter priority. System: http://terminology.hl7.org/CodeSystem/v3-ActPriority
  element:
    code:
      v: GetCareContactsResponse.careContact.period.start
    display:
      v: Contact start date/time
    target:
      code:
        v: period.start
      equivalence:
        v: equivalent
      comment:
        v: When care contact started (admission time for inpatient, arrival time for outpatient)
  element:
    code:
      v: GetCareContactsResponse.careContact.period.end
    display:
      v: Contact end date/time
    target:
      code:
        v: period.end
      equivalence:
        v: equivalent
      comment:
        v: When care contact ended (discharge time for inpatient, departure time for outpatient)
  element:
    code:
      v: GetCareContactsResponse.careContact.length
    display:
      v: Contact length/duration
    target:
      code:
        v: length
      equivalence:
        v: equivalent
      comment:
        v: Quantity of time the encounter lasted. Can be calculated from period if not explicitly provided.
  element:
    code:
      v: GetCareContactsResponse.careContact.reasonCode.code
    display:
      v: Reason for contact (chief complaint, diagnosis)
    target:
      code:
        v: reasonCode.coding.code
      equivalence:
        v: equivalent
      comment:
        v: Coded reason for encounter. ICD-10-SE, SNOMED CT, or Swedish symptom codes.

code:
  v: GetCareContactsResponse.careContact.reasonReference
display:
  v: Reason reference (condition, observation)
target:
  code:
    v: reasonReference
  equivalence:
    v: equivalent
  comment:
    v: Reference to Condition, Observation, or Procedure representing reason for encounter

code:
  v: GetCareContactsResponse.careContact.diagnosis.diagnosisCode
display:
  v: Encounter diagnosis
target:
  code:
    v: diagnosis.condition
  equivalence:
    v: equivalent
  comment:
    v: Reference to Condition resource. Can have multiple diagnoses with different uses (admission, discharge, billing).

code:
  v: GetCareContactsResponse.careContact.diagnosis.use
display:
  v: Diagnosis use (admission, discharge, billing)
target:
  code:
    v: diagnosis.use
  equivalence:
    v: equivalent
  comment:
    v: Role of diagnosis. System: http://terminology.hl7.org/CodeSystem/diagnosis-role. Values: AD (admission), DD (discharge), CC (chief complaint), billing

code:
  v: GetCareContactsResponse.careContact.diagnosis.rank
display:
  v: Diagnosis rank (primary, secondary)
target:
  code:
    v: diagnosis.rank
  equivalence:
    v: equivalent
  comment:
    v: Ranking of diagnosis (1 = primary diagnosis)

code:
  v: GetCareContactsResponse.careContact.participant.healthcareProfessionalHSAId
display:
  v: Participant HSA-ID (physician, nurse, etc.)
target:
  code:
    v: participant.individual
  equivalence:
    v: equivalent
  comment:
    v: Reference to Practitioner participating in encounter. Can have multiple participants.

code:
  v: GetCareContactsResponse.careContact.participant.participantType
display:
  v: Participant type/role (attending, consulting, etc.)
target:
  code:
    v: participant.type.coding.code
  equivalence:
    v: equivalent
  comment:
    v: Type of participation. System: http://terminology.hl7.org/CodeSystem/v3-ParticipationType. Values: ATND (attender), CON (consultant), ADM (admitter), DIS (discharger)

code:
  v: GetCareContactsResponse.careContact.participant.period
display:
  v: Participant period (when participant was involved)
target:
  code:
    v: participant.period
  equivalence:
    v: equivalent
  comment:
    v: Time period during which participant was involved in encounter

code:
  v: GetCareContactsResponse.careContact.appointmentId
display:
  v: Appointment ID (if contact was pre-scheduled)
target:
  code:
    v: appointment
  equivalence:
    v: equivalent
  comment:
    v: Reference to Appointment resource if encounter was scheduled

code:
  v: GetCareContactsResponse.careContact.basedOn
display:
  v: Based on (referral, service request)
target:
  code:
    v: basedOn
  equivalence:
    v: equivalent
  comment:
    v: Reference to ServiceRequest, CarePlan, or other request that initiated the encounter

code:
  v: GetCareContactsResponse.careContact.partOf
display:
  v: Part of (parent encounter)
target:
  code:
    v: partOf
  equivalence:
    v: equivalent
  comment:
    v: Reference to parent Encounter. Example: outpatient visit as part of inpatient stay.

code:
  v: GetCareContactsResponse.careContact.serviceProvider.organizationHSAId
display:
  v: Service provider HSA-ID (care unit)
target:
  code:
    v: serviceProvider
  equivalence:
    v: equivalent
  comment:
    v: Reference to Organization (care unit) providing the encounter

code:
  v: GetCareContactsResponse.careContact.location.locationId
display:
  v: Location ID (room, ward, clinic)
target:
  code:
    v: location.location
  equivalence:
    v: equivalent
  comment:
    v: Reference to Location resource (room, ward, clinic, building)

code:
  v: GetCareContactsResponse.careContact.location.status
display:
  v: Location status (planned, active, completed)
target:
  code:
    v: location.status
  equivalence:
    v: equivalent
  comment:
    v: Status of location during encounter: planned|active|reserved|completed

code:
  v: GetCareContactsResponse.careContact.location.period
display:
  v: Location period (time at this location)
target:
  code:
    v: location.period
  equivalence:
    v: equivalent
  comment:
    v: Time period patient was at this location. Can have multiple locations during one encounter.

code:
  v: GetCareContactsResponse.careContact.hospitalization.preAdmissionIdentifier
display:
  v: Pre-admission identifier
target:
  code:
    v: hospitalization.preAdmissionIdentifier
  equivalence:
    v: equivalent
  comment:
    v: Pre-admission identifier (e.g., pre-registration number)

code:
  v: GetCareContactsResponse.careContact.hospitalization.origin
display:
  v: Admission origin (from where patient came)
target:
  code:
    v: hospitalization.origin
  equivalence:
    v: equivalent
  comment:
    v: Reference to Location from where patient came (e.g., home, other hospital, nursing home)

code:
  v: GetCareContactsResponse.careContact.hospitalization.admitSource
display:
  v: Admit source (how patient was admitted)
target:
  code:
    v: hospitalization.admitSource
  equivalence:
    v: equivalent
  comment:
    v: From where patient was admitted. System: http://terminology.hl7.org/CodeSystem/admit-source

code:
  v: GetCareContactsResponse.careContact.hospitalization.reAdmission
display:
  v: Re-admission indicator
target:
  code:
    v: hospitalization.reAdmission
  equivalence:
    v: equivalent
  comment:
    v: Whether this hospitalization is a re-admission

code:
  v: GetCareContactsResponse.careContact.hospitalization.dietPreference
display:
  v: Dietary preference
target:
  code:
    v: hospitalization.dietPreference
  equivalence:
    v: equivalent
  comment:
    v: Diet preferences or restrictions during hospitalization

code:
  v: GetCareContactsResponse.careContact.hospitalization.specialArrangement
display:
  v: Special arrangements (interpreter, wheelchair, etc.)
target:
  code:
    v: hospitalization.specialArrangement
  equivalence:
    v: equivalent
  comment:
    v: Special arrangements needed during encounter

code:
  v: GetCareContactsResponse.careContact.hospitalization.destination
display:
  v: Discharge destination (to where patient discharged)
target:
  code:
    v: hospitalization.destination
  equivalence:
    v: equivalent
  comment:
    v: Reference to Location to where patient was discharged (e.g., home, other hospital, nursing home, deceased)

code:
  v: GetCareContactsResponse.careContact.hospitalization.dischargeDisposition
display:
  v: Discharge disposition (outcome of hospitalization)
target:
  code:
    v: hospitalization.dischargeDisposition
  equivalence:
    v: equivalent
  comment:
    v: Category or kind of location after discharge. System: http://terminology.hl7.org/CodeSystem/discharge-disposition

source:
  v: https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2
  l: https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2
target:
  v: http://hl7.org/fhir/StructureDefinition/Encounter
  l: Encounter
element:
  code:
    v: careContact.careContactHeader.documentId
  display:
    v: Care contact document ID (unique business identifier)
  target:
    code:
      v: identifier
    equivalence:
      v: equivalent
    comment:
      v: Business identifier for care contact. System derived from sourceSystemHSAId. Must be consistent across TKB contract versions.
element:
  code:
    v: careContact.careContactHeader.patientId
  display:
    v: Patient ID (personnummer/samordningsnummer/reservnummer)
  target:
    code:
      v: subject
    equivalence:
      v: equivalent
    comment:
      v: 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)
element:
  code:
    v: careContact.careContactHeader.approvedForPatient
  display:
    v: Approved for patient access (true/false)
  target:
    code:
      v: meta.security
    equivalence:
      v: equivalent
    comment:
      v: If false, add security label NOPATIENT (http://terminology.hl7.org/CodeSystem/v3-ActCode#NOPATIENT) to restrict patient access. See menprövningsflagga documentation.
element:
  code:
    v: careContact.careContactBody.careContactCode
  display:
    v: Care contact type code (vårdkontakttyp)
  target:
    code:
      v: type
    equivalence:
      v: equivalent
    comment:
      v: 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).
element:
  code:
    v: careContact.careContactBody.careContactReason
  display:
    v: Care contact reason (free text from patient)
  target:
    code:
      v: reasonCode.text
    equivalence:
      v: equivalent
    comment:
      v: Free text reason for care contact as stated by patient or representative. Can also create Condition/Observation and reference via reasonReference.
element:
  code:
    v: careContact.careContactBody.careContactTimePeriod.start
  display:
    v: Care contact start time
  target:
    code:
      v: period.start
    equivalence:
      v: equivalent
    comment:
      v: Start time of care contact (admission for inpatient, arrival for outpatient). For outpatient visits, start and end may be same value.
element:
  code:
    v: careContact.careContactBody.careContactTimePeriod.end
  display:
    v: Care contact end time
  target:
    code:
      v: period.end
    equivalence:
      v: equivalent
    comment:
      v: End time of care contact (discharge for inpatient, departure for outpatient). For outpatient visits, start and end may be same value.
element:
  code:
    v: careContact.careContactBody.careContactStatus
  display:
    v: Care contact status (SNOMED CT SE codes)
  target:
    code:
      v: status
    equivalence:
      v: relatedto
    comment:
      v: 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
element:
  code:
    v: careContact.careContactBody.additionalPatientInformation.dateOfBirth
  display:
    v: Patient date of birth
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED to Encounter. Belongs in Patient.birthDate. Included in TKB for cases without PU lookup. Format can be YYYY, YYYYMM, or YYYYMMDD.
element:
  code:
    v: careContact.careContactBody.additionalPatientInformation.gender
  display:
    v: Patient gender
  target:
    equivalence:
      v: unmatched
    comment:
      v: 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:
  v: https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2
  l: https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2
target:
  v: http://hl7.org/fhir/StructureDefinition/Provenance
  l: Provenance
element:
  code:
    v: careContact.careContactHeader.sourceSystemHSAid
  display:
    v: Source system HSA-ID
  target:
    code:
      v: entity.what
    equivalence:
      v: equivalent
    comment:
      v: HSA-ID of source system. Also mapped to Encounter.meta.source as URI: https://hsaid.se/{HSA-ID}. In Provenance.entity with role=source.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.authorTime
  display:
    v: Author time (when information was registered)
  target:
    code:
      v: recorded
    equivalence:
      v: equivalent
    comment:
      v: Timestamp when care contact information was recorded/registered. Also mapped to Encounter.meta.lastUpdated.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalHSAid
  display:
    v: Healthcare professional HSA-ID
  target:
    code:
      v: agent.who
    equivalence:
      v: equivalent
    comment:
      v: Reference to Practitioner with HSA-ID identifier. Agent.type=author. Also mapped to Encounter.participant for clinical involvement.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalName
  display:
    v: Healthcare professional name
  target:
    code:
      v: agent.who.display
    equivalence:
      v: equivalent
    comment:
      v: Display name for practitioner. Full Practitioner resource should include structured name.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalRoleCode
  display:
    v: Healthcare professional role/befattning
  target:
    code:
      v: agent.role
    equivalence:
      v: relatedto
    comment:
      v: 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.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitHSAid
  display:
    v: Organization unit HSA-ID (where professional works)
  target:
    code:
      v: agent.onBehalfOf
    equivalence:
      v: equivalent
    comment:
      v: Reference to Organization representing organizational unit. Part of organization hierarchy (orgUnit → careUnit → careGiver).
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitName
  display:
    v: Organization unit name
  target:
    equivalence:
      v: relatedto
    comment:
      v: Name of organizational unit. Stored in referenced Organization resource, not in Provenance directly.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitTelecom
  display:
    v: Organization unit telephone
  target:
    equivalence:
      v: relatedto
    comment:
      v: Phone number. Stored in Organization.telecom with system=phone.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitEmail
  display:
    v: Organization unit email
  target:
    equivalence:
      v: relatedto
    comment:
      v: Email address. Stored in Organization.telecom with system=email.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitAddress
  display:
    v: Organization unit postal address
  target:
    equivalence:
      v: relatedto
    comment:
      v: Postal address in natural format. Stored in Organization.address.text and parsed into structured elements if possible.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit.orgUnitLocation
  display:
    v: Organization unit location (city/place)
  target:
    equivalence:
      v: relatedto
    comment:
      v: Physical location name/city. Stored in Organization.address.city or as Location resource.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalCareUnitHSAid
  display:
    v: Care unit HSA-ID (vårdenhet - PDL enhet)
  target:
    code:
      v: entity.what
    equivalence:
      v: equivalent
    comment:
      v: HSA-ID for care unit (vårdenhet). Reference to Organization. Part of hierarchy chain. Also in Encounter.serviceProvider.
element:
  code:
    v: careContact.careContactHeader.accountableHealthcareProfessional.healthcareProfessionalCareGiverHSAid
  display:
    v: Care provider HSA-ID (vårdgivare)
  target:
    code:
      v: entity.what
    equivalence:
      v: equivalent
    comment:
      v: HSA-ID for care provider (vårdgivare). Top-level organization in hierarchy. Reference to Organization.
element:
  code:
    v: careContact.careContactBody.careContactOrgUnit.orgUnitHSAid
  display:
    v: Care contact org unit HSA-ID (where contact occurred)
  target:
    equivalence:
      v: relatedto
    comment:
      v: Organization unit where care contact was performed. Can differ from professional's home unit. Mapped to Encounter.serviceProvider or Encounter.location.
element:
  code:
    v: careContact.careContactBody.careContactOrgUnit.orgUnitName
  display:
    v: Care contact org unit name
  target:
    equivalence:
      v: relatedto
    comment:
      v: Name of unit where contact occurred. Stored in Organization or Location resource.
element:
  code:
    v: careContact.careContactBody.careContactOrgUnit.orgUnitTelecom
  display:
    v: Care contact org unit telephone
  target:
    equivalence:
      v: relatedto
    comment:
      v: Phone for unit where contact occurred.
element:
  code:
    v: careContact.careContactBody.careContactOrgUnit.orgUnitEmail
  display:
    v: Care contact org unit email
  target:
    equivalence:
      v: relatedto
    comment:
      v: Email for unit where contact occurred.
element:
  code:
    v: careContact.careContactBody.careContactOrgUnit.orgUnitAddress
  display:
    v: Care contact org unit address
  target:
    equivalence:
      v: relatedto
    comment:
      v: Address of unit where contact occurred.

code:
  v: careContact.careContactBody.careContactOrgUnit.orgUnitLocation
display:
  v: Care contact org unit location (city/place)
target:
  equivalence:
    v: relatedto
  comment:
    v: Physical location/city where contact occurred.

source:
  v: https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2
  l: https://rivta.se/domains/clinicalprocess/logistics/logistics/GetCareContactsResponder/2
target:
  v: http://hl7.org/fhir/StructureDefinition/Bundle
  l: Bundle
element:
  code:
    v: careContact.careContactHeader.documentTitle
  display:
    v: Document title (DEPRECATED - shall not be used)
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED. TKB specifies cardinality 0..0 - this field shall not be populated.
element:
  code:
    v: careContact.careContactHeader.documentTime
  display:
    v: Document time (DEPRECATED - shall not be used)
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED. TKB specifies cardinality 0..0 - use accountableHealthcareProfessional.authorTime instead.
element:
  code:
    v: careContact.careContactHeader.legalAuthenticator
  display:
    v: Legal authenticator (DEPRECATED - shall not be used)
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED. TKB specifies cardinality 0..0 - not used for care contacts.
element:
  code:
    v: careContact.careContactHeader.nullified
  display:
    v: Nullified flag (DEPRECATED - shall not be used)
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED. TKB specifies cardinality 0..0 - use careContactStatus=makulerad (53691000052102) instead.
element:
  code:
    v: careContact.careContactHeader.nullifiedReason
  display:
    v: Nullified reason (DEPRECATED - shall not be used)
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED. TKB specifies cardinality 0..0.
element:
  code:
    v: careContact.careContactHeader.careContactId
  display:
    v: Care contact ID in header (DEPRECATED - use documentId)
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED. TKB specifies cardinality 0..0 - use careContactHeader.documentId instead.
element:
  code:
    v: result.resultCode
  display:
    v: Result code (OK, INFO, ERROR)
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED to resources. Used in Bundle-level OperationOutcome or HTTP status codes. OK→200, INFO→200 with warnings, ERROR→4xx/5xx.
element:
  code:
    v: result.errorCode
  display:
    v: Error code (when resultCode=ERROR)
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED to resources. Used in OperationOutcome.issue.code for error responses.
element:
  code:
    v: result.subCode
  display:
    v: Error sub-code
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED. No subcodes specified in GetCareContacts v2.0/v3.0.
element:
  code:
    v: result.logId
  display:
    v: Log ID (UUID for troubleshooting)
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED to resources. Used in OperationOutcome.issue.diagnostics or X-Request-Id header for error tracking.
element:
  code:
    v: result.message
  display:
    v: Result message (descriptive text)
  target:
    equivalence:
      v: unmatched
    comment:
      v: NOT MAPPED to resources. User-facing message in OperationOutcome.issue.diagnostics or Bundle.entry.response.outcome.