HL7 Version 2 to FHIR
1.0.0 - STU 1 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 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 XCN to Practitioner Map (Experimental)

Official URL: http://hl7.org/fhir/uv/v2mappings/ConceptMap/datatype-xcn-to-practitioner Version: 1.0.0
Standards status: Informative Computable Name: DatatypeXCNToPractitioner

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

This ConceptMap represents a mapping from the HL7 V2 Datatype XCN to the FHIR Practitioner Resource.

This ConceptMap represents the mapping from the HL7 V2 XCN Data Type to the FHIR Practitioner Resource. 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
1XCN.1Person IdentifierST01Practitioner.identifier.valuestring01
2XCN.2Family NameFN01Practitioner.nameHumanName0-1FN[HumanName]
3XCN.3Given NameST01Practitioner.name.givenstring0-1
4XCN.4Second and Further Given Names or Initials ThereofST01Practitioner.name.givenstring0-1
5XCN.5Suffix (e.g., JR or III)ST01Practitioner.name.suffixstring0-1
6XCN.6Prefix (e.g., DR)ST01Practitioner.name.prefixstring0-1
7XCN.7Degree (e.g., MD)IS01Practitioner.qualification.codeCodeableConcept11IS[CodeableConcept]DegreeLicenseCertificate
8XCN.8Source TableCWE01
9XCN.9Assigning AuthorityHD01If organizationPractitioner.identifier.assigner(Practitioner.Organization)Reference(Practitioner.Organization)01HD[Organization]
9XCN.9Assigning AuthorityHD01If systemPractitioner.identifier.systemuri01HD[uri]Typically the assigning authority reflects an organization, but if it is an actual system (EHR 1 vs. EHR 2, both supporting the same organization where one cannot get more specific), then XCN.9 should be mapped to .system
10XCN.10Name Type CodeID01Practitioner.name.usecode01NameType
11XCN.11Identifier Check DigitST01Practitioner.identifier.extension.urluri01"http://hl7.org/fhir/StructureDefinition/identifier-checkDigit"
11XCN.11Identifier Check DigitST01Practitioner.identifier.extension.valueStringstring11
12XCN.12Check Digit SchemeID01Practitioner.identifier.extension.urluri01"http://hl7.org/fhir/StructureDefinition/namingsystem-checkDigit"
12XCN.12Check Digit SchemeID01Practitioner.identifier.extension.valueStringstring11
13XCN.13Identifier Type CodeID01Practitioner.identifier.type.coding.codecode01IdentifierType
14XCN.14Assigning FacilityHD01identifier.extension??-assigningFacilityReference(Practitioner.Location)01HD[Location]
15XCN.15Name Representation CodeID01
16XCN.16Name ContextCWE01
17XCN.17Name Validity Range01IF XCN.19 DOES NOT EXIST AND IF XCN.20 DOES NOT EXISTPractitioner.name.periodPeriod01DR[Period]
18XCN.18Name Assembly OrderID01Practitioner.name.family.extension.urluri01"http://hl7.org/fhir/R4/extension-humanname-assembly-order.html"
18XCN.18Name Assembly OrderID01Practitioner.name.family.extension.valueCodecode01NameAssemblyOrder
19XCN.19Effective DateDTM01Practitioner.name.period.startdateTime01
20XCN.20Expiration DateDTM01Practitioner.name.period.enddateTime01
21XCN.21Professional SuffixST01Practitioner.name.suffixstring0-1
22XCN.22Assigning JurisdictionCWE01
23XCN.23Assigning Agency or DepartmentCWE01
24XCN.24Security CheckST01
25XCN.25Security Check SchemeID01

Mapping from (not specified) to (not specified)


Group 1 Mapping from unspecified code system to unspecified code system

Source Concept DetailsRelationshipTarget Concept DetailsComment
Codes from NarrativeConditionComputableANTLRCodes from
XCN.1Person Identifieris equivalent toidentifier[1].valueidentifier[1].value
XCN.2Family Nameis equivalent tonamename
XCN.3Given Nameis equivalent toname.given[1]name.given[1]
XCN.4Second and Further Given Names or Initials Thereofis equivalent toname.given[2]name.given[2]
XCN.5Suffix (e.g., JR or III)is equivalent toname.suffix[1]name.suffix[1]
XCN.6Prefix (e.g., DR)is equivalent toname.prefixname.prefix
XCN.7Degree (e.g., MD)is equivalent toqualification.codequalification.code
XCN.9Assigning AuthorityIf organizationis equivalent toidentifier[1].assigner(Organization)identifier[1].assigner(Organization)
XCN.9Assigning AuthorityIf systemis equivalent toidentifier[1].systemidentifier[1].systemTypically the assigning authority reflects an organization, but if it is an actual system (EHR 1 vs. EHR 2, both supporting the same organization where one cannot get more specific), then XCN.9 should be mapped to .system
XCN.10Name Type Codeis equivalent toname.usename.use
XCN.11Identifier Check Digitis equivalent toidentifier[1].extension[1].urlidentifier[1].extension[1].url
XCN.11Identifier Check Digitis equivalent toidentifier[1].extension[1].valueStringidentifier[1].extension[1].valueString
XCN.12Check Digit Schemeis equivalent toidentifier[1].extension[2].urlidentifier[1].extension[2].url
XCN.12Check Digit Schemeis equivalent toidentifier[1].extension[2].valueStringidentifier[1].extension[2].valueString
XCN.13Identifier Type Codeis equivalent toidentifier[1].type.coding.codeidentifier[1].type.coding.code
XCN.17Name Validity RangeIF XCN.19 DOES NOT EXIST AND IF XCN.20 DOES NOT EXISTis equivalent toname.periodname.period
XCN.18Name Assembly Orderis equivalent toname.family.extension.urlname.family.extension.url
XCN.18Name Assembly Orderis equivalent toname.family.extension.valueCodename.family.extension.valueCode
XCN.19Effective Dateis equivalent toname.period.startname.period.start
XCN.20Expiration Dateis equivalent toname.period.endname.period.end
XCN.21Professional Suffixis equivalent toname.suffix[2]name.suffix[2]

Notes: