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 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.
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 |
Location | ||
Location | ||
identifier | ||
system | 755-1: fixed value = http://va.gov/identifiers/$Sta3n/44 | generated from mapParameter line 1 |
value | 755: source value based on HOSPITAL LOCATION - IEN (44-.001) | |
status | 1278: terminologyMaps using VF_LocationStatus | Derive somehow from 44-2505 INACTIVATE 44-2506 REACTIVATE |
name | 756: source value based on HOSPITAL LOCATION - NAME (44-.01) | |
alias | 1276: source value based on HOSPITAL LOCATION - ABBREVIATION (44-1), 1277: source value based on HOSPITAL LOCATION - SYNONYM (44-13) | , |
description | 1279: source value based on HOSPITAL LOCATION - PATIENT FRIENDLY NAME (44-60) | |
mode | 1806: fixed value = #instance | Added 4/5/24 to match LH PHAPI |
type | ||
coding | ||
system | 1412-1: fixed value = http://va.gov/terminology/VistADefinedTerms/44-9 | generated from mapParameter line 1 |
code | 1412: source value based on HOSPITAL LOCATION - SERVICE (44-9) | |
type (va-stop-code) | ||
coding | ||
system | 2039-1: fixed value = http://va.gov/terminology/VistADefinedTerms/44-8 | generated from mapParameter line 1 |
code | 2039: source value based on HOSPITAL LOCATION - STOP CODE NUMBER (44-8) | added stop codes to support BTSSS |
type (va-credit-code) | ||
coding | ||
system | 2040-1: fixed value = http://va.gov/terminology/VistADefinedTerms/44-2503 | generated from mapParameter line 1 |
code | 2040: source value based on HOSPITAL LOCATION - CREDIT STOP CODE (44-2503) | added stop codes to support BTSSS |
telecom | ||
system | 1280-1: fixed value = #phone | generated from mapParameter line 1 |
value | 1280: transform using concat (44-99," ext. ",44-99.1) on HOSPITAL LOCATION - TELEPHONE (44-99) | |
use | 1280-2: fixed value = #work | generated from mapParameter line 2 |
address | ||
type | 1322: fixed value = #physical when HOSPITAL LOCATION - INSTITUTION (44-3) | |
line | 1317: 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) | , |
city | 1319: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - CITY (44-3 > 4-1.03) | |
district | 1316: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - DISTRICT (44-3 > 4-.03) | |
state | 1315: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - STATE > STATE - ABBREVIATION (44-3 > 4-.02 > 5-1) | |
postalCode | 1320: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - ZIP (44-3 > 4-1.04) | |
country | 1405: source value based on HOSPITAL LOCATION - INSTITUTION > INSTITUTION - COUNTRY > COUNTRY CODE - CODE (44-3 > 4-801 > 779.004-.01) | |
physicalType | ||
text | 1284: source value based on HOSPITAL LOCATION - PHYSICAL LOCATION (44-10) | |
managingOrganization | ||
display | 1283: fixed value = "Veterans Administration" |
Location | ||
Location | ||
name | Dim.Location.LocationName,Dim.Location.LocationName | |
alias | Dim.Location.LocationAbbreviation,Dim.Location.LocationAbbreviation | |
description | Dim.Location.PatientFriendlyLocationName,Dim.Location.PatientFriendlyLocationName | |
type | ||
coding | ||
code | Dim.Location.MedicalService,Dim.Location.MedicalService | |
type (va-stop-code) | ||
coding | ||
code | Dim.Location.PrimaryStopCodeIEN | |
type (va-credit-code) | ||
coding | ||
code | Dim.Location.SecondaryStopCodeIEN | |
telecom | ||
value | Dim.Location.PhoneNumber,Dim.Location.PhoneNumber | |
address | ||
type | Dim.Location.InstitutionIEN | |
line | Dim.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 | |
city | Dim.Location.InstitutionIEN Dim.Institution.City,Dim.Institution.City,Dim.InstitutionTimeZone.City,NDim.MVIInstitution.City | |
district | Dim.Location.InstitutionIEN Dim.Institution.MedicalDistrict,Dim.Institution.MedicalDistrict,NDim.MVIInstitution.MedicalDistrict | |
state | Dim.Location.InstitutionIEN | |
postalCode | Dim.Location.InstitutionIEN Dim.Institution.Zip,Dim.Institution.Zip,Dim.InstitutionTimeZone.Zip,NDim.MVIInstitution.Zip | |
country | Dim.Location.InstitutionIEN | |
physicalType | ||
text | Dim.Location.PhysicalLocation,Dim.Location.PhysicalLocation |
Location | ||
Location | Entity. Role, or Act, .Role[classCode=SDLC] | |
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 | |
status | .statusCode | |
operationalStatus | n/a | |
name | .name | |
alias | .name | |
description | .playingEntity[classCode=PLC determinerCode=INSTANCE].desc | |
mode | .playingEntity[classCode=PLC].determinerCode | |
type | .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 | |
type (va-stop-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 | |
type (va-credit-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 | |
telecom | .telecom | |
id | n/a | |
extension | n/a | |
system | ./scheme | |
value | ./url | |
use | unique(./use) | |
rank | n/a | |
period | ./usablePeriod[type="IVL<TS>"] | |
address | .addr | |
id | n/a | |
extension | n/a | |
use | unique(./use) | |
type | unique(./use) | |
text | ./formatted | |
line | AD.part[parttype = AL] | |
city | AD.part[parttype = CTY] | |
district | AD.part[parttype = CNT | CPA] | |
state | AD.part[parttype = STA] | |
postalCode | AD.part[parttype = ZIP] | |
country | AD.part[parttype = CNT] | |
period | ./usablePeriod[type="IVL<TS>"] | |
physicalType | .playingEntity [classCode=PLC].code | |
id | n/a | |
extension | n/a | |
coding | union(., ./translation) | |
text | ./originalText[mediaType/code="text/plain"]/data | |
position | .playingEntity [classCode=PLC determinerCode=INSTANCE].positionText | |
id | n/a | |
extension | n/a | |
modifierExtension | N/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] | |
id | n/a | |
extension | n/a | |
reference | N/A | |
type | N/A | |
identifier | .identifier | |
display | N/A | |
partOf | .inboundLink[typeCode=PART].source[classCode=SDLC] | |
hoursOfOperation | .effectiveTime | |
id | n/a | |
extension | n/a | |
modifierExtension | N/A | |
daysOfWeek | .effectiveTime | |
allDay | .effectiveTime | |
openingTime | .effectiveTime | |
closingTime | .effectiveTime | |
availabilityExceptions | n/a | |
endpoint | n/a |
Location | ||
Location | ||
identifier | FiveWs.identifier | |
status | FiveWs.status | |
operationalStatus | FiveWs.status | |
mode | FiveWs.class | |
type | FiveWs.class | |
type (va-stop-code) | FiveWs.class | |
type (va-credit-code) | FiveWs.class | |
physicalType | FiveWs.class |