US Veterans Health Administration FHIR Map Set Implementation Guide
1.6.0 - 250701 United States of America flag

Publication Build: This will be filled in by the publication tooling

Resource Profile: Organization - Mappings

Active as of 2025-06-20

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

NameHL7 v2 MappingRIM MappingServDFiveWs Pattern Mappingdoco
.. Organization
(also see master files messages)
  • Organization(classCode=ORG
  • determinerCode=INST)
Organization
... id
... meta
... implicitRules
... text
Act.text?
... contained
N/A
... extension
N/A
... modifierExtension
N/A
... Slices for identifier
XON.10 / XON.3
.scopes[Role](classCode=IDENT)
./Identifiers
FiveWs.identifier
.... identifier:NPI
XON.10 / XON.3
.scopes[Role](classCode=IDENT)
./Identifiers
FiveWs.identifier
..... id
n/a
..... extension
n/a
..... use
N/A
Role.code or implied by context
..... type
CX.5
Role.code or implied by context
..... system
CX.4 / EI-2-4
II.root or Role.id.root
./IdentifierType
..... value
CX.1 / EI.1
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
./Value
..... period
CX.7 + CX.8
Role.effectiveTime or implied by context
./StartDate and ./EndDate
..... assigner
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
./IdentifierIssuingAuthority
.... identifier:CLIA
XON.10 / XON.3
.scopes[Role](classCode=IDENT)
./Identifiers
FiveWs.identifier
... active
No equivalent in HL7 v2
.status
  • ./Status (however this concept in ServD more covers why the organization is active or not
  • could be delisted
  • deregistered
  • not operational yet) this could alternatively be derived from ./StartDate and ./EndDate and given a context date.
FiveWs.status
... type
No equivalent in v2
.code
n/a
FiveWs.class
... name
XON.1
.name
.PreferredName/Name
... alias
.name
... telecom
ORC-22?
.telecom
./ContactPoints
.... id
n/a
.... extension
n/a
.... system
XTN.3
./scheme
./ContactPointType
.... value
XTN.1 (or XTN.12)
./url
./Value
.... use
XTN.2 - but often indicated by field
unique(./use)
./ContactPointPurpose
.... rank
n/a
n/a
.... period
N/A
./usablePeriod[type="IVL<TS>"]
./StartDate and ./EndDate
... Slices for address
ORC-23?
.address
./PrimaryAddress and ./OtherAddresses
.... address:All Slices
..... id
n/a
..... extension
n/a
..... use
XAD.7
unique(./use)
./AddressPurpose
..... type
XAD.18
unique(./use)
..... text
XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
./formatted
..... line
XAD.1 and XAD.2 have different meanings for a company address than for a person address)
AD.part[parttype = AL]
./StreetAddress (newline delimitted)
..... city
XAD.3
AD.part[parttype = CTY]
./Jurisdiction
..... district
XAD.9
AD.part[parttype = CNT | CPA]
..... state
XAD.4
AD.part[parttype = STA]
./Region
..... postalCode
XAD.5
AD.part[parttype = ZIP]
./PostalIdentificationCode
..... country
XAD.6
AD.part[parttype = CNT]
./Country
..... period
XAD.12 / XAD.13 + XAD.14
./usablePeriod[type="IVL<TS>"]
./StartDate and ./EndDate
.... address:va-physical
ORC-23?
.address
./PrimaryAddress and ./OtherAddresses
..... id
n/a
..... extension
n/a
..... use
XAD.7
unique(./use)
./AddressPurpose
..... type
XAD.18
unique(./use)
..... text
XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
./formatted
..... line
XAD.1 and XAD.2 have different meanings for a company address than for a person address)
AD.part[parttype = AL]
./StreetAddress (newline delimitted)
..... city
XAD.3
AD.part[parttype = CTY]
./Jurisdiction
..... district
XAD.9
AD.part[parttype = CNT | CPA]
..... state
XAD.4
AD.part[parttype = STA]
./Region
..... postalCode
XAD.5
AD.part[parttype = ZIP]
./PostalIdentificationCode
..... country
XAD.6
AD.part[parttype = CNT]
./Country
..... period
XAD.12 / XAD.13 + XAD.14
./usablePeriod[type="IVL<TS>"]
./StartDate and ./EndDate
.... address:va-postal
ORC-23?
.address
./PrimaryAddress and ./OtherAddresses
..... id
n/a
..... extension
n/a
..... use
XAD.7
unique(./use)
./AddressPurpose
..... type
XAD.18
unique(./use)
..... text
XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
./formatted
..... line
XAD.1 and XAD.2 have different meanings for a company address than for a person address)
AD.part[parttype = AL]
./StreetAddress (newline delimitted)
..... city
XAD.3
AD.part[parttype = CTY]
./Jurisdiction
..... district
XAD.9
AD.part[parttype = CNT | CPA]
..... state
XAD.4
AD.part[parttype = STA]
./Region
..... postalCode
XAD.5
AD.part[parttype = ZIP]
./PostalIdentificationCode
..... country
XAD.6
AD.part[parttype = CNT]
./Country
..... period
XAD.12 / XAD.13 + XAD.14
./usablePeriod[type="IVL<TS>"]
./StartDate and ./EndDate
... partOf
No equivalent in HL7 v2
.playedBy[classCode=Part].scoper
n/a
... contact
.contactParty
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... purpose
./type
.... name
  • PID-5
  • PID-9
./name
..... id
n/a
..... extension
n/a
..... use
  • XPN.7
  • but often indicated by which field contains the name
unique(./use)
./NamePurpose
..... text
implied by XPN.11
./formatted
..... family
XPN.1/FN.1
./part[partType = FAM]
./FamilyName
..... given
XPN.2 + XPN.3
./part[partType = GIV]
./GivenNames
..... prefix
XPN.5
./part[partType = PFX]
./TitleCode
..... suffix
XPN/4
./part[partType = SFX]
..... period
XPN.13 + XPN.14
./usablePeriod[type="IVL<TS>"]
./StartDate and ./EndDate
.... telecom
  • PID-13
  • PID-14
./telecom
..... id
n/a
..... extension
n/a
..... system
XTN.3
./scheme
./ContactPointType
..... value
XTN.1 (or XTN.12)
./url
./Value
..... use
XTN.2 - but often indicated by field
unique(./use)
./ContactPointPurpose
..... rank
n/a
n/a
..... period
N/A
./usablePeriod[type="IVL<TS>"]
./StartDate and ./EndDate
.... address
PID-11
./addr
... endpoint
n/a

doco Documentation for this format