US Veterans Health Administration FHIR Map Set Implementation Guide
1.9.0 - 251001 United States of America flag

US Veterans Health Administration FHIR Map Set Implementation Guide - Downloaded Version 1.9.0 See the Directory of published versions

Resource Profile: Organization - Mappings

Active as of 2025-09-30

Mappings for the Organization 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.

Mapping Sources

Use Case: Organization (Source)Use Case: Organization (Source)INSTITUTION (4).01NAME.02STATE.03DISTRICT.05SHORT NAME1.01STREET ADDR. 11.02STREET ADDR. 21.03CITY1.04ZIP4CONTACT4.01ST. ADDR. 1 (MAILING)4.02ST. ADDR. 2 (MAILING)4.03CITY (MAILING)4.04STATE (MAILING)4.05ZIP (MAILING)41.99NPI801COUNTRYSTATE (5)1ABBREVIATIONCOUNTRY CODE (779.004).01CODECONTACT (4.03).01CONTACT.03PHONE #

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
1251 for review V2F INSTITUTION - NAME (4-.01) source value Organization.name http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1252 for review V2F INSTITUTION - NPI (4-41.99) source value Organization.identifier[NPI] .value .system=http://hl7.org/fhir/sid/us-npi http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1253 for review V2F fixed value Organization.active true http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1254 for review V2F fixed value Organization.type http://terminology.hl7.org/CodeSystem/organization-type#prov http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1255 for review V2F INSTITUTION - SHORT NAME (4-.05) source value Organization.alias http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1257 for review V2F fixed value Organization.address[va-physical] .type #physical http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1258 for review V2F INSTITUTION - STREET ADDR. 1 (4-1.01) source value Organization.address[va-physical] .line http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1259 for review V2F INSTITUTION - STREET ADDR. 2 (4-1.02) source value Organization.address[va-physical] .line http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1260 for review V2F INSTITUTION - CITY (4-1.03) source value Organization.address[va-physical] .city http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1261 for review V2F INSTITUTION - DISTRICT (4-.03) source value Organization.address[va-physical] .district http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1262 for review V2F INSTITUTION - STATE > STATE - ABBREVIATION (4-.02 > 5-1) source value Organization.address[va-physical] .state http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1263 for review V2F INSTITUTION - ZIP (4-1.04) source value Organization.address[va-physical] .postalCode http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1264 for review V2F INSTITUTION - COUNTRY > COUNTRY CODE - CODE (4-801 > 779.004-.01) source value Organization.address[va-physical] .country http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1265 for review V2F INSTITUTION - CONTACT > CONTACT - CONTACT (4-4 > 4.03-.01) source value Organization.contact.name .text http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1266 for review V2F INSTITUTION - CONTACT > CONTACT - PHONE # (4-4 > 4.03-.03) source value Organization.contact.telecom .value .system=#phone http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1268 for review V2F fixed value Organization.address[va-postal] .type #postal http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1269 for review V2F INSTITUTION - ST. ADDR. 1 (MAILING) (4-4.01) source value Organization.address[va-postal] .line http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1270 for review V2F INSTITUTION - ST. ADDR. 2 (MAILING) (4-4.02) source value Organization.address[va-postal] .line http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1271 for review V2F INSTITUTION - CITY (MAILING) (4-4.03) source value Organization.address[va-postal] .city http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1272 for review V2F INSTITUTION - STATE (MAILING) (4-4.04) source value Organization.address[va-postal] .state http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1273 for review V2F INSTITUTION - ZIP (MAILING) (4-4.05) source value Organization.address[va-postal] .postalCode http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1274 for review V2F INSTITUTION - COUNTRY > COUNTRY CODE - CODE (4-801 > 779.004-.01) source value Organization.address[va-postal] .country Assume country is same as for physical Organization.address.where(type="postal") http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1
1786 for review V2F target not supported Organization.telecom Institution does not have a root level phone number http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization | 5.0.1

Mappings to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

NameVeterans Health Information Systems Technology and Architecture (VistA)Clinical Data Warehouse (CDW)doco
.. Organization
... id
... meta
... implicitRules
... text
... contained
... extension
... modifierExtension
... Slices for identifier
.... identifier:NPI
..... id
..... extension
..... use
..... type
..... system
fixed value = http://hl7.org/fhir/sid/us-npi
mapParameter line 1
..... value
source value based on INSTITUTION - NPI (4-41.99)
Dim.Institution.NPI Dim.Institution.NPI Dim.InstitutionTimeZone.NPI NDim.MVIInstitution.NPI
..... period
..... assigner
.... identifier:CLIA
... active
fixed value = true
... type
fixed value = http://terminology.hl7.org/CodeSystem/organization-type#prov
... name
source value based on INSTITUTION - NAME (4-.01)
Dim.AutoDiscontinuedRule.InstitutionName Dim.Institution.InstitutionName Dim.Institution.InstitutionName Dim.InstitutionTimeZone.Institution Dim.RequestService.IFCRoutingInstitution NDim.MVIInstitution.InstitutionName
... alias
source value based on INSTITUTION - SHORT NAME (4-.05)
Dim.Institution.InstitutionShortName Dim.Institution.InstitutionShortName Dim.InstitutionTimeZone.InstitutionShortName NDim.MVIInstitution.InstitutionShortName
... telecom
target not supported
Institution does not have a root level phone number
.... id
.... extension
.... system
.... value
.... use
.... rank
.... period
... Slices for address
.... address:All Slices
..... id
..... extension
..... use
..... type
..... text
..... line
..... city
..... district
..... state
..... postalCode
..... country
..... period
.... address:va-physical
..... id
..... extension
..... use
..... type
fixed value = #physical
..... text
..... line
source value based on INSTITUTION - STREET ADDR. 2 (4-1.02)
Dim.Institution.StreetAddress2 Dim.Institution.StreetAddress2 Dim.InstitutionTimeZone.StreetAddress2 NDim.MVIInstitution.StreetAddress2
..... city
source value based on INSTITUTION - CITY (4-1.03)
Dim.Institution.City Dim.Institution.City Dim.InstitutionTimeZone.City NDim.MVIInstitution.City
..... district
source value based on INSTITUTION - DISTRICT (4-.03)
Dim.Institution.MedicalDistrict Dim.Institution.MedicalDistrict NDim.MVIInstitution.MedicalDistrict
..... state
source value based on INSTITUTION - STATE > STATE - ABBREVIATION (4-.02 > 5-1)
Dim.Institution.StateIEN Dim.InstitutionTimeZone.StateIEN Dim.InstitutionTimeZone.StateSID NDim.MVIInstitution.MVIStateIEN Dim.State.StateAbbrev Dim.State.StateAbbrev NDim.MVIState.StateAbbrev
..... postalCode
source value based on INSTITUTION - ZIP (4-1.04)
Dim.Institution.Zip Dim.Institution.Zip Dim.InstitutionTimeZone.Zip NDim.MVIInstitution.Zip
..... country
source value based on INSTITUTION - COUNTRY > COUNTRY CODE - CODE (4-801 > 779.004-.01)
Dim.Country.CountryCode NDim.MVICountryCode.CountryCode
..... period
.... address:va-postal
..... id
..... extension
..... use
..... type
fixed value = #postal
..... text
..... line
source value based on INSTITUTION - ST. ADDR. 2 (MAILING) (4-4.02)
Dim.InstitutionTimeZone.MailingStreetAddress2
..... city
source value based on INSTITUTION - CITY (MAILING) (4-4.03)
Dim.InstitutionTimeZone.MailingCity
..... district
..... state
source value based on INSTITUTION - STATE (MAILING) (4-4.04)
Dim.InstitutionTimeZone.MailingStateIEN Dim.InstitutionTimeZone.MailingStateSID
..... postalCode
source value based on INSTITUTION - ZIP (MAILING) (4-4.05)
Dim.InstitutionTimeZone.MailingZip
..... country
source value based on INSTITUTION - COUNTRY > COUNTRY CODE - CODE (4-801 > 779.004-.01)
Assume country is same as for physical Organization.address.where(type="postal")
Dim.Country.CountryCode NDim.MVICountryCode.CountryCode
..... period
... partOf
... contact
.... id
.... extension
.... modifierExtension
.... purpose
.... name
..... id
..... extension
..... use
..... text
source value based on INSTITUTION - CONTACT > CONTACT - CONTACT (4-4 > 4.03-.01)
..... family
..... given
..... prefix
..... suffix
..... period
.... telecom
..... id
..... extension
..... system
fixed value = #phone
mapParameter line 1
..... value
source value based on INSTITUTION - CONTACT > CONTACT - PHONE # (4-4 > 4.03-.03)
..... use
..... rank
..... period
.... address
... endpoint

doco Documentation for this format