US Veterans Health Administration FHIR Map Set Implementation Guide
1.9.0 - 251001
US Veterans Health Administration FHIR Map Set Implementation Guide
1.9.0 - 251001
US Veterans Health Administration FHIR Map Set Implementation Guide - Downloaded Version 1.9.0 See the Directory of published versions
| Active as of 2025-09-30 |
Mappings for the EncounterInpatientEncounter 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 427 | team-approved | V2F | PTF - NUMBER (45-.001) | source value | Encounter.identifier[va-IEN] | .value | .system= http://va.gov/identifiers/$Sta3n/45 .type.text = "IEN" |
removed use=IFN typo and split of class to new mapset row | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||
| 1601 | for review | V2F | fixed value | Encounter.class | http://terminology.hl7.org/CodeSystem/v3-ActCode#IMP | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||||
| 428 | team-approved | V2F | PTF - INTERNAL ADMISSION # (45-2.1) | source value | Encounter.identifier[va-IA] | .value | .system=http://va.gov/identifiers/$Sta3n/45-2.1 .type.text = "Internal Admission #" |
http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
| 433 | team-approved | V2F | PTF - ADMISSION DATE (45-2) | fixed value | null or > now | Encounter.status | #planned | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
| 434 | team-approved | V2F | PTF - ADMISSION DATE (45-2) | fixed value | not null, < now, field 70 null | Encounter.status | #in-progress | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
| 435 | team-approved | V2F | PTF - DISCHARGE DATE (45-70) | fixed value | not null | Encounter.status | #finished | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
| 441 | team-approved | V2F | PTF - PATIENT (45-.01) | reference | Encounter.subject | /Patient | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||||
| 442 | team-approved | V2F | PTF - PROVIDER (45-79.1) | reference | Encounter.participant | .individual | /Practitioner | .type.coding = http://terminology.hl7.org/CodeSystem/v3-ParticipationType#PPRF | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||
| 445 | team-approved | V2F | PTF - ADMISSION DATE (45-2) | source value | Encounter.period | .start | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||||
| 446 | team-approved | V2F | PTF - DISCHARGE DATE (45-70) | source value | Encounter.period | .end | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||||
| 448 | team-approved | V2F | PTF - PRINCIPAL DIAGNOSIS (45-79) | source value | Encounter.reasonCode[va-principle].coding | .code | .system=termmap({VF_ICDCodingSystems,CODING SYSTEM(1.1)}) | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
| 1723 | for review | V2F | reference | Encounter.diagnosis | .condition | Condition | .rank=1 | This points to the Condition identified at #956 | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||
| 449 | team-approved | V2F | PTF - SECONDARY DIAGNOSIS 1-24 > ICD DIAGNOSIS - CODE NUMBER (45-79.* > 80-.01) | source value | Encounter.reasonCode[va-secondary].coding | .code | .system=termmap({VF_ICDCodingSystems,CODING SYSTEM(1.1)}) | *) 79.16-79.19,79.201,79.21-79.24,79.241-79.249,79.2491,79.24911-79.24915 | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||
| 450 | team-approved | V2F | PTF - PROCEDURE 1-5 > ICD OPERATION/PROCEDURE - CODE NUMBER (45-45.01+to+45.05 > 80.1-.01) | source value | Encounter.reasonCode[va-procedure].coding | .code | .system=http://www.cms.gov/Medicare/Coding/ICD10 | 45.01-45.05 | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||
| 453 | team-approved | V2F | PTF - SOURCE OF ADMISSION > SOURCE OF ADMISSION - PTF CODE (45-20 > 45.1-.01) | source value | Encounter.hospitalization.admitSource.coding | .code | .system = http://va.gov/terminology/vistaDefinedTerms/45.1 | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
| 955 | team-approved | V2F | PTF - SOURCE OF ADMISSION > SOURCE OF ADMISSION - PTF CODE (45-20 > 45.1-.01) | terminologyMaps | Encounter.hospitalization.admitSource.coding | VF_SourceOfAdmission | preferred binding | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
| 454 | team-approved | V2F | PTF - TRANSFERRING FACILITY (45-21.1) | source value | Encounter.hospitalization.origin | .display | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||||
| 455 | team-approved | V2F | PTF - RECEIVING FACILITY (45-76.1) | source value | Encounter.hospitalization.destination | .display | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||||
| 456 | team-approved | V2F | PTF - PLACE OF DISPOSITION (45-75) | source value | Encounter.hospitalization.dischargeDisposition.coding | .code | .system = http://va.gov/terminology/vistaDefinedTerms/45.6 | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
| 460 | team-approved | V2F | PTF - WARD AT DISCHARGE > WARD LOCATION - HOSPITAL LOCATION FILE POINTER (45-2.2 > 42-44) | reference | Encounter.location[va-ward].location | /Location | computed 45-2.2 is in CDW ; DIM WardLocation.SID 104.302 indirect pointer | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
| 461 | team-approved | V2F | PTF - FACILITY (45-3) | reference | Encounter.location[va-facility].location | /Location | This is the Sta3n | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | |||
| 1600 | for review | V2F | PTF - FACILITY (45-3) | reference | Encounter.serviceProvider | /Organization | http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter | 5.0.1 | ||||
| 1616 | for review | V2F | INPATIENT CPT CODE - CPT CODE > CPT (46-.01 > 81-) | source value | 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 | ||||
| 1800 | 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 | Veterans Health Information Systems Technology and Architecture (VistA) | Clinical Data Warehouse (CDW) | Summary Document Architecure (SDA) | Workflow Pattern |
|---|---|---|---|---|
  Encounter |
Event | |||
  id |
||||
 meta |
||||
| implicitRules |
||||
| language |
||||
| text |
||||
| contained |
||||
 extension |
||||
 modifierExtension |
||||
  Slices for identifier |
Event.identifier | |||
   identifier:All Slices |
||||
  id |
||||
| extension |
||||
| use |
||||
| type |
||||
| system |
||||
| value |
||||
| period |
||||
  assigner |
||||
 identifier:va-IEN |
Event.identifier | |||
 id |
||||
| extension |
||||
| use |
||||
 type |
||||
 id |
||||
| extension |
||||
| coding |
||||
 text |
fixed value = IEN mapParameter line 2 |
|||
| system |
fixed value = http://va.gov/identifiers/$Sta3n/45 mapParameter line 1 |
|||
| value |
source value based on PTF - NUMBER (45-.001) removed use=IFN typo and split of class to new mapset row |
|||
| period |
||||
 assigner |
||||
 identifier:va-IA |
Event.identifier | |||
 id |
||||
| extension |
||||
| use |
||||
| type |
||||
| id |
||||
| extension |
||||
| coding |
||||
| text |
fixed value = Internal Admission # mapParameter line 2 |
|||
| system |
fixed value = http://va.gov/identifiers/$Sta3n/45-2.1 mapParameter line 1 |
|||
| value |
source value based on PTF - INTERNAL ADMISSION # (45-2.1) |
|||
| period |
||||
| assigner |
||||
| status |
fixed value = #finished when PTF - DISCHARGE DATE (45-70) if not null |
Inpat.Census.CensusDateSID
Inpat.Census.CensusDateTime
Inpat.Census501.CensusDateTime
Inpat.Census501Diagnosis.CensusDateTime
Inpat.Census535.CensusDateTime
Inpat.CensusDiagnosis.CensusDateTime
Inpat.CensusICDProcedure.CensusDateTime
Inpat.CensusSurgicalProcedure.CensusDateTime
Inpat.Inpatient.DischargeDateTime
Inpat.Inpatient501Transaction.DischargeDateTime
Inpat.Inpatient501TransactionDiagnosis.DischargeDateTime
Inpat.Inpatient535Multiple.DischargeDateTime
Inpat.Inpatient535Transaction.DischargeDateTime
Inpat.InpatientDiagnosis.DischargeDateTime
Inpat.InpatientFeeBasis.DischargeDateTime
Inpat.InpatientFeeDiagnosis.DischargeDateTime
Inpat.InpatientICDProcedure.DischargeDateTime
Inpat.InpatientSurgicalProcedure.DischargeDateTime |
Diagnosis.ToTime |
Event.status |
| statusHistory |
||||
| id |
||||
| extension |
||||
| modifierExtension |
||||
| status |
||||
| period |
||||
| class |
fixed value = http://terminology.hl7.org/CodeSystem/v3-ActCode#IMP |
|||
| classHistory |
||||
| id |
||||
| extension |
||||
| modifierExtension |
||||
| class |
||||
| period |
||||
| type |
source value based on INPATIENT CPT CODE - CPT CODE > CPT (46-.01 > 81-) |
Inpat.InpatientCPTProcedure.CPTIEN |
Event.code | |
| id |
||||
| extension |
||||
| coding |
||||
| id |
||||
| extension |
||||
| system |
fixed value = http://www.ama-assn.org/go/cpt mapParameter line 1 |
|||
| version |
||||
| code |
source value based on INPATIENT CPT CODE - CPT CODE > CPT - CPT CODE (46-.01 > 81-.01) mapParameter line 2 |
Inpat.InpatientCPTProcedure.CPTIEN
Dim.CPT.CPTCode
Dim.CPT.CPTCode |
||
| display |
source value based on INPATIENT CPT CODE - CPT CODE > CPT - SHORT NAME (46-.01 > 81-2) mapParameter line 3 |
Inpat.InpatientCPTProcedure.CPTIEN
Dim.CPT.CPTName
Dim.CPT.CPTName |
||
| userSelected |
||||
| text |
source value based on INPATIENT CPT CODE - CPT CODE > CPT - SHORT NAME (46-.01 > 81-2) mapParameter line 4 |
Inpat.InpatientCPTProcedure.CPTIEN
Dim.CPT.CPTName
Dim.CPT.CPTName |
||
| serviceType |
Event.code | |||
| priority |
||||
| subject |
reference based on PTF - PATIENT (45-.01) |
Inpat.Census.PatientIEN
Inpat.Census501.PatientIEN
Inpat.Census501.PatientSID
Inpat.Census535.PatientIEN
Inpat.CensusDiagnosis.PatientIEN
Inpat.CensusICDProcedure.PatientIEN
Inpat.CensusSurgicalProcedure.PatientIEN
Inpat.Inpatient.PatientIEN
Inpat.Inpatient501Transaction.PatientIEN
Inpat.Inpatient535Transaction.PatientIEN
Inpat.InpatientDiagnosis.PatientIEN
Inpat.InpatientDischargeDiagnosis.PatientIEN
Inpat.InpatientFeeBasis.PatientIEN
Inpat.InpatientFeeDiagnosis.PatientIEN
Inpat.InpatientICDProcedure.PatientIEN
Inpat.InpatientSurgicalProcedure.PatientIEN
Inpat.PresentOnAdmission.PatientIEN |
Diagnosis.Diagnosis[CodeTableDetail.Diagnosis].Code |
Event.subject |
| episodeOfCare |
Event.context | |||
| basedOn |
Event.basedOn | |||
| participant |
Event.performer | |||
| id |
||||
| extension |
||||
| modifierExtension |
||||
| type |
Event.performer.function | |||
| id |
||||
| extension |
||||
| coding |
fixed value = http://terminology.hl7.org/CodeSystem/v3-ParticipationType#PPRF mapParameter line 1 |
|||
| text |
||||
| period |
target not supported |
|||
| individual |
reference based on PTF - PROVIDER (45-79.1) |
Diagnosis.DiagnosingClinician |
Event.performer.actor | |
| appointment |
Event.basedOn | |||
| period |
Event.occurrence[x] | |||
| id |
||||
| extension |
||||
| start |
source value based on PTF - ADMISSION DATE (45-2) |
Inpat.Census.AdmitDateSID
Inpat.Census.AdmitDateTime
Inpat.Census501.AdmitDateTime
Inpat.Census501Diagnosis.AdmitDateTime
Inpat.Census535.AdmitDateTime
Inpat.CensusDiagnosis.AdmitDateTime
Inpat.CensusICDProcedure.AdmitDateTime
Inpat.CensusSurgicalProcedure.AdmitDateTime
Inpat.Inpatient.AdmitDateTime
Inpat.Inpatient501Multiple.AdmitDateTime
Inpat.Inpatient501Transaction.AdmitDateTime
Inpat.Inpatient535Multiple.AdmitDateTime
Inpat.Inpatient535Transaction.AdmitDateTime
Inpat.InpatientDischargeDiagnosis.AdmitDateTime
Inpat.InpatientFeeBasis.AdmitDateTime
Inpat.InpatientFeeDiagnosis.AdmitDateTime
Inpat.InpatientICDProcedure.AdmitDateTime
Inpat.InpatientSurgicalProcedure.AdmitDateTime |
Diagnosis.FromTime |
|
| end |
source value based on PTF - DISCHARGE DATE (45-70) |
Inpat.Census.CensusDateSID
Inpat.Census.CensusDateTime
Inpat.Census501.CensusDateTime
Inpat.Census501Diagnosis.CensusDateTime
Inpat.Census535.CensusDateTime
Inpat.CensusDiagnosis.CensusDateTime
Inpat.CensusICDProcedure.CensusDateTime
Inpat.CensusSurgicalProcedure.CensusDateTime
Inpat.Inpatient.DischargeDateTime
Inpat.Inpatient501Transaction.DischargeDateTime
Inpat.Inpatient501TransactionDiagnosis.DischargeDateTime
Inpat.Inpatient535Multiple.DischargeDateTime
Inpat.Inpatient535Transaction.DischargeDateTime
Inpat.InpatientDiagnosis.DischargeDateTime
Inpat.InpatientFeeBasis.DischargeDateTime
Inpat.InpatientFeeDiagnosis.DischargeDateTime
Inpat.InpatientICDProcedure.DischargeDateTime
Inpat.InpatientSurgicalProcedure.DischargeDateTime |
Diagnosis.ToTime |
|
| length |
Event.occurrence[x] | |||
| Slices for reasonCode |
Event.reasonCode | |||
| reasonCode:va-principle |
Event.reasonCode | |||
| id |
||||
| extension |
||||
| coding |
||||
| id |
||||
| extension |
||||
| system |
fixed value = urn:see-termmap-in-mapParameter mapParameter line 1 |
|||
| version |
||||
| code |
source value based on PTF - PRINCIPAL DIAGNOSIS (45-79) |
Inpat.Inpatient.PrincipalDiagnosisICDIEN |
Diagnosis.Diagnosis
Diagnosis.DiagnosisType |
|
| display |
||||
| userSelected |
||||
| text |
||||
| reasonCode:va-secondary |
Event.reasonCode | |||
| id |
||||
| extension |
||||
| coding |
||||
| id |
||||
| extension |
||||
| system |
fixed value = urn:see-termmap-in-mapParameter mapParameter line 1 |
|||
| version |
||||
| code |
source value based on PTF - SECONDARY DIAGNOSIS 1-24 > ICD DIAGNOSIS - CODE NUMBER (45-79.* > 80-.01) *) 79.16-79.19,79.201,79.21-79.24,79.241-79.249,79.2491,79.24911-79.24915 |
Dim.ICD10.ICD10Code
Dim.ICD9.ICD9Code |
||
| display |
||||
| userSelected |
||||
| text |
||||
| reasonCode:va-procedure |
Event.reasonCode | |||
| id |
||||
| extension |
||||
| coding |
||||
| id |
||||
| extension |
||||
| system |
fixed value = http://www.cms.gov/Medicare/Coding/ICD10 mapParameter line 1 |
|||
| version |
||||
| code |
source value based on PTF - PROCEDURE 1-5 > ICD OPERATION/PROCEDURE - CODE NUMBER (45-45.01+to+45.05 > 80.1-.01) 45.01-45.05 |
Dim.ICD10Procedure.ICD10ProcedureCode
Dim.ICD9Procedure.ICD9ProcedureCode |
||
| display |
||||
| userSelected |
||||
| text |
||||
| reasonReference |
Event.reasonCode | |||
| diagnosis |
||||
| id |
||||
| extension |
||||
| modifierExtension |
||||
| condition |
reference This points to the Condition identified at #956 |
Event.reasonReference | ||
| use |
||||
| rank |
fixed value = 1 mapParameter line 1 |
|||
| account |
||||
| hospitalization |
||||
| id |
||||
| extension |
||||
| modifierExtension |
||||
| preAdmissionIdentifier |
||||
| origin |
||||
| id |
||||
| extension |
||||
| reference |
||||
| type |
||||
| identifier |
||||
| display |
source value based on PTF - TRANSFERRING FACILITY (45-21.1) |
Inpat.Census.TransferringFacility
Inpat.Inpatient.TransferFromFacility
Inpat.InpatientFeeBasis.TransferringFacility |
||
| admitSource |
||||
| id |
||||
| extension |
||||
| coding |
terminologyMaps using VF_SourceOfAdmission on PTF - SOURCE OF ADMISSION > SOURCE OF ADMISSION - PTF CODE (45-20 > 45.1-.01) preferred binding |
Inpat.Census.AdmitSourceIEN
Inpat.Inpatient.AdmitSourceIEN
Inpat.InpatientFeeBasis.AdmitSourceIEN
Dim.AdmitSource.AdmitSourceCode |
||
| id |
||||
| extension |
||||
| system |
fixed value = http://va.gov/terminology/vistaDefinedTerms/45.1 mapParameter line 1 |
|||
| version |
||||
| code |
source value based on PTF - SOURCE OF ADMISSION > SOURCE OF ADMISSION - PTF CODE (45-20 > 45.1-.01) |
Inpat.Census.AdmitSourceIEN
Inpat.Inpatient.AdmitSourceIEN
Inpat.InpatientFeeBasis.AdmitSourceIEN
Dim.AdmitSource.AdmitSourceCode |
||
| display |
||||
| userSelected |
||||
| text |
||||
| reAdmission |
||||
| dietPreference |
||||
| specialCourtesy |
||||
| specialArrangement |
||||
| destination |
||||
| id |
||||
| extension |
||||
| reference |
||||
| type |
||||
| identifier |
||||
| display |
source value based on PTF - RECEIVING FACILITY (45-76.1) |
Inpat.Census.ReceivingFacility
Inpat.Inpatient.TransferToFacility
Inpat.InpatientFeeBasis.ReceivingFacility |
||
 dischargeDisposition |
||||
| id |
||||
| extension |
||||
| coding |
||||
| id |
||||
| extension |
||||
| system |
fixed value = http://va.gov/terminology/vistaDefinedTerms/45.6 mapParameter line 1 |
|||
| version |
||||
| code |
source value based on PTF - PLACE OF DISPOSITION (45-75) |
Inpat.Census.PlaceOfDispositionIEN
Inpat.Inpatient.PlaceOfDispositionIEN
Inpat.InpatientFeeBasis.PlaceOfDispositionIEN |
||
| display |
||||
| userSelected |
||||
| text |
||||
| Slices for location |
||||
| location:All Slices |
||||
| id |
||||
| extension |
||||
| modifierExtension |
||||
| location |
Event.location | |||
| status |
||||
| physicalType |
||||
| period |
||||
| location:va-ward |
||||
| id |
||||
| extension |
||||
| modifierExtension |
||||
| location |
reference based on PTF - WARD AT DISCHARGE > WARD LOCATION - HOSPITAL LOCATION FILE POINTER (45-2.2 > 42-44) computed 45-2.2 is in CDW ; DIM WardLocation.SID 104.302 indirect pointer |
Inpat.Inpatient.Discharge45WardLocationIEN
Dim.WardLocation.LocationIEN |
Event.location | |
| status |
||||
| physicalType |
||||
| period |
||||
| location:va-facility |
||||
| id |
||||
| extension |
||||
| modifierExtension |
||||
| location |
reference based on PTF - FACILITY (45-3) This is the Sta3n |
Inpat.Census.DischargeFacility
Inpat.Inpatient.DischargeFromFacility
Inpat.InpatientFeeBasis.DischargeFacility |
Diagnosis.EnteredAt
Procedure.EnteredAt |
Event.location |
| status |
||||
| physicalType |
||||
| period |
||||
| serviceProvider |
reference based on PTF - FACILITY (45-3) |
Inpat.Census.DischargeFacility
Inpat.Inpatient.DischargeFromFacility
Inpat.InpatientFeeBasis.DischargeFacility |
Diagnosis.EnteredAt
Procedure.EnteredAt |
Event.performer.actor |
| partOf |
Event.partOf | |||
| Documentation for this format | ||||