{
"description": "This ConceptMap represents a mapping from the HL7 V2 Datatype XCN to the FHIR PractitionerRole Resource.",
"_filename": "ConceptMap-datatype-xcn-to-practitionerrole.json",
"package_name": "hl7.fhir.uv.v2mappings.r4b",
"date": "2025-08-25",
"group": [ {
"element": [ {
"code": "XCN.1",
"target": [ {
"code": "practitioner(Practitioner.identifier[1].value)",
"display": "practitioner(Practitioner.identifier[1].value)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "string"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Person Identifier",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ST"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.2",
"target": [ {
"code": "practitioner(Practitioner.name)",
"display": "practitioner(Practitioner.name)",
"equivalence": "equivalent"
} ],
"display": "Family Name",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "FN"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.3",
"target": [ {
"code": "practitioner(Practitioner.name.given)",
"display": "practitioner(Practitioner.name.given)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "string"
}, {
"url": "cardinalityMin",
"valueInteger": -1
}, {
"url": "cardinalityMax",
"valueInteger": -1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Given Name",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ST"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.4",
"target": [ {
"code": "practitioner(Practitioner.name.given)",
"display": "practitioner(Practitioner.name.given)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "string"
}, {
"url": "cardinalityMin",
"valueInteger": -1
}, {
"url": "cardinalityMax",
"valueInteger": -1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Second and Further Given Names or Initials Thereof",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ST"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.5",
"target": [ {
"code": "practitioner(Practitioner.name.suffix)",
"display": "practitioner(Practitioner.name.suffix)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "string"
}, {
"url": "cardinalityMin",
"valueInteger": -1
}, {
"url": "cardinalityMax",
"valueInteger": -1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Suffix (e.g., JR or III)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ST"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.6",
"target": [ {
"code": "practitioner(Practitioner.name.prefix)",
"display": "practitioner(Practitioner.name.prefix)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "string"
}, {
"url": "cardinalityMin",
"valueInteger": -1
}, {
"url": "cardinalityMax",
"valueInteger": -1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Prefix (e.g., DR)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ST"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.7",
"target": [ {
"code": "practitioner(Practitioner.name.suffix)",
"display": "practitioner(Practitioner.name.suffix)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "string"
}, {
"url": "cardinalityMin",
"valueInteger": -1
}, {
"url": "cardinalityMax",
"valueInteger": -1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Degree (e.g., MD)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.9",
"target": [ {
"code": "practitioner(Practioner.identifier[1].assigner(Organization))",
"display": "practitioner(Practioner.identifier[1].assigner(Organization))",
"dependsOn": [ {
"value": "If organization",
"property": "Narrative-Condition"
} ],
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "Reference(Organization)"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Assigning Authority",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "HD"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.9",
"target": [ {
"code": "practitioner(Practioner.identifier[1].system)",
"comment": "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",
"display": "practitioner(Practioner.identifier[1].system)",
"dependsOn": [ {
"value": "If system",
"property": "Narrative-Condition"
} ],
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "uri"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Assigning Authority",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "HD"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.10",
"target": [ {
"code": "practitioner(Practitioner.name.use)",
"display": "practitioner(Practitioner.name.use)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "code"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
}, {
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70200-to-name-use"
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Name Type Code",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ID"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.11",
"target": [ {
"code": "practitioner(Practitioner.identifier.extension[1].url)",
"display": "practitioner(Practitioner.identifier.extension[1].url)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "uri"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
}, {
"url": "assignment",
"valueString": "\"http://hl7.org/fhir/StructureDefinition/identifier-checkDigit\""
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Identifier Check Digit",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ST"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.11",
"target": [ {
"code": "practitioner(Practitioner.identifier.extension[1].valueString)",
"display": "practitioner(Practitioner.identifier.extension[1].valueString)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "string"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Identifier Check Digit",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ST"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.12",
"target": [ {
"code": "practitioner(Practitioner.identifier.extension[2].url)",
"display": "practitioner(Practitioner.identifier.extension[2].url)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "uri"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
}, {
"url": "assignment",
"valueString": "\"http://hl7.org/fhir/StructureDefinition/namingsystem-checkDigit\""
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Check Digit Scheme",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ID"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.12",
"target": [ {
"code": "practitioner(Practitioner.identifier.extension[2].valueString)",
"display": "practitioner(Practitioner.identifier.extension[2].valueString)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "string"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Check Digit Scheme",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ID"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.13",
"target": [ {
"code": "practitioner(Practitioner.identifier.type.coding.code)",
"display": "practitioner(Practitioner.identifier.type.coding.code)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "code"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
}, {
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70203-to-v2-0203"
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Identifier Type Code",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ID"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.17",
"target": [ {
"code": "practitioner(Practitioner.name.period)",
"display": "practitioner(Practitioner.name.period)",
"dependsOn": [ {
"value": "IF XCN.19 NOT VALUED XCN.20 NOT VALUED",
"property": "Computable-ANTLR"
} ],
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "Period"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Name Validity Range",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.18",
"target": [ {
"code": "practitioner(Practitioner.name.family.extension.url)",
"display": "practitioner(Practitioner.name.family.extension.url)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "uri"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
}, {
"url": "assignment",
"valueString": "\"http://hl7.org/fhir/R4/extension-humanname-assembly-order.html\""
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Name Assembly Order",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ID"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.18",
"target": [ {
"code": "practitioner(Practitioner.name.family.extension.valueCode)",
"display": "practitioner(Practitioner.name.family.extension.valueCode)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "code"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
}, {
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70444-to-v2-0444"
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Name Assembly Order",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ID"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.19",
"target": [ {
"code": "practitioner(Practitioner.name.period.start)",
"display": "practitioner(Practitioner.name.period.start)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "dateTime"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Effective Date",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "DTM"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.20",
"target": [ {
"code": "practitioner(Practitioner.name.period.end)",
"display": "practitioner(Practitioner.name.period.end)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "dateTime"
}, {
"url": "cardinalityMin",
"valueInteger": 1
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Expiration Date",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "DTM"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
}, {
"code": "XCN.21",
"target": [ {
"code": "practitioner(Practitioner.name.suffix)",
"display": "practitioner(Practitioner.name.suffix)",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "string"
}, {
"url": "cardinalityMin",
"valueInteger": -1
}, {
"url": "cardinalityMax",
"valueInteger": -1
} ]
} ],
"equivalence": "equivalent"
} ],
"display": "Professional Suffix",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
"extension": [ {
"url": "type",
"valueCode": "ST"
}, {
"url": "cardinalityMin",
"valueInteger": 0
}, {
"url": "cardinalityMax",
"valueInteger": 1
} ]
} ]
} ]
} ],
"publisher": "HL7 International / Orders and Observations",
"jurisdiction": [ {
"coding": [ {
"code": "001",
"system": "http://unstats.un.org/unsd/methods/m49/m49.htm"
} ]
} ],
"name": "DatatypeXCNToPractitionerRole",
"copyright": "Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.",
"type": null,
"experimental": "true",
"resourceType": "ConceptMap",
"title": "Datatype XCN to PractitionerRole Map",
"package_version": "1.0.0",
"extension": [ {
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/RelatedArtifact",
"extension": [ {
"url": "type",
"valueCode": "derived-from"
}, {
"url": "label",
"valueString": "Datatype XCN to PractitionerRole.fsh"
}, {
"url": "url",
"valueUri": "https://docs.google.com/spreadsheets/d/1IXMRcpSKosDeviTGPb-v0FJ1OAYgBzRft5H-tGcFUgk/edit#gid=0"
} ]
}, {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
"valueCode": "oo"
}, {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "informative",
"_valueCode": {
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
"valueCanonical": "http://hl7.org/fhir/uv/v2mappings/ImplementationGuide/hl7.fhir.uv.v2mappings"
} ]
}
} ],
"status": "active",
"id": "b83d6afe-0d3c-4124-8bb6-94fbc7bf6b5a",
"kind": null,
"url": "http://hl7.org/fhir/uv/v2mappings/ConceptMap/datatype-xcn-to-practitionerrole",
"version": "1.0.0",
"contact": [ {
"name": "HL7 Orders and Observations Workgroup",
"telecom": [ {
"value": "http://www.hl7.org/Special/committees/orders",
"system": "url"
} ]
} ]
}