US Veterans Health Administration FHIR Map Set Implementation Guide
1.6.0 - 250701
Publication Build: This will be filled in by the publication tooling
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.
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 |
No Mappings Found
No Mappings Found
Name | HL7 v2 Mapping | RIM Mapping | ServD | FiveWs Pattern Mapping![]() |
---|---|---|---|---|
![]() ![]() |
(also see master files messages) |
|
Organization |
|
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
Act.text? |
|||
![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() |
XON.10 / XON.3 |
.scopes[Role](classCode=IDENT) |
./Identifiers |
FiveWs.identifier |
![]() ![]() ![]() ![]() |
XON.10 / XON.3 |
.scopes[Role](classCode=IDENT) |
./Identifiers |
FiveWs.identifier |
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
N/A |
Role.code or implied by context |
||
![]() ![]() ![]() ![]() ![]() |
CX.5 |
Role.code or implied by context |
||
![]() ![]() ![]() ![]() ![]() |
CX.4 / EI-2-4 |
II.root or Role.id.root |
./IdentifierType |
|
![]() ![]() ![]() ![]() ![]() |
CX.1 / EI.1 |
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
CX.7 + CX.8 |
Role.effectiveTime or implied by context |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() ![]() |
|
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper |
./IdentifierIssuingAuthority |
|
![]() ![]() ![]() ![]() |
XON.10 / XON.3 |
.scopes[Role](classCode=IDENT) |
./Identifiers |
FiveWs.identifier |
![]() ![]() ![]() |
No equivalent in HL7 v2 |
.status |
|
FiveWs.status |
![]() ![]() ![]() |
No equivalent in v2 |
.code |
n/a |
FiveWs.class |
![]() ![]() ![]() |
XON.1 |
.name |
.PreferredName/Name |
|
![]() ![]() ![]() |
.name |
|||
![]() ![]() ![]() |
ORC-22? |
.telecom |
./ContactPoints |
|
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() |
ORC-23? |
.address |
./PrimaryAddress and ./OtherAddresses |
|
![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XAD.7 |
unique(./use) |
./AddressPurpose |
|
![]() ![]() ![]() ![]() ![]() |
XAD.18 |
unique(./use) |
||
![]() ![]() ![]() ![]() ![]() |
XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6 |
./formatted |
||
![]() ![]() ![]() ![]() ![]() |
XAD.1 and XAD.2 have different meanings for a company address than for a person address) |
AD.part[parttype = AL] |
./StreetAddress (newline delimitted) |
|
![]() ![]() ![]() ![]() ![]() |
XAD.3 |
AD.part[parttype = CTY] |
./Jurisdiction |
|
![]() ![]() ![]() ![]() ![]() |
XAD.9 |
AD.part[parttype = CNT | CPA] |
||
![]() ![]() ![]() ![]() ![]() |
XAD.4 |
AD.part[parttype = STA] |
./Region |
|
![]() ![]() ![]() ![]() ![]() |
XAD.5 |
AD.part[parttype = ZIP] |
./PostalIdentificationCode |
|
![]() ![]() ![]() ![]() ![]() |
XAD.6 |
AD.part[parttype = CNT] |
./Country |
|
![]() ![]() ![]() ![]() ![]() |
XAD.12 / XAD.13 + XAD.14 |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
ORC-23? |
.address |
./PrimaryAddress and ./OtherAddresses |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XAD.7 |
unique(./use) |
./AddressPurpose |
|
![]() ![]() ![]() ![]() ![]() |
XAD.18 |
unique(./use) |
||
![]() ![]() ![]() ![]() ![]() |
XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6 |
./formatted |
||
![]() ![]() ![]() ![]() ![]() |
XAD.1 and XAD.2 have different meanings for a company address than for a person address) |
AD.part[parttype = AL] |
./StreetAddress (newline delimitted) |
|
![]() ![]() ![]() ![]() ![]() |
XAD.3 |
AD.part[parttype = CTY] |
./Jurisdiction |
|
![]() ![]() ![]() ![]() ![]() |
XAD.9 |
AD.part[parttype = CNT | CPA] |
||
![]() ![]() ![]() ![]() ![]() |
XAD.4 |
AD.part[parttype = STA] |
./Region |
|
![]() ![]() ![]() ![]() ![]() |
XAD.5 |
AD.part[parttype = ZIP] |
./PostalIdentificationCode |
|
![]() ![]() ![]() ![]() ![]() |
XAD.6 |
AD.part[parttype = CNT] |
./Country |
|
![]() ![]() ![]() ![]() ![]() |
XAD.12 / XAD.13 + XAD.14 |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
ORC-23? |
.address |
./PrimaryAddress and ./OtherAddresses |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XAD.7 |
unique(./use) |
./AddressPurpose |
|
![]() ![]() ![]() ![]() ![]() |
XAD.18 |
unique(./use) |
||
![]() ![]() ![]() ![]() ![]() |
XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6 |
./formatted |
||
![]() ![]() ![]() ![]() ![]() |
XAD.1 and XAD.2 have different meanings for a company address than for a person address) |
AD.part[parttype = AL] |
./StreetAddress (newline delimitted) |
|
![]() ![]() ![]() ![]() ![]() |
XAD.3 |
AD.part[parttype = CTY] |
./Jurisdiction |
|
![]() ![]() ![]() ![]() ![]() |
XAD.9 |
AD.part[parttype = CNT | CPA] |
||
![]() ![]() ![]() ![]() ![]() |
XAD.4 |
AD.part[parttype = STA] |
./Region |
|
![]() ![]() ![]() ![]() ![]() |
XAD.5 |
AD.part[parttype = ZIP] |
./PostalIdentificationCode |
|
![]() ![]() ![]() ![]() ![]() |
XAD.6 |
AD.part[parttype = CNT] |
./Country |
|
![]() ![]() ![]() ![]() ![]() |
XAD.12 / XAD.13 + XAD.14 |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() |
No equivalent in HL7 v2 |
.playedBy[classCode=Part].scoper |
n/a |
|
![]() ![]() ![]() |
.contactParty |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() |
./type |
|||
![]() ![]() ![]() ![]() |
|
./name |
||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
|
unique(./use) |
./NamePurpose |
|
![]() ![]() ![]() ![]() ![]() |
implied by XPN.11 |
./formatted |
||
![]() ![]() ![]() ![]() ![]() |
XPN.1/FN.1 |
./part[partType = FAM] |
./FamilyName |
|
![]() ![]() ![]() ![]() ![]() |
XPN.2 + XPN.3 |
./part[partType = GIV] |
./GivenNames |
|
![]() ![]() ![]() ![]() ![]() |
XPN.5 |
./part[partType = PFX] |
./TitleCode |
|
![]() ![]() ![]() ![]() ![]() |
XPN/4 |
./part[partType = SFX] |
||
![]() ![]() ![]() ![]() ![]() |
XPN.13 + XPN.14 |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
|
./telecom |
||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
PID-11 |
./addr |
||
![]() ![]() ![]() |
n/a |
|||
![]() |