HL7 Version 2 to FHIR
1.0.0 - STU 1

HL7 Version 2 to FHIR - Downloaded Version 1.0.0 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 v2 | Condition (IF True, args) | HL7 FHIR | Comments
--- | --- | --- | ---
Sort Order | Identifier | Name | Data Type | Cardinality - Min | Cardinality - Max | Computable ANTLR | Computable FHIRPath | Narrative | FHIR Attribute | Proposed Extension | Data Type | Cardinality - Min | Cardinality - Max | Data Type Mapping | Vocabulary Mapping (IS, ID, CE, CEN, CWE) | Assignment
1 | XCN.1 | Person Identifier | ST | 0 | 1 |  |  |  | Practitioner.identifier.value |  | string | 0 | 1 |  |  |  |
2 | XCN.2 | Family Name | FN | 0 | 1 |  |  |  | Practitioner.name |  | HumanName | 0 | -1 | FN[HumanName] |  |  |
3 | XCN.3 | Given Name | ST | 0 | 1 |  |  |  | Practitioner.name.given |  | string | 0 | -1 |  |  |  |
4 | XCN.4 | Second and Further Given Names or Initials Thereof | ST | 0 | 1 |  |  |  | Practitioner.name.given |  | string | 0 | -1 |  |  |  |
5 | XCN.5 | Suffix (e.g., JR or III) | ST | 0 | 1 |  |  |  | Practitioner.name.suffix |  | string | 0 | -1 |  |  |  |
6 | XCN.6 | Prefix (e.g., DR) | ST | 0 | 1 |  |  |  | Practitioner.name.prefix |  | string | 0 | -1 |  |  |  |
7 | XCN.7 | Degree (e.g., MD) | IS | 0 | 1 |  |  |  | Practitioner.qualification.code |  | CodeableConcept | 1 | 1 | IS[CodeableConcept] | DegreeLicenseCertificate |  |
8 | XCN.8 | Source Table | CWE | 0 | 1 |  |  |  |  |  |  |  |  |  |  |  |
9 | XCN.9 | Assigning Authority | HD | 0 | 1 |  |  | If organization | Practitioner.identifier.assigner(Practitioner.Organization) |  | Reference(Practitioner.Organization) | 0 | 1 | HD[Organization] |  |  |
9 | XCN.9 | Assigning Authority | HD | 0 | 1 |  |  | If system | Practitioner.identifier.system |  | uri | 0 | 1 | HD[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
10 | XCN.10 | Name Type Code | ID | 0 | 1 |  |  |  | Practitioner.name.use |  | code | 0 | 1 |  | NameType |  |
11 | XCN.11 | Identifier Check Digit | ST | 0 | 1 |  |  |  | Practitioner.identifier.extension.url |  | uri | 0 | 1 |  |  | "http://hl7.org/fhir/StructureDefinition/identifier-checkDigit" |
11 | XCN.11 | Identifier Check Digit | ST | 0 | 1 |  |  |  | Practitioner.identifier.extension.valueString |  | string | 1 | 1 |  |  |  |
12 | XCN.12 | Check Digit Scheme | ID | 0 | 1 |  |  |  | Practitioner.identifier.extension.url |  | uri | 0 | 1 |  |  | "http://hl7.org/fhir/StructureDefinition/namingsystem-checkDigit" |
12 | XCN.12 | Check Digit Scheme | ID | 0 | 1 |  |  |  | Practitioner.identifier.extension.valueString |  | string | 1 | 1 |  |  |  |
13 | XCN.13 | Identifier Type Code | ID | 0 | 1 |  |  |  | Practitioner.identifier.type.coding.code |  | code | 0 | 1 |  | IdentifierType |  |
14 | XCN.14 | Assigning Facility | HD | 0 | 1 |  |  |  |  | identifier.extension??-assigningFacility | Reference(Practitioner.Location) | 0 | 1 | HD[Location] |  |  |
15 | XCN.15 | Name Representation Code | ID | 0 | 1 |  |  |  |  |  |  |  |  |  |  |  |
16 | XCN.16 | Name Context | CWE | 0 | 1 |  |  |  |  |  |  |  |  |  |  |  |
17 | XCN.17 | Name Validity Range |  | 0 | 1 | IF XCN.19 DOES NOT EXIST AND IF XCN.20 DOES NOT EXIST |  |  | Practitioner.name.period |  | Period | 0 | 1 | DR[Period] |  |  |
18 | XCN.18 | Name Assembly Order | ID | 0 | 1 |  |  |  | Practitioner.name.family.extension.url |  | uri | 0 | 1 |  |  | "http://hl7.org/fhir/R4/extension-humanname-assembly-order.html" |
18 | XCN.18 | Name Assembly Order | ID | 0 | 1 |  |  |  | Practitioner.name.family.extension.valueCode |  | code | 0 | 1 |  | NameAssemblyOrder |  |
19 | XCN.19 | Effective Date | DTM | 0 | 1 |  |  |  | Practitioner.name.period.start |  | dateTime | 0 | 1 |  |  |  |
20 | XCN.20 | Expiration Date | DTM | 0 | 1 |  |  |  | Practitioner.name.period.end |  | dateTime | 0 | 1 |  |  |  |
21 | XCN.21 | Professional Suffix | ST | 0 | 1 |  |  |  | Practitioner.name.suffix |  | string | 0 | -1 |  |  |  |
22 | XCN.22 | Assigning Jurisdiction | CWE | 0 | 1 |  |  |  |  |  |  |  |  |  |  |  |
23 | XCN.23 | Assigning Agency or Department | CWE | 0 | 1 |  |  |  |  |  |  |  |  |  |  |  |
24 | XCN.24 | Security Check | ST | 0 | 1 |  |  |  |  |  |  |  |  |  |  |  |
25 | XCN.25 | Security Check Scheme | ID | 0 | 1 |  |  |  |  |  |  |  |  |  |  |  |

Mapping from (not specified) to (not specified)

Group 1 Mapping from `unspecified code system` to `unspecified code system`

Source Concept Details | Relationship | Target Concept Details | Comment
Codes from | NarrativeCondition | ComputableANTLR |  | Codes from |
XCN.1 | Person Identifier |  |  | is equivalent to | identifier[1].value | identifier[1].value |
XCN.2 | Family Name |  |  | is equivalent to | name | name |
XCN.3 | Given Name |  |  | is equivalent to | name.given[1] | name.given[1] |
XCN.4 | Second and Further Given Names or Initials Thereof |  |  | is equivalent to | name.given[2] | name.given[2] |
XCN.5 | Suffix (e.g., JR or III) |  |  | is equivalent to | name.suffix[1] | name.suffix[1] |
XCN.6 | Prefix (e.g., DR) |  |  | is equivalent to | name.prefix | name.prefix |
XCN.7 | Degree (e.g., MD) |  |  | is equivalent to | qualification.code | qualification.code |
XCN.9 | Assigning Authority | If organization |  | is equivalent to | identifier[1].assigner(Organization) | identifier[1].assigner(Organization) |
XCN.9 | Assigning Authority | If system |  | is equivalent to | identifier[1].system | identifier[1].system | 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
XCN.10 | Name Type Code |  |  | is equivalent to | name.use | name.use |
XCN.11 | Identifier Check Digit |  |  | is equivalent to | identifier[1].extension[1].url | identifier[1].extension[1].url |
XCN.11 | Identifier Check Digit |  |  | is equivalent to | identifier[1].extension[1].valueString | identifier[1].extension[1].valueString |
XCN.12 | Check Digit Scheme |  |  | is equivalent to | identifier[1].extension[2].url | identifier[1].extension[2].url |
XCN.12 | Check Digit Scheme |  |  | is equivalent to | identifier[1].extension[2].valueString | identifier[1].extension[2].valueString |
XCN.13 | Identifier Type Code |  |  | is equivalent to | identifier[1].type.coding.code | identifier[1].type.coding.code |
XCN.17 | Name Validity Range |  | IF XCN.19 DOES NOT EXIST AND IF XCN.20 DOES NOT EXIST | is equivalent to | name.period | name.period |
XCN.18 | Name Assembly Order |  |  | is equivalent to | name.family.extension.url | name.family.extension.url |
XCN.18 | Name Assembly Order |  |  | is equivalent to | name.family.extension.valueCode | name.family.extension.valueCode |
XCN.19 | Effective Date |  |  | is equivalent to | name.period.start | name.period.start |
XCN.20 | Expiration Date |  |  | is equivalent to | name.period.end | name.period.end |
XCN.21 | Professional Suffix |  |  | is equivalent to | name.suffix[2] | name.suffix[2] |

### Notes: