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

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

Resource Profile: Patient - Mappings

Active as of 2025-06-13

Mappings for the Patient 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: Patient (Source)Use Case: Patient (Source)PATIENT (2).01NAME.02SEX.024SELF IDENTIFIED GENDER.03DATE OF BIRTH.05MARITAL STATUS.08RELIGIOUS PREFERENCE.111STREET ADDRESS [LINE 1].1112ZIP+4.112STREET ADDRESS [LINE 2].113STREET ADDRESS [LINE 3].114CITY.115STATE.1173COUNTRY.1217TEMPORARY ADDRESS START DATE.1218TEMPORARY ADDRESS END DATE.131PHONE NUMBER [RESIDENCE].132PHONE NUMBER [WORK].134PHONE NUMBER [CELLULAR].351DATE OF DEATH2RACE INFORMATION6ETHNICITY INFORMATION7LANGUAGE DATE/TIME991.01INTEGRATION CONTROL NUMBERLANGUAGE DATE/TIME (2.07).02PREFERRED LANGUAGE

Cross Mappings

FHIR Path VistA CDW SDA VPR
Patient.identifier.value 2-991.01 Patient.Patient.PatientICN
Patient.PatientICN.PatientICN
SPatient.SPatient.PatientICN
SPatient.SPatientGISAddress.PatientICN
  demographics.icn
Patient.name.text 2-.01 SPatient.SPatient.DestinationMergePatientIEN
SPatient.SPatient.PatientFirstName
SPatient.SPatient.PatientLastName
SPatient.SPatient.PatientName
SPatient.SPatientAlias.PatientName
Patient.Name demographics.familyName
demographics.fullName
demographics.givenNames
Patient.telecom[va-home].value 2-.131   Patient.HomePhoneNumber demographics.telecom
Patient.telecom[va-work].value 2-.132   Patient.WorkPhoneNumber demographics.telecom
Patient.telecom[va-mobile].value 2-.134   Patient.MobilePhoneNumber demographics.telecom
Patient.birthDate 2-.03 SPatient.PlaceOfBirth.BirthDateTime
SPatient.SPatient.BirthDateTime
Patient.BirthTime
Patient.Extension[PatientExtension].Dob
demographics.dob
Patient.deceasedDateTime 2-.351 Patient.Patient.DeathDateTime
SPatient.SPatient.DeathDateTime
Patient.DeathTime
Patient.IsDead
demographics.died
Patient.address[va-home].line 2-.113   Patient.PermanentAddress[Address].Street demographics.address
Patient.address[va-home].city 2-.114 SPatient.SPatientGISAddress.City Patient.PermanentAddress[Address].City demographics.address
Patient.address[va-home].state 2-.115 SPatient.SPatientGISAddress.StateIEN
SPatient.SPatientGISAddress.StateSID
Patient.PermanentAddress[Address].State demographics.address
Patient.address[va-home].postalCode 2-.1112 SPatient.SPatientGISAddress.Zip4   demographics.address
Patient.address[va-home].country 2-.1173   Patient.PermanentAddress[Address].Country  
Patient.address[va-home].period.start 2-.1217   Patient.TemporaryAddress[Address].FromTime  
Patient.address[va-home].period.end 2-.1218   Patient.TemporaryAddress[Address].ToTime  
Patient.communication.language 2.07-.02 Patient.PreferredLanguage.PreferredLanguage Patient.PatientLanguage.Preferred Language  
Patient.gender 2-.02 Patient.Patient.Gender
Patient.PatientBirthSex.BirthSex
SPatient.SPatient.Gender
SPatient.SPatientBirthSex.BirthSex
SPatient.SPatientBirthSex.BirthSex
Patient.BirthGender
Patient.Gender
demographics.gender
Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity].valueCodeableConcept 2-.024 Patient.Patient.SelfIdentifiedGender
SPatient.SPatient.SelfIdentifiedGender
   
Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity].extension[ombCategory].valueCoding.code 2-6   Patient.EthnicGroup demographics.ethnicity [m-P:10.2] (>10.2-3)
Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity].extension[text].valueString 2-6   Patient.EthnicGroup demographics.ethnicity [m-P:10.2] (>10.2-3)
Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-race].extension[ombCategory].valueCoding.code 2-2   Patient.Races demographics.race [m-P:10] (>10-3)
Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-race].extension[text].valueString 2-2   Patient.Races demographics.race [m-P:10] (>10-3)
Patient.maritalStatus 2-.05 Outpat.Visit.PatientMaritalStatus
Outpat.Workload.PatientMaritalStatus
Patient.Patient.MaritalStatusIEN
SPatient.SPatient.MaritalStatusIEN
Patient.MaritalStatus demographics.maritalStatus
Patient.extension[http://hl7.org/fhir/StructureDefinition/patient-religion].valueCodeableConcept 2-.08 Outpat.Visit.PatientReligion
Outpat.Visit.PatientReligionCode
Outpat.Workload.PatientReligion
Outpat.Workload.PatientReligionCode
Patient.Patient.ReligionIEN
SPatient.SPatient.ReligionIEN
Patient.Religion demographics.religion

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
272 for review V2F PATIENT - INTEGRATION CONTROL NUMBER (2-991.01) source value Patient.identifier .value .system=urn:oid:2.16.840.1.113883.4.349
.type.coding.code=#MR
.type.coding.system=http://terminology.hl7.org/CodeSystem/v2-0203
http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
273 for review V2F PATIENT - NAME (2-.01) source value Patient.name .text .family=LAST
.given=FIRST & MIDDLE
.suffix=SUFFIX
http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
274 for review V2F PATIENT - PHONE NUMBER [RESIDENCE] (2-.131) source value Patient.telecom[va-home] .value .system=#phone
.use=#home
http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
275 for review V2F PATIENT - PHONE NUMBER [WORK] (2-.132) source value Patient.telecom[va-work] .value .system=#phone
.use=#work
http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
276 for review V2F PATIENT - PHONE NUMBER [CELLULAR] (2-.134) source value Patient.telecom[va-mobile] .value .system=#phone
.use=#mobile
http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
284 for review V2F PATIENT - DATE OF BIRTH (2-.03) source value Patient.birthDate http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
285 for review V2F PATIENT - DATE OF DEATH (2-.351) source value not null Patient.deceasedDateTime removed "true" based on Validator testing 6/30/23 http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
286 for review V2F PATIENT - STREET ADDRESS [LINE 1] (2-.111) source value Patient.address[va-home] .line .use=#home
.type=#postal
http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
287 for review V2F PATIENT - STREET ADDRESS [LINE 2] (2-.112) source value Patient.address[va-home] .line http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
288 for review V2F PATIENT - STREET ADDRESS [LINE 3] (2-.113) source value Patient.address[va-home] .line http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
289 for review V2F PATIENT - CITY (2-.114) source value Patient.address[va-home] .city http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
290 for review V2F PATIENT - STATE (2-.115) source value Patient.address[va-home] .state http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
291 for review V2F PATIENT - ZIP+4 (2-.1112) source value Patient.address[va-home] .postalCode http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
292 for review V2F PATIENT - COUNTRY (2-.1173) source value Patient.address[va-home] .country confirm association with .111 etc. http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
293 for review V2F PATIENT - TEMPORARY ADDRESS START DATE (2-.1217) source value Patient.address[va-home] .period.start need other addresses, including temp; not just range http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
294 for review V2F PATIENT - TEMPORARY ADDRESS END DATE (2-.1218) source value Patient.address[va-home] .period.end need other addresses, including temp; not just range http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
295 for review V2F PATIENT - LANGUAGE DATE/TIME > LANGUAGE DATE/TIME - PREFERRED LANGUAGE (2-7 > 2.07-.02) source value Patient.communication.language http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
296 for review V2F fixed value Patient.managingOrganization .display Veterans Health Administration http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
555 for review V2F PATIENT - SEX (2-.02) terminologyMaps Patient.gender VF_adminGender Map VA sex to FHIR gender; both are vague. For now. http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
1808 for review V2F PATIENT - SELF IDENTIFIED GENDER (2-.024) terminologyMaps Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity] .valueCodeableConcept VF_genderIdentity http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
575 for review V2F PATIENT - ETHNICITY INFORMATION (2-6) terminologyMaps Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity] .extension[ombCategory].valueCoding.code VF_ethnicityCategory .extension[text].valueString={} http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
576 for review V2F PATIENT - RACE INFORMATION (2-2) terminologyMaps Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-race] .extension[ombCategory].valueCoding.code VF_raceCategory .extension[text].valueString={} Do we collect any detailed race data? http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
1597 for review V2F PATIENT - MARITAL STATUS (2-.05) terminologyMaps Patient.maritalStatus VF_MaritalStatus http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
1598 for review V2F PATIENT - RELIGIOUS PREFERENCE (2-.08) terminologyMaps Patient.extension[http://hl7.org/fhir/StructureDefinition/patient-religion] .valueCodeableConcept VF_Religion http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1

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

Patient
Patient
   extension
   extension (race)
      extension
      extension (ombCategory)
         value[x]
            code576: terminologyMaps using VF_raceCategory on PATIENT - RACE INFORMATION (2-2)

Do we collect any detailed race data?

      extension (detailed)
         value[x]
      extension (text)
         value[x]576-1: source value based on PATIENT - RACE INFORMATION (2-2)

generated from mapParameter line 1

   extension (ethnicity)
      extension
      extension (ombCategory)
         value[x]
            code575: terminologyMaps using VF_ethnicityCategory on PATIENT - ETHNICITY INFORMATION (2-6)
      extension (detailed)
      extension (text)
         value[x]575-1: source value based on PATIENT - ETHNICITY INFORMATION (2-6)

generated from mapParameter line 1

   extension (birthsex)
   extension (genderIdentity)
      value[x]1808: terminologyMaps using VF_genderIdentity on PATIENT - SELF IDENTIFIED GENDER (2-.024)
   extension (patient-religion)
      value[x]1598: terminologyMaps using VF_Religion on PATIENT - RELIGIOUS PREFERENCE (2-.08)
   identifier
      type
         coding
            system272-3: fixed value = http://terminology.hl7.org/CodeSystem/v2-0203

generated from mapParameter line 3

            code272-2: fixed value = #MR

generated from mapParameter line 2

      system272-1: fixed value = urn:oid:2.16.840.1.113883.4.349

generated from mapParameter line 1

      value272: source value based on PATIENT - INTEGRATION CONTROL NUMBER (2-991.01)
   name
      text273: source value based on PATIENT - NAME (2-.01)
      family273-1: fixed value = LAST

generated from mapParameter line 1

      given273-2: fixed value = FIRST & MIDDLE

generated from mapParameter line 2

      suffix273-3: fixed value = SUFFIX

generated from mapParameter line 3

   telecom
   telecom (va-home)
      system274-1: fixed value = #phone

generated from mapParameter line 1

      value274: source value based on PATIENT - PHONE NUMBER [RESIDENCE] (2-.131)
      use274-2: fixed value = #home

generated from mapParameter line 2

   telecom (va-work)
      system275-1: fixed value = #phone

generated from mapParameter line 1

      value275: source value based on PATIENT - PHONE NUMBER [WORK] (2-.132)
      use275-2: fixed value = #work

generated from mapParameter line 2

   telecom (va-mobile)
      system276-1: fixed value = #phone

generated from mapParameter line 1

      value276: source value based on PATIENT - PHONE NUMBER [CELLULAR] (2-.134)
      use276-2: fixed value = #mobile

generated from mapParameter line 2

   gender555: terminologyMaps using VF_adminGender on PATIENT - SEX (2-.02)

Map VA sex to FHIR gender; both are vague. For now.

   birthDate284: source value based on PATIENT - DATE OF BIRTH (2-.03)
   deceased[x] (deceasedDateTime)285: source value based on PATIENT - DATE OF DEATH (2-.351) if not null

removed "true" based on Validator testing 6/30/23

   address
      period
   address (va-home)
      use286-1: fixed value = #home

generated from mapParameter line 1

      type286-2: fixed value = #postal

generated from mapParameter line 2

      line286: source value based on PATIENT - STREET ADDRESS [LINE 1] (2-.111), 287: source value based on PATIENT - STREET ADDRESS [LINE 2] (2-.112), 288: source value based on PATIENT - STREET ADDRESS [LINE 3] (2-.113), ,
      city289: source value based on PATIENT - CITY (2-.114)
      state290: source value based on PATIENT - STATE (2-.115)
      postalCode291: source value based on PATIENT - ZIP+4 (2-.1112)
      country292: source value based on PATIENT - COUNTRY (2-.1173)

confirm association with .111 etc.

      period
         start293: source value based on PATIENT - TEMPORARY ADDRESS START DATE (2-.1217)

need other addresses, including temp; not just range

         end294: source value based on PATIENT - TEMPORARY ADDRESS END DATE (2-.1218)

need other addresses, including temp; not just range

   maritalStatus1597: terminologyMaps using VF_MaritalStatus on PATIENT - MARITAL STATUS (2-.05)
   communication
      language295: source value based on PATIENT - LANGUAGE DATE/TIME > LANGUAGE DATE/TIME - PREFERRED LANGUAGE (2-7 > 2.07-.02)
   managingOrganization
      display296: fixed value = Veterans Health Administration

Mappings for Clinical Data Warehouse (CDW) ()

Patient
Patient
   extension
   extension (race)
   extension (ethnicity)
   extension (birthsex)
   extension (genderIdentity)
      value[x]Patient.Patient.SelfIdentifiedGender SPatient.SPatient.SelfIdentifiedGender
   extension (patient-religion)
      value[x]Outpat.Visit.PatientReligion Outpat.Visit.PatientReligionCode Outpat.Workload.PatientReligion Outpat.Workload.PatientReligionCode Patient.Patient.ReligionIEN SPatient.SPatient.ReligionIEN
   identifier
      valuePatient.Patient.PatientICN Patient.PatientICN.PatientICN SPatient.SPatient.PatientICN SPatient.SPatientGISAddress.PatientICN
   name
      textSPatient.SPatient.DestinationMergePatientIEN SPatient.SPatient.PatientFirstName SPatient.SPatient.PatientLastName SPatient.SPatient.PatientName SPatient.SPatientAlias.PatientName
   genderPatient.Patient.Gender Patient.PatientBirthSex.BirthSex SPatient.SPatient.Gender SPatient.SPatientBirthSex.BirthSex SPatient.SPatientBirthSex.BirthSex
   birthDateSPatient.PlaceOfBirth.BirthDateTime SPatient.SPatient.BirthDateTime
   deceased[x] (deceasedDateTime)Patient.Patient.DeathDateTime SPatient.SPatient.DeathDateTime
   address
   address (va-home)
      lineSPatient.SPatientGISAddress.StreetAddress1, SPatient.SPatientGISAddress.StreetAddress2
      citySPatient.SPatientGISAddress.City
      stateSPatient.SPatientGISAddress.StateIEN SPatient.SPatientGISAddress.StateSID
      postalCodeSPatient.SPatientGISAddress.Zip4
   maritalStatusOutpat.Visit.PatientMaritalStatus Outpat.Workload.PatientMaritalStatus Patient.Patient.MaritalStatusIEN SPatient.SPatient.MaritalStatusIEN
   communication
      languagePatient.PreferredLanguage.PreferredLanguage

Mappings for Summary Document Architecure (SDA) ()

Patient
Patient
   extension
   extension (race)
      extension
      extension (ombCategory)
         value[x]
            codePatient.Races
      extension (detailed)
         value[x]
      extension (text)
         value[x]Patient.Races
   extension (ethnicity)
      extension
      extension (ombCategory)
         value[x]
            codePatient.EthnicGroup
      extension (detailed)
      extension (text)
         value[x]Patient.EthnicGroup
   extension (birthsex)
   extension (genderIdentity)
   extension (patient-religion)
      value[x]Patient.Religion
   name
      textPatient.Name
   telecom
   telecom (va-home)
      valuePatient.HomePhoneNumber
   telecom (va-work)
      valuePatient.WorkPhoneNumber
   telecom (va-mobile)
      valuePatient.MobilePhoneNumber
   genderPatient.BirthGender Patient.Gender
   birthDatePatient.BirthTime Patient.Extension[PatientExtension].Dob
   deceased[x] (deceasedDateTime)Patient.DeathTime Patient.IsDead
   address
      period
   address (va-home)
      linePatient.PermanentAddress[Address].Street
      cityPatient.PermanentAddress[Address].City
      statePatient.PermanentAddress[Address].State
      countryPatient.PermanentAddress[Address].Country
      period
         startPatient.TemporaryAddress[Address].FromTime
         endPatient.TemporaryAddress[Address].ToTime
   maritalStatusPatient.MaritalStatus
   communication
      languagePatient.PatientLanguage.Preferred Language

Mappings for Virtual Patient Record XML (VPR) ()

Patient
Patient
   extension
   extension (race)
      extension
      extension (ombCategory)
         value[x]
            codedemographics.race [m-P:10] (>10-3)
      extension (detailed)
         value[x]
      extension (text)
         value[x]demographics.race [m-P:10] (>10-3)
   extension (ethnicity)
      extension
      extension (ombCategory)
         value[x]
            codedemographics.ethnicity [m-P:10.2] (>10.2-3)
      extension (detailed)
      extension (text)
         value[x]demographics.ethnicity [m-P:10.2] (>10.2-3)
   extension (birthsex)
   extension (genderIdentity)
   extension (patient-religion)
      value[x]demographics.religion
   identifier
      valuedemographics.icn
   name
      textdemographics.familyName demographics.fullName demographics.givenNames
   telecom
   telecom (va-home)
      valuedemographics.telecom
   telecom (va-work)
      valuedemographics.telecom
   telecom (va-mobile)
      valuedemographics.telecom
   genderdemographics.gender
   birthDatedemographics.dob
   deceased[x] (deceasedDateTime)demographics.died
   address
   address (va-home)
      linedemographics.address (>5-.01), demographics.address
      citydemographics.address
      statedemographics.address
      postalCodedemographics.address
   maritalStatusdemographics.maritalStatus

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

Patient
PatientEntity. Role, or Act, Patient[classCode=PAT]
   textAct.text?
   containedN/A
   extension
   extension (race)
      idn/a
      extensionn/a
      extension (ombCategory)
         idn/a
         urlN/A
         value[x]N/A
            idn/a
            extensionn/a
            system./codeSystem
            version./codeSystemVersion
            code./code
            displayCV.displayName
            userSelectedCD.codingRationale
      extension (detailed)
         idn/a
         extensionn/a
         urlN/A
         value[x]N/A
      extension (text)
         idn/a
         urlN/A
         value[x]N/A
      urlN/A
   extension (ethnicity)
      idn/a
      extensionn/a
      extension (ombCategory)
         idn/a
         urlN/A
         value[x]N/A
            idn/a
            extensionn/a
            system./codeSystem
            version./codeSystemVersion
            code./code
            displayCV.displayName
            userSelectedCD.codingRationale
      extension (detailed)
         idn/a
         extensionn/a
         urlN/A
         value[x]N/A
      extension (text)
         idn/a
         urlN/A
         value[x]N/A
      urlN/A
   extension (birthsex)player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
   extension (genderIdentity)
      idn/a
      urlN/A
      value[x]N/A
   extension (patient-religion)
      idn/a
      urlN/A
      value[x]N/A
   modifierExtensionN/A
   identifierid
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
         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
      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
   activestatusCode
   namename
      idn/a
      extensionn/a
      useunique(./use)
      text./formatted
      family./part[partType = FAM]
      given./part[partType = GIV]
      prefix./part[partType = PFX]
      suffix./part[partType = SFX]
      period./usablePeriod[type="IVL<TS>"]
   telecomtelecom
      idn/a
      extensionn/a
      system./scheme
      value./url
      useunique(./use)
      rankn/a
      period./usablePeriod[type="IVL<TS>"]
   telecom (va-home)telecom
      idn/a
      extensionn/a
      system./scheme
      value./url
      useunique(./use)
      rankn/a
      period./usablePeriod[type="IVL<TS>"]
   telecom (va-work)telecom
      idn/a
      extensionn/a
      system./scheme
      value./url
      useunique(./use)
      rankn/a
      period./usablePeriod[type="IVL<TS>"]
   telecom (va-mobile)telecom
      idn/a
      extensionn/a
      system./scheme
      value./url
      useunique(./use)
      rankn/a
      period./usablePeriod[type="IVL<TS>"]
   genderplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
   birthDateplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/birthTime
   deceased[x]player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd, player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime
   deceased[x] (deceasedDateTime)player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd, player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime
   addressaddr
      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>"]
   address (va-home)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>"]
         idn/a
         extensionn/a
         start./low
         end./high
   maritalStatusplayer[classCode=PSN]/maritalStatusCode
   multipleBirth[x]player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthInd, player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber
   photoplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/desc
   contactplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]
      idn/a
      extensionn/a
      modifierExtensionN/A
      relationshipcode
      namename
      telecomtelecom
      addressaddr
      genderplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
      organizationscoper
      periodeffectiveTime
   communicationLanguageCommunication
      idn/a
      extensionn/a
      modifierExtensionN/A
      languageplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code
      preferredpreferenceInd
   generalPractitionersubjectOf.CareEvent.performer.AssignedEntity
   managingOrganizationscoper
      idn/a
      extensionn/a
      referenceN/A
      typeN/A
      identifier.identifier
      displayN/A
   linkoutboundLink
      idn/a
      extensionn/a
      modifierExtensionN/A
      otherid
      typetypeCode

Mappings for CDA (R2) (http://hl7.org/v3/cda)

Patient
PatientClinicalDocument.recordTarget.patientRole
   identifier.id
   activen/a
   name.patient.name
   telecom.telecom
   telecom (va-home).telecom
   telecom (va-work).telecom
   telecom (va-mobile).telecom
   gender.patient.administrativeGenderCode
   birthDate.patient.birthTime
   deceased[x]n/a
   deceased[x] (deceasedDateTime)n/a
   address.addr
   address (va-home).addr
   maritalStatus.patient.maritalStatusCode
   multipleBirth[x]n/a
   photon/a
   contactn/a
      relationshipn/a
      namen/a
      telecomn/a
      addressn/a
      gendern/a
      organizationn/a
      periodn/a
   communicationpatient.languageCommunication
      language.languageCode
      preferred.preferenceInd
   generalPractitionern/a
   managingOrganization.providerOrganization
   linkn/a
      othern/a
      typen/a

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

Patient
Patient
   identifierFiveWs.identifier
   activeFiveWs.status

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

Patient
Patient
   extension
   extension (race)
      extension
      extension (ombCategory)
         value[x]
            systemC*E.3
            versionC*E.7
            codeC*E.1
            displayC*E.2 - but note this is not well followed
            userSelectedSometimes implied by being first
      extension (detailed)
         value[x]
      extension (text)
         value[x]
   extension (ethnicity)
      extension
      extension (ombCategory)
         value[x]
            systemC*E.3
            versionC*E.7
            codeC*E.1
            displayC*E.2 - but note this is not well followed
            userSelectedSometimes implied by being first
   identifierPID-3
      useN/A
      typeCX.5
         codingC*E.1-8, C*E.10-22
            systemC*E.3
            versionC*E.7
            codeC*E.1
            displayC*E.2 - but note this is not well followed
            userSelectedSometimes implied by being first
         textC*E.9. But note many systems use C*E.2 for this
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   namePID-5, PID-9
      useXPN.7, but often indicated by which field contains the name
      textimplied by XPN.11
      familyXPN.1/FN.1
      givenXPN.2 + XPN.3
      prefixXPN.5
      suffixXPN/4
      periodXPN.13 + XPN.14
   telecomPID-13, PID-14, PID-40
      systemXTN.3
      valueXTN.1 (or XTN.12)
      useXTN.2 - but often indicated by field
      rankn/a
      periodN/A
   telecom (va-home)PID-13, PID-14, PID-40
      systemXTN.3
      valueXTN.1 (or XTN.12)
      useXTN.2 - but often indicated by field
      rankn/a
      periodN/A
   telecom (va-work)PID-13, PID-14, PID-40
      systemXTN.3
      valueXTN.1 (or XTN.12)
      useXTN.2 - but often indicated by field
      rankn/a
      periodN/A
   telecom (va-mobile)PID-13, PID-14, PID-40
      systemXTN.3
      valueXTN.1 (or XTN.12)
      useXTN.2 - but often indicated by field
      rankn/a
      periodN/A
   genderPID-8
   birthDatePID-7
   deceased[x]PID-30 (bool) and PID-29 (datetime)
   deceased[x] (deceasedDateTime)PID-30 (bool) and PID-29 (datetime)
   addressPID-11
      useXAD.7
      typeXAD.18
      textXAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
      lineXAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)
      cityXAD.3
      districtXAD.9
      stateXAD.4
      postalCodeXAD.5
      countryXAD.6
      periodXAD.12 / XAD.13 + XAD.14
   address (va-home)PID-11
      useXAD.7
      typeXAD.18
      textXAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
      lineXAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)
      cityXAD.3
      districtXAD.9
      stateXAD.4
      postalCodeXAD.5
      countryXAD.6
      periodXAD.12 / XAD.13 + XAD.14
         startDR.1
         endDR.2
   maritalStatusPID-16
   multipleBirth[x]PID-24 (bool), PID-25 (integer)
   photoOBX-5 - needs a profile
   contact
      relationshipNK1-7, NK1-3
      nameNK1-2
      telecomNK1-5, NK1-6, NK1-40
      addressNK1-4
      genderNK1-15
      organizationNK1-13, NK1-30, NK1-31, NK1-32, NK1-41
   communication
      languagePID-15, LAN-2
      preferredPID-15
   generalPractitionerPD1-4
   link
      otherPID-3, MRG-1

Mappings for LOINC code for the element (http://loinc.org)

Patient
Patient
   birthDate21112-8