HL7 Version 2 to FHIR
1.0.0-ballot - ballot International flag

HL7 Version 2 to FHIR, published by HL7 International / Orders and Observations. This guide is not an authorized publication; it is the continuous build for version 1.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/v2-to-fhir/ and changes regularly. See the Directory of published versions

ConceptMap: Datatype XPN to HumanName Map (Experimental)

Official URL: http://hl7.org/fhir/uv/v2mappings/datatype-xpn-to-humanname Version: 1.0.0-ballot
Active as of 2024-12-20 Computable Name: DatatypeXPNToHumanName

Copyright/Legal: Copyright (c) 2020, HL7 International, Inc., All Rights Reserved.

This ConceptMap represents a mapping from the HL7 V2 Datatype XPN to the FHIR HumanName Data Type.

This ConceptMap represents the mapping from the HL7 V2 XPN Data Type to the FHIR HumanName Data Type. See also the FHIR Shorthand or the CSV Source.

HL7 v2Condition (IF True, args)HL7 FHIRComments
Sort OrderIdentifierNameData TypeCardinality - MinCardinality - MaxComputable ANTLRComputable FHIRPathNarrativeFHIR AttributeProposed ExtensionData TypeCardinality - MinCardinality - MaxData Type MappingVocabulary Mapping
(IS, ID, CE, CEN, CWE)		Assignment
1XPN.1Family NameFN01HumanName..familyHumanName.string01FN[HumanName]
2XPN.2Given NameST01HumanName..givenHumanName.string0-1The requirement for XPN.2 being the first iteration of HumanName.given critical when it's an "official" name
3XPN.3Second and Further Given Names or Initials ThereofST01HumanName..givenHumanName.string0-1Consideration must be given if XPN.3 contains multiple names separated by a space. Should these be a single iteration of HumanName.given or is each name an iteration? For example, if XPN.3 is "Mary Anne", is that one name or two?
4XPN.4Suffix (e.g., JR or III)ST01HumanName..suffixHumanName.string0-1
5XPN.5Prefix (e.g., DR)ST01HumanName..prefixHumanName.string0-1
6XPN.6Degree (e.g., MD)01HumanName..suffixHumanName.string0-1
7XPN.7Name Type CodeID01HumanName..useHumanName.code01NameType
8XPN.8Name Representation CodeID01
9XPN.9Name ContextCWE01
10XPN.10Name Validity RangeDR01IF XPN.12 NOT VALUED AND XPN.13 NOT VALUEDHumanName..periodHumanName.Period01DR[Period]
11XPN.11Name Assembly OrderID01HumanName..extension.urlHumanName.uri11"http://hl7.org/fhir/StructureDefinition/humanname-assembly-order"
11XPN.11Name Assembly OrderID01HumanName..extension.valueCodeHumanName.code11NameAssemblyOrder
12XPN.12Effective DateDTM01HumanName..period.startHumanName.dateTime01
13XPN.13Expiration DateDTM01HumanName..period.endHumanName.dateTime01
14XPN.14Professional SuffixST01HumanName..suffixHumanName.string0-1
15XPN.15Called ByST01if the resource attribute using the HumanName datatype allows for multiple namesHumanName..givenHumanName.string0-1One possibility is to put this in HumanName.given where HumanName.use="usual". When XPN.7 does not map to "usual" a new occurence of Patient.name should be created Alternative a new extension could be created for HumanName.family.#ext-called-by#
15XPN.15Called ByST01if the resource attribute using the HumanName datatype allows for multiple namesHumanName..useHumanName.code01"nickname"

Generated Narrative: ConceptMap datatype-xpn-to-humanname

Mapping from XPN to HumanName


Group 1 Mapping from unspecified code system to unspecified code system

Source CodeRelationshipTarget CodeComment
XPN.1 (Family Name)is equivalent to[1].family
XPN.2 (Given Name)is equivalent to[1].given[1]The requirement for XPN.2 being the first iteration of HumanName.given critical when it's an "official" name
XPN.3 (Second and Further Given Names or Initials Thereof)is equivalent to[1].given[2]Consideration must be given if XPN.3 contains multiple names separated by a space. Should these be a single iteration of HumanName.given or is each name an iteration? For example, if XPN.3 is "Mary Anne", is that one name or two?
XPN.4 (Suffix (e.g., JR or III))is equivalent to[1].suffix[1]
XPN.5 (Prefix (e.g., DR))is equivalent to[1].prefix
XPN.6 (Degree (e.g., MD))is equivalent to[1].suffix[2]
XPN.7 (Name Type Code)is equivalent to[1].use
XPN.10 (Name Validity Range)is equivalent to[1].period
XPN.11 (Name Assembly Order)is equivalent to[1].extension.url
XPN.11 (Name Assembly Order)is equivalent to[1].extension.valueCode
XPN.12 (Effective Date)is equivalent to[1].period.start
XPN.13 (Expiration Date)is equivalent to[1].period.end
XPN.14 (Professional Suffix)is equivalent to[1].suffix[3]
XPN.15 (Called By)is equivalent to[2].givenOne possibility is to put this in HumanName.given where HumanName.use="usual". When XPN.7 does not map to "usual" a new occurence of Patient.name should be created Alternative a new extension could be created for HumanName.family.#ext-called-by#\
XPN.15 (Called By)is equivalent to[2].use

Notes: