HL7 Version 2 to FHIR
1.0.0 - STU 1
HL7 Version 2 to FHIR
1.0.0 - STU 1
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
| Page standards status: Informative |
{
"resourceType" : "ConceptMap",
"id" : "segment-rol-generalpractitioner-to-patient",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ConceptMap segment-rol-generalpractitioner-to-patient</b></p><a name=\"segment-rol-generalpractitioner-to-patient\"> </a><a name=\"hcsegment-rol-generalpractitioner-to-patient\"> </a><p>Mapping from (not specified) to (not specified)</p><br/><p><b>Group 1 </b>Mapping from <code>unspecified code system</code> to <code>unspecified code system</code></p><table class=\"grid\"><tr><td colspan=\"3\"><b>Source Concept Details</b></td><td><b>Relationship</b></td><td colspan=\"2\"><b>Target Concept Details</b></td><td><b>Comment</b></td></tr><tr><td colspan=\"2\"><b>Codes</b> from </td><td><b>ComputableANTLR</b></td><td/><td colspan=\"2\"><b>Codes</b> from </td><td/></tr><tr><td style=\"border-right-width: 0px\">ROL-1</td><td style=\"border-left-width: 0px\">Role Instance ID</td><td/><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.identifier)</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.identifier)</td><td/></tr><tr><td style=\"border-right-width: 0px\">ROL-3</td><td style=\"border-left-width: 0px\">Role-ROL</td><td/><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.code)</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.code)</td><td/></tr><tr><td style=\"border-right-width: 0px\">ROL-4</td><td style=\"border-left-width: 0px\">Role Person</td><td/><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.practitioner)</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.practitioner)</td><td/></tr><tr><td style=\"border-right-width: 0px\">ROL-5</td><td style=\"border-left-width: 0px\">Role Begin Date/Time</td><td/><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.period.start)</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.period.start)</td><td/></tr><tr><td style=\"border-right-width: 0px\">ROL-6</td><td style=\"border-left-width: 0px\">Role End Date/Time</td><td/><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.period.end)</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.period.end)</td><td/></tr><tr><td style=\"border-right-width: 0px\">ROL-11</td><td style=\"border-left-width: 0px\">Office/Home Address/Birthplace</td><td>IF XAD.7 IN ("N","BDL","F","H","P","BR","V")</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.Practitioner(Practitioner.address))</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.Practitioner(Practitioner.address))</td><td/></tr><tr><td style=\"border-right-width: 0px\">ROL-11</td><td style=\"border-left-width: 0px\">Office/Home Address/Birthplace</td><td>IF XAD.7 IN ("M","O","S","SH","TM")</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.location(Location.address))</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.location(Location.address))</td><td>We seek feedback whether we actually should vary this based on ROL-13 being valued. If not valued, then put it in Patient.generalPractitioner(PractitionerRole.Practitioner(Practitioner.address[2]))</td></tr><tr><td style=\"border-right-width: 0px\">ROL-11</td><td style=\"border-left-width: 0px\">Office/Home Address/Birthplace</td><td>IF XAD.7 IN ("B","BI","L")</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.organization.(Organization.address))</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.organization.(Organization.address))</td><td/></tr><tr><td style=\"border-right-width: 0px\">ROL-12</td><td style=\"border-left-width: 0px\">Phone</td><td/><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.telecom)</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.telecom)</td><td/></tr><tr><td style=\"border-right-width: 0px\">ROL-13</td><td style=\"border-left-width: 0px\">Person's Location</td><td/><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.location(Location))</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.location(Location))</td><td>We seek more information on how this is mapped/merged with ROL-11.</td></tr><tr><td style=\"border-right-width: 0px\">ROL-14</td><td style=\"border-left-width: 0px\">Organization</td><td/><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">generalPractitioner(PractitionerRole.organization.(Organization))</td><td style=\"border-left-width: 0px\">generalPractitioner(PractitionerRole.organization.(Organization))</td><td>We seek more information on how this is mapped/merged with ROL-11.</td></tr></table></div>"
},
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "derived-from"
},
{
"url" : "label",
"valueString" : "Segment ROL[GeneralPractitioner] to Patient.fsh"
},
{
"url" : "url",
"valueUri" : "https://docs.google.com/spreadsheets/d/1k_CXL1pI4XSfDj93bYImERZ_fm5Cwm9tzQj_IKHBAeI/edit#gid=0"
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/RelatedArtifact"
},
{
"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"
}
]
}
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/ConceptMap/segment-rol-generalpractitioner-to-patient",
"version" : "1.0.0",
"name" : "SegmentROLGeneralPractitionerToPatient",
"title" : "Segment ROL [GeneralPractitioner] to Patient Map",
"status" : "active",
"experimental" : true,
"date" : "2025-08-25",
"publisher" : "HL7 International / Orders and Observations",
"contact" : [
{
"name" : "HL7 Orders and Observations Workgroup",
"telecom" : [
{
"system" : "url",
"value" : "http://www.hl7.org/Special/committees/orders"
}
]
}
],
"description" : "This ConceptMap represents a mapping from the HL7 V2 Segment ROL to the FHIR Patient Resource.",
"jurisdiction" : [
{
"coding" : [
{
"system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
"code" : "001"
}
]
}
],
"copyright" : "Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.",
"group" : [
{
"element" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "EI"
},
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-1",
"display" : "Role Instance ID",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "Identifier"
},
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.identifier)",
"display" : "generalPractitioner(PractitionerRole.identifier)",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "CWE"
},
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-3",
"display" : "Role-ROL",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "CodeableConcept"
},
{
"url" : "mappedVia",
"valueUrl" : "ConceptMap/table-hl70443-to-v3-participationtype"
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.code)",
"display" : "generalPractitioner(PractitionerRole.code)",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "XCN"
},
{
"url" : "cardinalityMin",
"valueInteger" : -1
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-4",
"display" : "Role Person",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "Reference(Practitioner)"
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.practitioner)",
"display" : "generalPractitioner(PractitionerRole.practitioner)",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "DTM"
},
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-5",
"display" : "Role Begin Date/Time",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "dateTime"
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.period.start)",
"display" : "generalPractitioner(PractitionerRole.period.start)",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "DTM"
},
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-6",
"display" : "Role End Date/Time",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "dateTime"
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.period.end)",
"display" : "generalPractitioner(PractitionerRole.period.end)",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "XAD"
},
{
"url" : "cardinalityMin",
"valueInteger" : -1
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-11",
"display" : "Office/Home Address/Birthplace",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "Address"
},
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.Practitioner(Practitioner.address))",
"display" : "generalPractitioner(PractitionerRole.Practitioner(Practitioner.address))",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF XAD.7 IN (\"N\",\"BDL\",\"F\",\"H\",\"P\",\"BR\",\"V\")"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "XAD"
},
{
"url" : "cardinalityMin",
"valueInteger" : -1
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-11",
"display" : "Office/Home Address/Birthplace",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "Address"
},
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.location(Location.address))",
"display" : "generalPractitioner(PractitionerRole.location(Location.address))",
"equivalence" : "equivalent",
"comment" : "We seek feedback whether we actually should vary this based on ROL-13 being valued. If not valued, then put it in Patient.generalPractitioner(PractitionerRole.Practitioner(Practitioner.address[2]))",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF XAD.7 IN (\"M\",\"O\",\"S\",\"SH\",\"TM\")"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "XAD"
},
{
"url" : "cardinalityMin",
"valueInteger" : -1
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-11",
"display" : "Office/Home Address/Birthplace",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "Address"
},
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.organization.(Organization.address))",
"display" : "generalPractitioner(PractitionerRole.organization.(Organization.address))",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF XAD.7 IN (\"B\",\"BI\",\"L\")"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "XTN"
},
{
"url" : "cardinalityMin",
"valueInteger" : -1
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-12",
"display" : "Phone",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "ContactPoint"
},
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.telecom)",
"display" : "generalPractitioner(PractitionerRole.telecom)",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "PL"
},
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-13",
"display" : "Person's Location",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "Reference(Location)"
},
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.location(Location))",
"display" : "generalPractitioner(PractitionerRole.location(Location))",
"equivalence" : "equivalent",
"comment" : "We seek more information on how this is mapped/merged with ROL-11."
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "XON"
},
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ROL-14",
"display" : "Organization",
"target" : [
{
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "Reference(Organization)"
},
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "generalPractitioner(PractitionerRole.organization.(Organization))",
"display" : "generalPractitioner(PractitionerRole.organization.(Organization))",
"equivalence" : "equivalent",
"comment" : "We seek more information on how this is mapped/merged with ROL-11."
}
]
}
]
}
]
}
IG © 2020+ HL7 International / Orders and Observations. Package hl7.fhir.uv.v2mappings#1.0.0 based on FHIR 4.0.1. Generated 2025-08-25
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change