US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401
US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401
Publication Build: This will be filled in by the publication tooling
| Active as of 2025-03-31 |
Mappings for the DiagnosticReportNoteElectronMicroscopyDiagnosticReport 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.
| key | status | direction | source | mapApproach | mapCase | FHIR Path | subPath | mapValue | mapParameter | mapComment | FHIR URL | Ver |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1604 | for review | V2F | EM - ORDERED TEST > ORDERED TEST - IEN (63.02-.35 > 63.52-.001) | source value | DiagnosticReport.identifier | .value | .system = http://va.gov/identifiers/$Sta3n/63.52 | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | |||
| 1604-1 | for review | V2F | fixed value | DiagnosticReport.identifier | .system | http://va.gov/identifiers/$Sta3n/63.52 | generated from mapParameter line 1 | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | |||
| 1689 | for review | V2F | EM - ORDERED TEST > ORDERED TEST - CPRS ORDER # (63.02-.35 > 63.52-3) | reference | DiagnosticReport.basedOn | http://hl7.org/fhir/StructureDefinition/ServiceRequest | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | ||||
| 1812 | for review | V2F | EM - TIU REFERENCE DATE/TIME - EM > TIU REFERENCE DATE/TIME - EM - TIU ENTRY POINTER - EM > TIU DOCUMENT - DOCUMENT TYPE > TIU DOCUMENT DEFINITION - NAME (63.02-.16 > 63.49-1 > 8925-.01 > 8925.1-.01) | source value | DiagnosticReport.code | .text | Per KBS discussion, this value should be Local Title + Specimen.type.text. The local title is this map row; Specimen.type.text is key 1699. | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | |||
| 1813 | for review | V2F | fixed value | DiagnosticReport.code | http://loinc.org#50668-3 "Microscopic observation in Specimen by Electron microscopy Narrative" | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | |||||
| 1814 | for review | V2F | EM - TIU REFERENCE DATE/TIME - EM > TIU REFERENCE DATE/TIME - EM - TIU ENTRY POINTER - EM > TIU DOCUMENT - DOCUMENT TYPE > TIU DOCUMENT DEFINITION - VHA ENTERPRISE STANDARD TITLE > TIU VHA ENTERPRISE STANDARD TITLE - CODING SYSTEM > CODING SYSTEM - CODE > CODE - CODE (63.02-.16 > 63.49-1 > 8925-.01 > 8925.1-1501 > 8926.1-2 > 8926.12-.02 > 8926.121-.01) | source value | DiagnosticReport.code.coding | .code | .system=http://loinc.org | Made inactive but reactivated; after reviewing discussion with KBST from 4/25/2024 this should be included with the fixed value as it's the "standardized title" in TIU. See LEAF 90. Include if not null and include in addition to the fixed .code value. | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | ||
| 1814-1 | for review | V2F | fixed value | DiagnosticReport.code.coding | .system | http://loinc.org | generated from mapParameter line 1 | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | |||
| 1414 | for review | V2F | EM - ORDERED TEST > ORDERED TEST - DISPOSITION (63.02-.35 > 63.52-10) | terminologyMaps | DiagnosticReport.status | VF_DiagnosticReportLabStatus | US Core 5 has new constraints: if status is partial, preliminary, final, ammended, corrected or appended effective[x] and issued are required | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | |||
| 2208 | for review | V2F | fixed value | DiagnosticReport.category | http://loinc.org#LP7839-6 "Pathology" | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | |||||
| 2213 | for review | V2F | PATIENT - LABORATORY REFERENCE > LAB DATA - LRDFN (2-63 > 63-.01) | reference | DiagnosticReport.subject | /Patient | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | ||||
| 2209 | for review | V2F | EM - ORDERED TEST > ORDERED TEST - CPRS ORDER # > ORDER - ORDER # < TEST - PCE VISIT # (63.02-.35 > 63.53-3>100-.01<69.03-12) | reference | DiagnosticReport.encounter | /EncounterOutpatient | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | ||||
| 1422 | for review | V2F | EM - DATE/TIME SPECIMEN TAKEN (63.02-.01) | source value | DiagnosticReport.effectiveDateTime | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | |||||
| 1427 | for review | V2F | EM - DATE REPORT COMPLETED (63.02-.03) | source value | DiagnosticReport.issued | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | |||||
| 1432 | for review | V2F | EM - RELEASED BY (63.02-.13) | reference | DiagnosticReport.performer[va-by] | /Practitioner | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | ||||
| 1685 | for review | V2F | EM - RELEASING SITE (63.02-.345) | reference | DiagnosticReport.performer[va-at] | /Organization | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | ||||
| 1696 | for review | V2F | EM - PATHOLOGIST (63.02-.02) | reference | DiagnosticReport.resultsInterpreter | /Practitioner | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | ||||
| 1697 | for review | V2F | EM - EM ACC # (63.02-.06) | reference | DiagnosticReport.specimen | Specimen | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | ||||
| 1438 | for review | V2F | EM - IMAGE (63.02-2005) | reference | DiagnosticReport.media.link | More information about the image may be available if stakeholders identify requirements. | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | ||||
| 1441 | for review | V2F | EM - EM DIAGNOSIS (63.02-1.4) | source value | DiagnosticReport.conclusion | Vista field is word processing so CodeableConcept cannot be used | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 | ||||
| 1720 | for review | V2F | EM - TIU REFERENCE DATE/TIME - EM > TIU REFERENCE DATE/TIME - EM - TIU ENTRY POINTER - EM > TIU DOCUMENT - REPORT TEXT (63.02-.16 > 63.49-1 > 8925-2) | source value | DiagnosticReport.presentedForm | .data | HDR may be used to get the report | http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note | 5.0.1 |
| DiagnosticReportNoteElectronMicroscopyDiagnosticReport | ||
| DiagnosticReport | ||
| identifier | ||
| system | 1604-1: fixed value = http://va.gov/identifiers/$Sta3n/63.52 | generated from mapParameter line 1 |
| value | 1604: source value based on EM - ORDERED TEST > ORDERED TEST - IEN (63.02-.35 > 63.52-.001) | |
| basedOn | 1689: reference based on EM - ORDERED TEST > ORDERED TEST - CPRS ORDER # (63.02-.35 > 63.52-3) | |
| status | 1414: terminologyMaps using VF_DiagnosticReportLabStatus on EM - ORDERED TEST > ORDERED TEST - DISPOSITION (63.02-.35 > 63.52-10) | US Core 5 has new constraints: if status is partial, preliminary, final, ammended, corrected or appended effective[x] and issued are required |
| category | 2208: fixed value = http://loinc.org#LP7839-6 "Pathology" | |
| code | 1813: fixed value = http://loinc.org#50668-3 "Microscopic observation in Specimen by Electron microscopy Narrative" | |
| coding | ||
| system | 1814-1: fixed value = http://loinc.org | generated from mapParameter line 1 |
| code | 1814: source value based on EM - TIU REFERENCE DATE/TIME - EM > TIU REFERENCE DATE/TIME - EM - TIU ENTRY POINTER - EM > TIU DOCUMENT - DOCUMENT TYPE > TIU DOCUMENT DEFINITION - VHA ENTERPRISE STANDARD TITLE > TIU VHA ENTERPRISE STANDARD TITLE - CODING SYSTEM > CODING SYSTEM - CODE > CODE - CODE (63.02-.16 > 63.49-1 > 8925-.01 > 8925.1-1501 > 8926.1-2 > 8926.12-.02 > 8926.121-.01) | Made inactive but reactivated; after reviewing discussion with KBST from 4/25/2024 this should be included with the fixed value as it's the "standardized title" in TIU. See LEAF 90. Include if not null and include in addition to the fixed .code value. |
| text | 1812: source value based on EM - TIU REFERENCE DATE/TIME - EM > TIU REFERENCE DATE/TIME - EM - TIU ENTRY POINTER - EM > TIU DOCUMENT - DOCUMENT TYPE > TIU DOCUMENT DEFINITION - NAME (63.02-.16 > 63.49-1 > 8925-.01 > 8925.1-.01) | Per KBS discussion, this value should be Local Title + Specimen.type.text. The local title is this map row; Specimen.type.text is key 1699. |
| subject | 2213: reference based on PATIENT - LABORATORY REFERENCE > LAB DATA - LRDFN (2-63 > 63-.01) | |
| encounter | 2209: reference based on EM - ORDERED TEST > ORDERED TEST - CPRS ORDER # > ORDER - ORDER # < TEST - PCE VISIT # (63.02-.35 > 63.53-3>100-.01<69.03-12) | |
| effective[x] (effectiveDateTime) | 1422: source value based on EM - DATE/TIME SPECIMEN TAKEN (63.02-.01) | |
| issued | 1427: source value based on EM - DATE REPORT COMPLETED (63.02-.03) | |
| performer (va-by) | 1432: reference based on EM - RELEASED BY (63.02-.13) | |
| performer (va-at) | 1685: reference based on EM - RELEASING SITE (63.02-.345) | |
| resultsInterpreter | 1696: reference based on EM - PATHOLOGIST (63.02-.02) | |
| specimen | 1697: reference based on EM - EM ACC # (63.02-.06) | |
| media | ||
| link | 1438: reference based on EM - IMAGE (63.02-2005) | More information about the image may be available if stakeholders identify requirements. |
| conclusion | 1441: source value based on EM - EM DIAGNOSIS (63.02-1.4) | Vista field is word processing so CodeableConcept cannot be used |
| presentedForm | ||
| data | 1720: source value based on EM - TIU REFERENCE DATE/TIME - EM > TIU REFERENCE DATE/TIME - EM - TIU ENTRY POINTER - EM > TIU DOCUMENT - REPORT TEXT (63.02-.16 > 63.49-1 > 8925-2) | HDR may be used to get the report |
| DiagnosticReportNoteElectronMicroscopyDiagnosticReport | ||
| DiagnosticReport | ||
| basedOn | Pathology.EMOrderedTest.CPRSOrderIEN,Pathology.EMOrderedTest.CPRSOrderSID | |
| status | Pathology.EMOrderedTest.DispositionLabCodeIEN,Pathology.EMOrderedTest.DispositionLabCodeSID | |
| subject | Micro.AntibioticSensitivity.LRDFN,Micro.AntibioticSensitivityComment.LRDFN,Micro.BacteriologyReports.LRDFN,Micro.MicroAntibioticLevel.LRDFN,Micro.MicroAudit.LRDFN,Micro.Microbiology.LRDFN,Micro.MicroOrderedTest.LRDFN,Micro.MicroSterilityResults.LRDFN,Micro.MycobacteriologyReports.LRDFN,Micro.Mycology.LRDFN,Micro.MycologyReports.LRDFN,Micro.Parasitology.LRDFN,Micro.ParasitologyReports.LRDFN,Micro.ParasitologyStage.LRDFN,Micro.Virology.LRDFN,Micro.VirologyReports.LRDFN,Pathology.Autopsy.LRDFN,Pathology.CytoOrganTissueFunction.StaffIEN,SStaff.SMicroOrderedTest.LRDFN | |
| effective[x] (effectiveDateTime) | Pathology.ElectronMicroscopy.SpecimenTakenDateTime,Pathology.EMComment.SpecimenTakenDateTime,Pathology.EMDelayedComment.SpecimenTakenDateTime,Pathology.EMDiagnosis.SpecimenTakenDateTime,Pathology.EMGrossDescription.SpecimenTakenDateTime,Pathology.EMMicroscopicExam.SpecimenTakenDateTime,Pathology.EMOperativeFinding.SpecimenTakenDateTime,Pathology.EMOrderedTest.SpecimenTakenDateTime,Pathology.EMOrganTissueDisease.SpecimenTakenDateTime,Pathology.EMOrganTissueEtiology.SpecimenTakenDateTime,Pathology.EMOrganTissueFunction.SpecimenTakenDateTime,Pathology.EMOrganTissueMorphology.SpecimenTakenDateTime,Pathology.EMOrganTissueProcedure.SpecimenTakenDateTime,Pathology.EMPostOpDiagnosis.SpecimenTakenDateTime,Pathology.EMPreOpDiagnosis.SpecimenTakenDateTime,Pathology.EMSpecimen.SpecimenTakenDateTime,Pathology.EMSpecimenEPON.SpecimenTakenDateTime,Pathology.EMSpecimenEPONProcedure.SpecimenTakenDateTime,Pathology.EMSupplement.SpecimenTakenDateTime,Pathology.EMSupplementDescript.SpecimenTakenDateTime,Pathology.EMTIUReference.SpecimenTakenDateTime | |
| issued | Pathology.ElectronMicroscopy.ReportCompleteDateTime | |
| performer (va-by) | Pathology.ElectronMicroscopy.ReleasedByStaffIEN,Pathology.ElectronMicroscopy.ReleasedByStaffSID | |
| performer (va-at) | Pathology.ElectronMicroscopy.ReleasingInstitutionIEN,Pathology.ElectronMicroscopy.ReleasingInstitutionSID | |
| resultsInterpreter | Pathology.ElectronMicroscopy.PathologistStaffIEN,Pathology.ElectronMicroscopy.PathologistStaffSID | |
| specimen | Pathology.ElectronMicroscopy.ElectronMicroscopyAccession | |
| DiagnosticReportNoteElectronMicroscopyDiagnosticReport | ||
| DiagnosticReport | ||
| subject | Patient.Extension[PatientExtension].VeteranLrdfn | |
| DiagnosticReportNoteElectronMicroscopyDiagnosticReport | ||
| DiagnosticReport | Event | |
| identifier | Event.identifier | |
| basedOn | Event.basedOn | |
| status | Event.status | |
| code | Event.code | |
| subject | Event.subject | |
| encounter | Event.encounter | |
| effective[x] | Event.occurrence[x] | |
| effective[x] (effectiveDateTime) | Event.occurrence[x] | |
| performer | Event.performer.actor | |
| performer (va-by) | Event.performer.actor | |
| performer (va-at) | Event.performer.actor | |
| resultsInterpreter | Event.performer.actor | |
| DiagnosticReportNoteElectronMicroscopyDiagnosticReport | ||
| DiagnosticReport | ORU -> OBR | |
| identifier | OBR-51/ for globally unique filler ID - OBR-3 , For non-globally unique filler-id the flller/placer number must be combined with the universal service Id - OBR-2(if present)+OBR-3+OBR-4 | |
| use | N/A | |
| type | CX.5 | |
| system | CX.4 / EI-2-4 | |
| value | CX.1 / EI.1 | |
| period | CX.7 + CX.8 | |
| assigner | CX.4 / (CX.4,CX.9,CX.10) | |
| basedOn | ORC? OBR-2/3? | |
| status | OBR-25 (not 1:1 mapping) | |
| category | OBR-24 | |
| category (us-core) | OBR-24 | |
| code | OBR-4 (HL7 v2 doesn't provide an easy way to indicate both the ordered test and the performed panel) | |
| coding | C*E.1-8, C*E.10-22 | |
| system | C*E.3 | |
| version | C*E.7 | |
| code | C*E.1 | |
| display | C*E.2 - but note this is not well followed | |
| userSelected | Sometimes implied by being first | |
| text | C*E.9. But note many systems use C*E.2 for this | |
| subject | PID-3 (no HL7 v2 mapping for Group or Device) | |
| encounter | PV1-19 | |
| effective[x] | OBR-7 | |
| effective[x] (effectiveDateTime) | OBR-7 | |
| issued | OBR-22 | |
| performer | PRT-8 (where this PRT-4-Participation = "PO") | |
| performer (va-by) | PRT-8 (where this PRT-4-Participation = "PO") | |
| performer (va-at) | PRT-8 (where this PRT-4-Participation = "PO") | |
| resultsInterpreter | OBR-32, PRT-8 (where this PRT-4-Participation = "PI") | |
| specimen | SPM | |
| result | OBXs | |
| media | OBX? | |
| conclusion | OBX | |
| conclusionCode | OBX | |
| presentedForm | OBX | |
| contentType | ED.2+ED.3/RP.2+RP.3. Note conversion may be needed if old style values are being used | |
| data | ED.5 | |
| url | RP.1+RP.2 - if they refer to a URL (see v2.6) | |
| DiagnosticReportNoteElectronMicroscopyDiagnosticReport | ||
| DiagnosticReport | Entity. Role, or Act, Observation[classCode=OBS, moodCode=EVN] | |
| text | Act.text? | |
| contained | N/A | |
| extension | N/A | |
| modifierExtension | N/A | |
| identifier | id | |
| id | n/a | |
| extension | n/a | |
| use | Role.code or implied by context | |
| type | Role.code or implied by context | |
| system | II.root or Role.id.root | |
| value | II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) | |
| period | Role.effectiveTime or implied by context | |
| assigner | II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper | |
| basedOn | outboundRelationship[typeCode=FLFS].target | |
| status | statusCode Note: final and amended are distinguished by whether observation is the subject of a ControlAct event of type "revise" | |
| category | inboundRelationship[typeCode=COMP].source[classCode=LIST, moodCode=EVN, code < LabService].code | |
| category (us-core) | inboundRelationship[typeCode=COMP].source[classCode=LIST, moodCode=EVN, code < LabService].code | |
| code | code | |
| id | n/a | |
| extension | n/a | |
| coding | union(., ./translation) | |
| id | n/a | |
| extension | n/a | |
| system | ./codeSystem | |
| version | ./codeSystemVersion | |
| code | ./code | |
| display | CV.displayName | |
| userSelected | CD.codingRationale | |
| text | ./originalText[mediaType/code="text/plain"]/data | |
| subject | participation[typeCode=SBJ] | |
| encounter | inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN] | |
| effective[x] | effectiveTime | |
| effective[x] (effectiveDateTime) | effectiveTime | |
| issued | participation[typeCode=VRF or AUT].time | |
| performer | .participation[typeCode=PRF] | |
| performer (va-by) | .participation[typeCode=PRF] | |
| performer (va-at) | .participation[typeCode=PRF] | |
| resultsInterpreter | .participation[typeCode=PRF] | |
| specimen | participation[typeCode=SBJ] | |
| result | outboundRelationship[typeCode=COMP].target | |
| imagingStudy | outboundRelationship[typeCode=COMP].target[classsCode=DGIMG, moodCode=EVN] | |
| media | outboundRelationship[typeCode=COMP].target | |
| id | n/a | |
| extension | n/a | |
| modifierExtension | N/A | |
| comment | .inboundRelationship[typeCode=COMP].source[classCode=OBS, moodCode=EVN, code="annotation"].value | |
| link | .value.reference | |
| conclusion | inboundRelationship[typeCode="SPRT"].source[classCode=OBS, moodCode=EVN, code=LOINC:48767-8].value (type=ST) | |
| conclusionCode | inboundRelationship[typeCode=SPRT].source[classCode=OBS, moodCode=EVN, code=LOINC:54531-9].value (type=CD) | |
| presentedForm | text (type=ED) | |
| id | n/a | |
| extension | n/a | |
| contentType | ./mediaType, ./charset | |
| language | ./language | |
| data | ./data | |
| url | ./reference/literal | |
| size | N/A (needs data type R3 proposal) | |
| hash | .integrityCheck[parent::ED/integrityCheckAlgorithm="SHA-1"] | |
| title | ./title/data | |
| creation | N/A (needs data type R3 proposal) | |
| DiagnosticReportNoteElectronMicroscopyDiagnosticReport | ||
| DiagnosticReport | ||
| identifier | FiveWs.identifier | |
| status | FiveWs.status | |
| category | FiveWs.class | |
| category (us-core) | FiveWs.class | |
| code | FiveWs.what[x] | |
| subject | FiveWs.subject[x], FiveWs.subject | |
| encounter | FiveWs.context | |
| effective[x] | FiveWs.done[x] | |
| effective[x] (effectiveDateTime) | FiveWs.done[x] | |
| issued | FiveWs.recorded | |
| performer | FiveWs.actor | |
| performer (va-by) | FiveWs.actor | |
| performer (va-at) | FiveWs.actor | |
| resultsInterpreter | FiveWs.actor | |