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: Location - Mappings

Active as of 2025-03-31

Mappings for the Location 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: Location (Source)INSTITUTION (4).02STATE.03DISTRICT1.01STREET ADDR. 11.02STREET ADDR. 21.03CITY1.04ZIP801COUNTRYSTATE (5)1ABBREVIATIONHOSPITAL LOCATION (44).001IEN.01NAME1ABBREVIATION3INSTITUTION8STOP CODE NUMBER9SERVICE10PHYSICAL LOCATION13SYNONYM60PATIENT FRIENDLY NAME99TELEPHONE2503CREDIT STOP CODECOUNTRY CODE (779.004).01CODE

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
755 for review V2F HOSPITAL LOCATION - IEN (44-.001) source value Location.identifier .value .system=http://va.gov/identifiers/$Sta3n/44 http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
755-1 for review V2F fixed value Location.identifier .system http://va.gov/identifiers/$Sta3n/44 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
756 for review V2F HOSPITAL LOCATION - NAME (44-.01) source value Location.name http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1276 for review V2F HOSPITAL LOCATION - ABBREVIATION (44-1) source value Location.alias http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1277 for review V2F HOSPITAL LOCATION - SYNONYM (44-13) source value Location.alias http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1278 for review VST2F Lookup from VAST system terminologyMaps Location.status VF_LocationStatus Derive somehow from 44-2505 INACTIVATE 44-2506 REACTIVATE Or use VAST, not ViSTA. http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1279 for review V2F HOSPITAL LOCATION - PATIENT FRIENDLY NAME (44-60) source value Location.description http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1280 for review V2F HOSPITAL LOCATION - TELEPHONE (44-99) transform Location.telecom .value concat (44-99," ext. ",44-99.1) .system=#phone
.use=#work
http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1280-1 for review V2F fixed value Location.telecom .system #phone generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1280-2 for review V2F fixed value Location.telecom .use #work generated from mapParameter line 2 http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1283 for review V2F fixed value Location.managingOrganization .display "Veterans Administration" http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1284 for review V2F HOSPITAL LOCATION - PHYSICAL LOCATION (44-10) source value Location.physicalType .text http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1315 for review V2F HOSPITAL LOCATION - INSTITUTION > INSTITUTION - STATE > STATE - ABBREVIATION (44-3 > 4-.02 > 5-1) source value Location.address .state http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1316 for review V2F HOSPITAL LOCATION - INSTITUTION > INSTITUTION - DISTRICT (44-3 > 4-.03) source value Location.address .district http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1317 for review V2F HOSPITAL LOCATION - INSTITUTION > INSTITUTION - STREET ADDR. 1 (44-3 > 4-1.01) source value Location.address .line http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1318 for review V2F HOSPITAL LOCATION - INSTITUTION > INSTITUTION - STREET ADDR. 2 (44-3 > 4-1.02) source value Location.address .line http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1319 for review V2F HOSPITAL LOCATION - INSTITUTION > INSTITUTION - CITY (44-3 > 4-1.03) source value Location.address .city http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1320 for review V2F HOSPITAL LOCATION - INSTITUTION > INSTITUTION - ZIP (44-3 > 4-1.04) source value Location.address .postalCode http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1405 for review V2F HOSPITAL LOCATION - INSTITUTION > INSTITUTION - COUNTRY > COUNTRY CODE - CODE (44-3 > 4-801 > 779.004-.01) source value Location.address .country http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1322 for review V2F HOSPITAL LOCATION - INSTITUTION (44-3) fixed value Location.address .type #physical http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1412 for review V2F HOSPITAL LOCATION - SERVICE (44-9) source value Location.type.coding .code .system=http://va.gov/terminology/VistADefinedTerms/44-9 http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1412-1 for review V2F fixed value Location.type.coding .system http://va.gov/terminology/VistADefinedTerms/44-9 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
1806 for review V2F fixed value Location.mode #instance Added 4/5/24 to match LH PHAPI http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
2039 for review V2F HOSPITAL LOCATION - STOP CODE NUMBER (44-8) source value Location.type[va-stop-code].coding .code .system=http://va.gov/terminology/VistADefinedTerms/44-8 added stop codes to support BTSSS http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
2039-1 for review V2F fixed value Location.type[va-stop-code].coding .system http://va.gov/terminology/VistADefinedTerms/44-8 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
2040 for review V2F HOSPITAL LOCATION - CREDIT STOP CODE (44-2503) source value Location.type[va-credit-code].coding .code .system=http://va.gov/terminology/VistADefinedTerms/44-2503 added stop codes to support BTSSS http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1
2040-1 for review V2F fixed value Location.type[va-credit-code].coding .system http://va.gov/terminology/VistADefinedTerms/44-2503 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-location | 5.0.1

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

Location
Location
   identifier
      system755-1: fixed value = http://va.gov/identifiers/$Sta3n/44

generated from mapParameter line 1

      value755: source value based on HOSPITAL LOCATION - IEN (44-.001)
   status1278: terminologyMaps using VF_LocationStatus

Derive somehow from 44-2505 INACTIVATE 44-2506 REACTIVATE
Or use VAST, not ViSTA.

   name756: source value based on HOSPITAL LOCATION - NAME (44-.01)
   alias1276: source value based on HOSPITAL LOCATION - ABBREVIATION (44-1), 1277: source value based on HOSPITAL LOCATION - SYNONYM (44-13),
   description1279: source value based on HOSPITAL LOCATION - PATIENT FRIENDLY NAME (44-60)
   mode1806: fixed value = #instance

Added 4/5/24 to match LH PHAPI

   type
      coding
         system1412-1: fixed value = http://va.gov/terminology/VistADefinedTerms/44-9

generated from mapParameter line 1

         code1412: source value based on HOSPITAL LOCATION - SERVICE (44-9)
   type (va-stop-code)
      coding
         system2039-1: fixed value = http://va.gov/terminology/VistADefinedTerms/44-8

generated from mapParameter line 1

         code2039: source value based on HOSPITAL LOCATION - STOP CODE NUMBER (44-8)

added stop codes to support BTSSS

   type (va-credit-code)
      coding
         system2040-1: fixed value = http://va.gov/terminology/VistADefinedTerms/44-2503

generated from mapParameter line 1

         code2040: source value based on HOSPITAL LOCATION - CREDIT STOP CODE (44-2503)

added stop codes to support BTSSS

   telecom
      system1280-1: fixed value = #phone

generated from mapParameter line 1

      value1280: transform using concat (44-99," ext. ",44-99.1) on HOSPITAL LOCATION - TELEPHONE (44-99)
      use1280-2: fixed value = #work

generated from mapParameter line 2

   address
      type1322: fixed value = #physical when HOSPITAL LOCATION - INSTITUTION (44-3)
      line1317: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - STREET ADDR. 1 (44-3 > 4-1.01), 1318: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - STREET ADDR. 2 (44-3 > 4-1.02),
      city1319: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - CITY (44-3 > 4-1.03)
      district1316: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - DISTRICT (44-3 > 4-.03)
      state1315: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - STATE > STATE - ABBREVIATION (44-3 > 4-.02 > 5-1)
      postalCode1320: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - ZIP (44-3 > 4-1.04)
      country1405: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - COUNTRY > COUNTRY CODE - CODE (44-3 > 4-801 > 779.004-.01)
   physicalType
      text1284: source value based on HOSPITAL LOCATION - PHYSICAL LOCATION (44-10)
   managingOrganization
      display1283: fixed value = "Veterans Administration"

Mappings for Clinical Data Warehouse (CDW) ()

Location
Location
   nameDim.Location.LocationName,Dim.Location.LocationName
   aliasDim.Location.LocationAbbreviation,Dim.Location.LocationAbbreviation
   descriptionDim.Location.PatientFriendlyLocationName,Dim.Location.PatientFriendlyLocationName
   type
      coding
         codeDim.Location.MedicalService,Dim.Location.MedicalService
   type (va-stop-code)
      coding
         codeDim.Location.PrimaryStopCodeIEN
   type (va-credit-code)
      coding
         codeDim.Location.SecondaryStopCodeIEN
   telecom
      valueDim.Location.PhoneNumber,Dim.Location.PhoneNumber
   address
      typeDim.Location.InstitutionIEN
      lineDim.Location.InstitutionIEN Dim.Institution.StreetAddress1,Dim.Institution.StreetAddress1,Dim.InstitutionTimeZone.StreetAddress1,NDim.MVIInstitution.StreetAddress1, Dim.Location.InstitutionIEN Dim.Institution.StreetAddress2,Dim.Institution.StreetAddress2,Dim.InstitutionTimeZone.StreetAddress2,NDim.MVIInstitution.StreetAddress2
      cityDim.Location.InstitutionIEN Dim.Institution.City,Dim.Institution.City,Dim.InstitutionTimeZone.City,NDim.MVIInstitution.City
      districtDim.Location.InstitutionIEN Dim.Institution.MedicalDistrict,Dim.Institution.MedicalDistrict,NDim.MVIInstitution.MedicalDistrict
      stateDim.Location.InstitutionIEN
      postalCodeDim.Location.InstitutionIEN Dim.Institution.Zip,Dim.Institution.Zip,Dim.InstitutionTimeZone.Zip,NDim.MVIInstitution.Zip
      countryDim.Location.InstitutionIEN
   physicalType
      textDim.Location.PhysicalLocation,Dim.Location.PhysicalLocation

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

Location
LocationEntity. Role, or Act, .Role[classCode=SDLC]
   textAct.text?
   containedN/A
   extensionN/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
   status.statusCode
   operationalStatusn/a
   name.name
   alias.name
   description.playingEntity[classCode=PLC determinerCode=INSTANCE].desc
   mode.playingEntity[classCode=PLC].determinerCode
   type.code
      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
   type (va-stop-code).code
      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
   type (va-credit-code).code
      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
   telecom.telecom
      idn/a
      extensionn/a
      system./scheme
      value./url
      useunique(./use)
      rankn/a
      period./usablePeriod[type="IVL<TS>"]
   address.addr
      idn/a
      extensionn/a
      useunique(./use)
      typeunique(./use)
      text./formatted
      lineAD.part[parttype = AL]
      cityAD.part[parttype = CTY]
      districtAD.part[parttype = CNT | CPA]
      stateAD.part[parttype = STA]
      postalCodeAD.part[parttype = ZIP]
      countryAD.part[parttype = CNT]
      period./usablePeriod[type="IVL<TS>"]
   physicalType.playingEntity [classCode=PLC].code
      idn/a
      extensionn/a
      codingunion(., ./translation)
      text./originalText[mediaType/code="text/plain"]/data
   position.playingEntity [classCode=PLC determinerCode=INSTANCE].positionText
      idn/a
      extensionn/a
      modifierExtensionN/A
      longitude(RIM Opted not to map the sub-elements of GPS location, is now an OBS)
      latitude(RIM Opted not to map the sub-elements of GPS location, is now an OBS)
      altitude(RIM Opted not to map the sub-elements of GPS location, is now an OBS)
   managingOrganization.scopingEntity[classCode=ORG determinerKind=INSTANCE]
      idn/a
      extensionn/a
      referenceN/A
      typeN/A
      identifier.identifier
      displayN/A
   partOf.inboundLink[typeCode=PART].source[classCode=SDLC]
   hoursOfOperation.effectiveTime
      idn/a
      extensionn/a
      modifierExtensionN/A
      daysOfWeek.effectiveTime
      allDay.effectiveTime
      openingTime.effectiveTime
      closingTime.effectiveTime
   availabilityExceptionsn/a
   endpointn/a

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

Location
Location
   identifierFiveWs.identifier
   statusFiveWs.status
   operationalStatusFiveWs.status
   modeFiveWs.class
   typeFiveWs.class
   type (va-stop-code)FiveWs.class
   type (va-credit-code)FiveWs.class
   physicalTypeFiveWs.class