US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401 United States of America flag

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

Resource Profile: Patient - Mappings

Active as of 2025-03-31

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

Mapping Sources

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

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
272-1 for review V2F fixed value Patient.identifier .system urn:oid:2.16.840.1.113883.4.349 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
272-2 for review V2F fixed value Patient.identifier .type.coding.code #MR generated from mapParameter line 2 http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
272-3 for review V2F fixed value Patient.identifier .type.coding.system http://terminology.hl7.org/CodeSystem/v2-0203 generated from mapParameter line 3 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
273-1 for review V2F fixed value Patient.name .family LAST generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
273-2 for review V2F fixed value Patient.name .given FIRST & MIDDLE generated from mapParameter line 2 http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
273-3 for review V2F fixed value Patient.name .suffix SUFFIX generated from mapParameter line 3 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
274-1 for review V2F fixed value Patient.telecom[va-home] .system #phone generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
274-2 for review V2F fixed value Patient.telecom[va-home] .use #home generated from mapParameter line 2 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
275-1 for review V2F fixed value Patient.telecom[va-work] .system #phone generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
275-2 for review V2F fixed value Patient.telecom[va-work] .use #work generated from mapParameter line 2 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
276-1 for review V2F fixed value Patient.telecom[va-mobile] .system #phone generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
276-2 for review V2F fixed value Patient.telecom[va-mobile] .use #mobile generated from mapParameter line 2 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
286-1 for review V2F fixed value Patient.address[va-home] .use #home generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | 5.0.1
286-2 for review V2F fixed value Patient.address[va-home] .type #postal generated from mapParameter line 2 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
575-1 for review V2F PATIENT - ETHNICITY INFORMATION (2-6) source value Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity] .extension[text].valueString generated from mapParameter line 1 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
576-1 for review V2F PATIENT - RACE INFORMATION (2-2) source value Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-race] .extension[text].valueString generated from mapParameter line 1 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 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