US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401 United States of America flag

Publication Build: This will be filled in by the publication tooling

Resource Profile: ConditionEncounterDiagnosis - Mappings

Active as of 2025-03-31

Mappings for the ConditionEncounterDiagnosis resource profile.

Scroll down for the Raw FHIR, CDW & SDA mappings (if any).

Note that the CDW and SDA mappings are derived from a look-up based on the VistA source mappings in CDW and VPR SDA.

Mapping Sources

Use Case: Condition: Encounter Diagnosis (Source)ICD DIAGNOSIS (80).01CODE NUMBERPATIENT/IHS (9000001).01NAMEVISIT (9000010).01VISIT/ADMIT DATE&TIMEV POV (9000010.07).001IEN.01POV.02PATIENT NAME.03VISIT.06MODIFIER.13DATE OF INJURY1204ENCOUNTER PROVIDER

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
1608 team-approved V2F fixed value Condition.category[us-core] http://terminology.hl7.org/CodeSystem/condition-category#encounter-diagnosis http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
346 team-approved V2F V POV - IEN (9000010.07-.001) source value Condition.identifier .value .system = http://va.gov/identifiers/$Sta3n/9000010.07 http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
346-1 team-approved V2F fixed value Condition.identifier .system http://va.gov/identifiers/$Sta3n/9000010.07 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
350 team-approved V2F V POV - MODIFIER (9000010.07-.06) exclude value Null Condition.clinicalStatus should this be active or null? http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
1613 for review V2F V POV - POV > ICD DIAGNOSIS - CODE NUMBER (9000010.07-.01 > 80-.01) source value Condition.code.coding .code .system=termmap({VF_ICDCodingSystems,CODING SYSTEM(1.1)} http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
1613-1 for review V2F fixed value Condition.code.coding .system urn:see-termmap-in-mapParameter generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
1611 for review V2F V POV - PATIENT NAME > PATIENT/IHS - NAME (9000010.07-.02 > 9000001-.01) reference Condition.subject /Patient We have patient resource; unclear why name is repeated http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
368 team-approved V2F V POV - VISIT (9000010.07-.03) source value Condition.encounter http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
370 team-approved V2F V POV - DATE OF INJURY (9000010.07-.13) source value Condition.onsetDateTime http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
372 team-approved V2F V POV - VISIT > VISIT - VISIT/ADMIT DATE&TIME (9000010.07-.03 > 9000010-.01) source value Condition.recordedDate Added the sub file and field http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
604 team-approved V2F V POV - MODIFIER (9000010.07-.06) terminologyMaps Condition.clinicalStatus VF_encounterProblemStatus http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
606 team-approved V2F V POV - MODIFIER (9000010.07-.06) terminologyMaps Condition.verificationStatus VF_encounterProblemVerificationStatus http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis | 5.0.1
1766 for review V2F target not supported Condition.abatementDateTime abatementDate is must support http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-problems-health-concerns | 5.0.1
1833 for review V2F V POV - ENCOUNTER PROVIDER (9000010.07-1204) reference Condition.recorder /Practitioner http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-problems-health-concerns | 5.0.1

Mappings for Veterans Health Information Systems Technology and Architecture (VistA) ()

ConditionEncounterDiagnosis
Condition
   identifier
      system346-1: fixed value = http://va.gov/identifiers/$Sta3n/9000010.07

generated from mapParameter line 1

      value346: source value based on V POV - IEN (9000010.07-.001)
   clinicalStatus350: exclude value if Null, 604: terminologyMaps using VF_encounterProblemStatus on V POV - MODIFIER (9000010.07-.06)

should this be active or null?

,
   verificationStatus606: terminologyMaps using VF_encounterProblemVerificationStatus on V POV - MODIFIER (9000010.07-.06)
   category (us-core)1608: fixed value = http://terminology.hl7.org/CodeSystem/condition-category#encounter-diagnosis
   code
      coding
         system1613-1: fixed value = urn:see-termmap-in-mapParameter

generated from mapParameter line 1

         code1613: source value based on V POV - POV > ICD DIAGNOSIS - CODE NUMBER (9000010.07-.01 > 80-.01)
   subject1611: reference based on V POV - PATIENT NAME > PATIENT/IHS - NAME (9000010.07-.02 > 9000001-.01)

We have patient resource; unclear why name is repeated

   encounter368: source value based on V POV - VISIT (9000010.07-.03)
   onset[x] (onsetDateTime)370: source value based on V POV - DATE OF INJURY (9000010.07-.13)
   abatement[x] (abatementDateTime)1766: target not supported

abatementDate is must support

   recordedDate372: source value based on V POV - VISIT > VISIT - VISIT/ADMIT DATE&TIME (9000010.07-.03 > 9000010-.01)

Added the sub file and field

   recorder1833: reference based on V POV - ENCOUNTER PROVIDER (9000010.07-1204)

Mappings for Clinical Data Warehouse (CDW) ()

ConditionEncounterDiagnosis
Condition
   clinicalStatusOutpat.VDiagnosis.Modifier,Outpat.WorkloadVDiagnosis.Modifier
   verificationStatusOutpat.VDiagnosis.Modifier,Outpat.WorkloadVDiagnosis.Modifier
   code
      coding
         codeOutpat.VDiagnosis.ICDIEN,Outpat.WorkloadVDiagnosis.ICDIEN Dim.ICD10.ICD10Code,Dim.ICD9.ICD9Code
   subjectOutpat.VDiagnosis.PatientIEN,Outpat.WorkloadVDiagnosis.PatientIEN
   encounterOutpat.VDiagnosis.VisitDateTime,Outpat.VDiagnosis.VisitIEN,Outpat.WorkloadVDiagnosis.VisitDateTime,Outpat.WorkloadVDiagnosis.VisitIEN
   onset[x] (onsetDateTime)Outpat.VDiagnosis.InjuryDateTime,Outpat.WorkloadVDiagnosis.InjuryDateTime
   recordedDateOutpat.VDiagnosis.VisitDateTime,Outpat.VDiagnosis.VisitIEN,Outpat.WorkloadVDiagnosis.VisitDateTime,Outpat.WorkloadVDiagnosis.VisitIEN Immun.ImmunizationContraRefusalEvent.VisitDateTime,Outpat.Visit.VisitDateTime,Outpat.VisitLogic.VisitDateTime,Outpat.Workload.VisitDateTime
   recorderOutpat.VDiagnosis.EncounterProviderIEN,Outpat.WorkloadVDiagnosis.EncounterProviderIEN

Mappings for Summary Document Architecure (SDA) ()

ConditionEncounterDiagnosis
Condition
   clinicalStatusDiagnosis.Diagnosis[CodeTableDetail.Diagnosis].OriginalText
   verificationStatusDiagnosis.Diagnosis[CodeTableDetail.Diagnosis].OriginalText
   code
      coding
         codeDiagnosis.Diagnosis,Diagnosis.Diagnosis[CodeTableDetail.Diagnosis].Code
   encounterDiagnosis.EncounterNumber,Diagnosis.EnteredAt,Diagnosis.EnteredBy,Diagnosis.EnteredOn,Diagnosis.FromTime,Diagnosis.ToTime
   onset[x] (onsetDateTime)Diagnosis.OnsetTime
   recordedDateDiagnosis.EncounterNumber,Diagnosis.EnteredAt,Diagnosis.EnteredBy,Diagnosis.EnteredOn,Diagnosis.FromTime,Diagnosis.ToTime Encounter.ConsultingClinician[CareProvider].Description,Encounter.ConsultingClinician[CareProvider].Name
   recorderDiagnosis.DiagnosingClinician

Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

ConditionEncounterDiagnosis
ConditionEvent
   identifierEvent.identifier
   clinicalStatusEvent.status
   verificationStatusEvent.status
   codeEvent.code
   subjectEvent.subject
   encounterEvent.context
   onset[x]Event.occurrence[x]
   onset[x] (onsetDateTime)Event.occurrence[x]
   evidence
      codeEvent.reasonCode
   noteEvent.note

Mappings for SNOMED CT Concept Domain Binding (http://snomed.info/conceptdomain)

ConditionEncounterDiagnosis
Condition< 243796009 |Situation with explicit context| : 246090004 |Associated finding| = ( ( < 404684003 |Clinical finding| MINUS ( << 420134006 |Propensity to adverse reactions| OR << 473010000 |Hypersensitivity condition| OR << 79899007 |Drug interaction| OR << 69449002 |Drug action| OR << 441742003 |Evaluation finding| OR << 307824009 |Administrative status| OR << 385356007 |Tumor stage finding|)) OR < 272379006 |Event|)
   clinicalStatus< 303105007 |Disease phases|
   verificationStatus< 410514004 |Finding context value|
   category< 404684003 |Clinical finding|
   category (us-core)< 404684003 |Clinical finding|
   severity< 272141005 |Severities|
   codecode 246090004 |Associated finding| (< 404684003 |Clinical finding| MINUS << 420134006 |Propensity to adverse reactions| MINUS << 473010000 |Hypersensitivity condition| MINUS << 79899007 |Drug interaction| MINUS << 69449002 |Drug action| MINUS << 441742003 |Evaluation finding| MINUS << 307824009 |Administrative status| MINUS << 385356007 |Tumor stage finding|) OR < 413350009 |Finding with explicit context| OR < 272379006 |Event|
   bodySite< 442083009 |Anatomical or acquired body structure|
   stage
      summary< 254291000 |Staging and scales|
   evidence
      code< 404684003 |Clinical finding|

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

ConditionEncounterDiagnosis
ConditionPPR message
   identifier
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   clinicalStatusPRB-14
   verificationStatusPRB-13
   category'problem' if from PRB-3. 'diagnosis' if from DG1 segment in PV1 message
   category (us-core)'problem' if from PRB-3. 'diagnosis' if from DG1 segment in PV1 message
   severityPRB-26 / ABS-3
   codePRB-3
      codingC*E.1-8, C*E.10-22
         systemC*E.3
         versionC*E.7
         codeC*E.1
         displayC*E.2 - but note this is not well followed
         userSelectedSometimes implied by being first
      textC*E.9. But note many systems use C*E.2 for this
   subjectPID-3
   encounterPV1-19 (+PV1-54)
   onset[x]PRB-16
   onset[x] (onsetDateTime)PRB-16
   recordedDateREL-11
   asserterREL-7.1 identifier + REL-7.12 type code
   stage
      summaryPRB-14
   noteNTE child of PRB

Mappings for RIM Mapping (http://hl7.org/v3)

ConditionEncounterDiagnosis
ConditionEntity. Role, or Act, Observation[classCode=OBS, moodCode=EVN, code=ASSERTION, value<Diagnosis]
   textAct.text?
   containedN/A
   modifierExtensionN/A
   identifier.id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   clinicalStatusObservation ACT .inboundRelationship[typeCode=COMP].source[classCode=OBS, code="clinicalStatus", moodCode=EVN].value
   verificationStatusObservation ACT .inboundRelationship[typeCode=COMP].source[classCode=OBS, code="verificationStatus", moodCode=EVN].value
   category.code
   category (us-core).code
   severityCan be pre/post-coordinated into value. Or ./inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="severity"].value
   code.value
      idn/a
      extensionn/a
      codingunion(., ./translation)
         idn/a
         extensionn/a
         system./codeSystem
         version./codeSystemVersion
         code./code
         displayCV.displayName
         userSelectedCD.codingRationale
      text./originalText[mediaType/code="text/plain"]/data
   bodySite.targetBodySiteCode
   subject.participation[typeCode=SBJ].role[classCode=PAT]
   encounter.inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN]
   onset[x].effectiveTime.low or .inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="age at onset"].value
   onset[x] (onsetDateTime).effectiveTime.low or .inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="age at onset"].value
   abatement[x].effectiveTime.high or .inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="age at remission"].value or .inboundRelationship[typeCode=SUBJ]source[classCode=CONC, moodCode=EVN].status=completed
   abatement[x] (abatementDateTime).effectiveTime.high or .inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="age at remission"].value or .inboundRelationship[typeCode=SUBJ]source[classCode=CONC, moodCode=EVN].status=completed
   recordedDate.participation[typeCode=AUT].time
   recorder.participation[typeCode=AUT].role
   asserter.participation[typeCode=INF].role
   stage./inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="stage/grade"]
      idn/a
      extensionn/a
      modifierExtensionN/A
      summary.value
      assessment.self
      type./inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="stage type"]
   evidence.outboundRelationship[typeCode=SPRT].target[classCode=OBS, moodCode=EVN]
      idn/a
      extensionn/a
      modifierExtensionN/A
      code[code="diagnosis"].value
      detail.self
   note.inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="annotation"].value

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

ConditionEncounterDiagnosis
Condition
   identifierFiveWs.identifier
   clinicalStatusFiveWs.status
   verificationStatusFiveWs.status
   categoryFiveWs.class
   category (us-core)FiveWs.class
   severityFiveWs.grade
   codeFiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   encounterFiveWs.context
   onset[x]FiveWs.init
   onset[x] (onsetDateTime)FiveWs.init
   abatement[x]FiveWs.done[x]
   abatement[x] (abatementDateTime)FiveWs.done[x]
   recordedDateFiveWs.recorded
   recorderFiveWs.author
   asserterFiveWs.source
   evidence
      codeFiveWs.why[x]
      detailFiveWs.why[x]

Mappings for SNOMED CT Attribute Binding (http://snomed.org/attributebinding)

ConditionEncounterDiagnosis
Condition
   verificationStatus408729009
   severity246112005
   code246090004
   bodySite363698007