US Veterans Health Administration FHIR Map Set Implementation Guide
1.8.0 - 250901
US Veterans Health Administration FHIR Map Set Implementation Guide - Downloaded Version 1.8.0 See the Directory of published versions
Active as of 2025-09-02 |
Mappings for the EncounterOutpatient resource profile.
Scroll down for the Raw FHIR, CDW & SDA mappings (if any).
Note that the CDW, SDA and VPR XML mappings are derived from a look-up based on the VistA source.
key | status | direction | source | mapApproach | mapCase | FHIR Path | subPath | mapValue | mapParameter | mapComment | FHIR URL | Ver |
---|---|---|---|---|---|---|---|---|---|---|---|
429 | team-approved | V2F | VISIT - VISIT ID (9000010-15001) | source value | Encounter.identifier[va-visitid] | .value | .system=http://va.gov/identifiers/$Sta3n/9000010-15001 | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
430 | team-approved | V2F | VISIT - VISIT/ADMIT DATE&TIME (9000010-.01) | fixed value | IMP, null or > now | Encounter.status | #planned | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
431 | team-approved | V2F | VISIT - VISIT/ADMIT DATE&TIME (9000010-.01) | fixed value | IMP, not null, < now, .18 null | Encounter.status | #in-progress | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
432 | team-approved | V2F | VISIT - CHECK OUT DATE&TIME (9000010-.18) | fixed value | IMP, not null, < now | Encounter.status | #finished | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
2035 | for review | V2F | OUTPATIENT ENCOUNTER - APPOINTMENT TYPE > APPOINTMENT TYPE - NAME (409.68-.1 > 409.1-.01) | fixed value | {.03>9000010} SERVICE CONNECTED | Encounter.extension[http://va.gov/fhir/StructureDefinition/resource-serviceConnection].valueCoding | http://va.gov/fhir/vistaDefinedTerms/409.1#SC "Service Connected" | Outpatient Encounter points to Visit (409.68-.05) | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||
2036 | for review | V2F | OUTPATIENT ENCOUNTER - APPOINTMENT TYPE > APPOINTMENT TYPE - NAME (409.68-.1 > 409.1-.01) | fixed value | {.03>9000010} Not SERVICE CONNECTED | Encounter.extension[http://va.gov/fhir/StructureDefinition/resource-serviceConnection].valueCoding | http://va.gov/fhir/vistaDefinedTerms/409.1#NSC "Not Service Connected" | Outpatient Encounter points to Visit (409.68-.05) | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||
439 | team-approved | V2F | VISIT - SERVICE CATEGORY (9000010-.07) | source value | Encounter.serviceType.coding | .code | .system=http://va.gov/terminology/VistADefinedTerms/9000010-.07 | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
440 | team-approved | V2F | VISIT - PATIENT NAME > PATIENT/IHS - NAME (9000010-.05 > 9000001-.01) | reference | Encounter.subject | /Patient | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||||
443 | team-approved | V2F | VISIT - VISIT/ADMIT DATE&TIME (9000010-.01) | source value | Encounter.period | .start | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||||
444 | team-approved | V2F | VISIT - CHECK OUT DATE&TIME (9000010-.18) | source value | Encounter.period | .end | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||||
447 | team-approved | V2F | V POV - POV > ICD DIAGNOSIS - CODE NUMBER (9000010.07-.01 > 80-.01) | source value | {.03>9000010} 9000010.07-.12 = 'P' | Encounter.reasonCode.coding | .code | .system=termmap({VF_ICDCodingSystems,CODING SYSTEM(1.1)}) | do we need visit in col e and pov in col g? | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |
452 | team-approved | V2F | V POV - PROBLEM LIST ENTRY (9000010.07-.16) | reference | {.03>9000010} | Encounter.diagnosis.condition | /ConditionEncounterDiagnosis | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
2030 | for review | V2F | target not supported | Encounter.hospitalization | because of must-support: Outpatient so no hospitalization | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||||
458 | team-approved | V2F | VISIT - DSS ID (9000010-.08) | reference | Encounter.location[va-stop].location | /Location | Stop Code | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
459 | team-approved | V2F | VISIT - HOSPITAL LOCATION (9000010-.22) | reference | Encounter.location[va-loc].location | /Location | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||||
614 | for review | V2F | VISIT - PATIENT STATUS IN/OUT (9000010-15002) | terminologyMaps | Encounter.class | VF_encounterClass | 84% are Outpatient (2024 Jan-Mar) | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
1599 | for review | V2F | VISIT - LOC. OF ENCOUNTER > LOCATION - NAME > INSTITUTION (9000010-.06 > 9999999.06-.01 > 4) | reference | Encounter.serviceProvider | /Organization | .display = {NAME (.01)} .identifier = {STATION NUMBER (99)} .identifier.system = http://va.gov/identifiers/4-99 |
http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
1614 | for review | V2F | V PROVIDER - PROVIDER > NEW PERSON (9000010.06-.01 > 200-) | reference | {.03>9000010} | Encounter.participant | .individual | /PractitionerRole | code in ProviderRole; name and id in Reference to Provider | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |
1854 | for review | V2F | V PROVIDER - PRIMARY/SECONDARY (9000010.06-.04) | terminologyMaps | {.03>9000010} | Encounter.participant | .type | VF_encounterParticipationType | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||
1615 | for review | V2F | V CPT - CPT > CPT (9000010.18-.01 > 81-) | source value | {.03>9000010} Not admission record (rule not needed in examples we've seen) | Encounter.type | .coding.system=http://www.ama-assn.org/go/cpt .coding.code = {CPT CODE (.01)} .coding.display = {SHORT NAME (2)} .text = {SHORT NAME (2)} |
http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
1799 | for review | V2F | target not supported | Encounter.participant.period | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 |
No Mappings Found
No Mappings Found
Name | Workflow Pattern | RIM Mapping | FiveWs Pattern Mapping | HL7 v2 Mapping![]() |
---|---|---|---|---|
![]() ![]() |
Event |
Encounter[@moodCode='EVN'] |
||
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
Act.text? |
|||
![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() |
Event.identifier |
.id |
FiveWs.identifier |
PV1-19 |
![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
Role.code or implied by context |
N/A | ||
![]() ![]() ![]() ![]() ![]() |
Role.code or implied by context |
CX.5 | ||
![]() ![]() ![]() ![]() ![]() |
II.root or Role.id.root |
CX.4 / EI-2-4 | ||
![]() ![]() ![]() ![]() ![]() |
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) |
CX.1 / EI.1 | ||
![]() ![]() ![]() ![]() ![]() |
Role.effectiveTime or implied by context |
CX.7 + CX.8 | ||
![]() ![]() ![]() ![]() ![]() |
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper |
| ||
![]() ![]() ![]() ![]() |
Event.identifier |
.id |
FiveWs.identifier |
PV1-19 |
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
Role.code or implied by context |
N/A | ||
![]() ![]() ![]() ![]() ![]() |
Role.code or implied by context |
CX.5 | ||
![]() ![]() ![]() ![]() ![]() |
II.root or Role.id.root |
CX.4 / EI-2-4 | ||
![]() ![]() ![]() ![]() ![]() |
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) |
CX.1 / EI.1 | ||
![]() ![]() ![]() ![]() ![]() |
Role.effectiveTime or implied by context |
CX.7 + CX.8 | ||
![]() ![]() ![]() ![]() ![]() |
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper |
| ||
![]() ![]() ![]() |
Event.status |
.statusCode |
FiveWs.status |
|
![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() |
.inboundRelationship[typeCode=SUBJ].source[classCode=LIST].code |
FiveWs.class |
PV1-2 | |
![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() |
Event.code |
.code |
FiveWs.class |
PV1-4 / PV1-18 |
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
|
| ||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
./codeSystem |
C*E.3 | ||
![]() ![]() ![]() ![]() ![]() |
./codeSystemVersion |
C*E.7 | ||
![]() ![]() ![]() ![]() ![]() |
./code |
C*E.1 | ||
![]() ![]() ![]() ![]() ![]() |
CV.displayName |
C*E.2 - but note this is not well followed | ||
![]() ![]() ![]() ![]() ![]() |
CD.codingRationale |
Sometimes implied by being first | ||
![]() ![]() ![]() ![]() |
./originalText[mediaType/code="text/plain"]/data |
C*E.9. But note many systems use C*E.2 for this | ||
![]() ![]() ![]() |
Event.code |
n/a |
PV1-10 | |
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
|
| ||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
./codeSystem |
C*E.3 | ||
![]() ![]() ![]() ![]() ![]() |
./codeSystemVersion |
C*E.7 | ||
![]() ![]() ![]() ![]() ![]() |
./code |
C*E.1 | ||
![]() ![]() ![]() ![]() ![]() |
CV.displayName |
C*E.2 - but note this is not well followed | ||
![]() ![]() ![]() ![]() ![]() |
CD.codingRationale |
Sometimes implied by being first | ||
![]() ![]() ![]() ![]() |
./originalText[mediaType/code="text/plain"]/data |
C*E.9. But note many systems use C*E.2 for this | ||
![]() ![]() ![]() |
.priorityCode |
FiveWs.grade |
PV2-25 | |
![]() ![]() ![]() |
Event.subject |
.participation[typeCode=SBJ]/role[classCode=PAT] |
FiveWs.subject |
PID-3 |
![]() ![]() ![]() |
Event.context |
n/a |
FiveWs.context |
|
![]() ![]() ![]() |
Event.basedOn |
.reason.ClinicalDocument |
||
![]() ![]() ![]() |
Event.performer |
.participation[typeCode=PFM] |
ROL | |
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() |
Event.performer.function |
.functionCode |
ROL-3 (or maybe PRT-4) | |
![]() ![]() ![]() ![]() |
.time |
| ||
![]() ![]() ![]() ![]() |
Event.performer.actor |
.role |
FiveWs.who |
ROL-4 |
![]() ![]() ![]() |
Event.basedOn |
|
SCH-1 / SCH-2 | |
![]() ![]() ![]() |
Event.occurrence[x] |
.effectiveTime (low & high) |
FiveWs.done[x] |
|
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
./low |
DR.1 | ||
![]() ![]() ![]() ![]() |
./high |
DR.2 | ||
![]() ![]() ![]() |
Event.occurrence[x] |
.lengthOfStayQuantity |
(PV1-45 less PV1-44) iff ( (PV1-44 not empty) and (PV1-45 not empty) ); units in minutes | |
![]() ![]() ![]() |
Event.reasonCode |
.reasonCode |
FiveWs.why[x] |
PV2-3 is nominally constrained to inpatient admissions; HL7 v2 makes no vocabulary suggestions for PV2-3; would not expect PV2 segment or PV2-3 to be in use in all implementations ) |
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
|
| ||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
./codeSystem |
C*E.3 | ||
![]() ![]() ![]() ![]() ![]() |
./codeSystemVersion |
C*E.7 | ||
![]() ![]() ![]() ![]() ![]() |
./code |
C*E.1 | ||
![]() ![]() ![]() ![]() ![]() |
CV.displayName |
C*E.2 - but note this is not well followed | ||
![]() ![]() ![]() ![]() ![]() |
CD.codingRationale |
Sometimes implied by being first | ||
![]() ![]() ![]() ![]() |
./originalText[mediaType/code="text/plain"]/data |
C*E.9. But note many systems use C*E.2 for this | ||
![]() ![]() ![]() |
Event.reasonCode |
.reasonCode |
FiveWs.why[x] |
PV2-3 is nominally constrained to inpatient admissions; HL7 v2 makes no vocabulary suggestions for PV2-3; would not expect PV2 segment or PV2-3 to be in use in all implementations ) |
![]() ![]() ![]() |
.outboundRelationship[typeCode=RSON] |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() |
Event.reasonReference |
.outboundRelationship[typeCode=RSON].target |
FiveWs.why[x] |
Resources that would commonly referenced at Encounter.indication would be Condition and/or Procedure. These most closely align with DG1/PRB and PR1 respectively. |
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
.outboundRelationship[typeCode=RSON].priority |
|||
![]() ![]() ![]() |
.pertains.A_Account |
|||
![]() ![]() ![]() |
|
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() |
.id |
PV1-5 | ||
![]() ![]() ![]() ![]() |
.participation[typeCode=ORG].role |
|||
![]() ![]() ![]() ![]() |
.admissionReferralSourceCode |
PV1-14 | ||
![]() ![]() ![]() ![]() |
n/a |
PV1-13 | ||
![]() ![]() ![]() ![]() |
|
PV1-38 | ||
![]() ![]() ![]() ![]() |
.specialCourtesiesCode |
PV1-16 | ||
![]() ![]() ![]() ![]() |
.specialArrangementCode |
PV1-15 / OBR-30 / OBR-43 | ||
![]() ![]() ![]() ![]() |
.participation[typeCode=DST] |
PV1-37 | ||
![]() ![]() ![]() ![]() |
.dischargeDispositionCode |
PV1-36 | ||
![]() ![]() ![]() |
.participation[typeCode=LOC] |
|||
![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() ![]() |
Event.location |
.role |
FiveWs.where[x] |
PV1-3 / PV1-6 / PV1-11 / PV1-42 / PV1-43 |
![]() ![]() ![]() ![]() ![]() |
.role.statusCode |
|||
![]() ![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
.time |
|||
![]() ![]() ![]() ![]() |
.participation[typeCode=LOC] |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() ![]() |
Event.location |
.role |
FiveWs.where[x] |
PV1-3 / PV1-6 / PV1-11 / PV1-42 / PV1-43 |
![]() ![]() ![]() ![]() ![]() |
.role.statusCode |
|||
![]() ![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
.time |
|||
![]() ![]() ![]() ![]() |
.participation[typeCode=LOC] |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() ![]() |
Event.location |
.role |
FiveWs.where[x] |
PV1-3 / PV1-6 / PV1-11 / PV1-42 / PV1-43 |
![]() ![]() ![]() ![]() ![]() |
.role.statusCode |
|||
![]() ![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
.time |
|||
![]() ![]() ![]() |
Event.performer.actor |
.particiaption[typeCode=PFM].role |
PL.6 & PL.1 | |
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() |
.identifier |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
Role.code or implied by context |
N/A | ||
![]() ![]() ![]() ![]() ![]() |
Role.code or implied by context |
CX.5 | ||
![]() ![]() ![]() ![]() ![]() |
II.root or Role.id.root |
CX.4 / EI-2-4 | ||
![]() ![]() ![]() ![]() ![]() |
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) |
CX.1 / EI.1 | ||
![]() ![]() ![]() ![]() ![]() |
Role.effectiveTime or implied by context |
CX.7 + CX.8 | ||
![]() ![]() ![]() ![]() ![]() |
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper |
| ||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() |
Event.partOf |
|
||
![]() |