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: Segment ROL to CareTeam Map (Experimental)

Official URL: http://hl7.org/fhir/uv/v2mappings/ConceptMap/segment-rol-to-careteam | Version: 1.0.0
Standards status: Informative | Computable Name: SegmentROLToCareTeam
Copyright/Legal: Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.

This ConceptMap represents a mapping from the HL7 V2 Segment ROL to the FHIR CareTeam Resource.

This ConceptMap represents the mapping from the HL7 V2 ROL Segment to the FHIR CareTeam 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 | Extension | Data Type | Cardinality - Min | Cardinality - Max | Data Type Mapping | Vocabulary Mapping (IS, ID, CE, CEN, CWE) | Assignment
1 | ROL-1 | Role Instance ID | EI | 0 | 1 |  |  |  |  |  |  |  |  |  |  |  |
2 | ROL-2 | Action Code | ID | 0 | 1 |  |  |  |  |  |  |  |  |  |  |  |
3 | ROL-3 | Role-ROL | CWE | 0 | 1 |  |  |  | CareTeam.participant.role |  | CodeableConcept | 0 | -1 | CWE[CodeableConcept] | ProviderRole |  |
4 | ROL-4 | Role Person | XCN | 0 | -1 |  |  | Depending on ROL-3 | CareTeam.participant.member(CareTeam.Practitioner) |  | Reference | 0 | 1 | XCN[Practitioner] |  |  |
4 | ROL-4 | Role Person | XCN | 0 | -1 |  |  | Depending on ROL-3 | CareTeam.participant.member(CareTeam.Patient) |  | Reference | 0 | 1 | XCN[Patient] |  |  |
4 | ROL-4 | Role Person | XCN | 0 | -1 |  |  | Depending on ROL-3 | CareTeam.participant.member(CareTeam.RelatedPerson) |  | Reference | 0 | 1 | XCN[RelatedPerson] |  |  |
5 | ROL-5 | Role Begin Date/Time | DTM | 0 | 1 |  |  |  | CareTeam.participant.period.start |  | dateTime | 0 | 1 | DTM[DateTime] |  |  |
6 | ROL-6 | Role End Date/Time | DTM | 0 | 1 |  |  |  | CareTeam.participant.period.end |  | dateTime | 0 | 1 | DTM[DateTime] |  |  |
7 | ROL-7 | Role Duration | CWE | 0 | 1 |  |  |  |  | participant.period.extension??-duration | decimal | 0 | 1 | CWE[CodeableConcept] |  |  |
8 | ROL-8 | Role Action Reason | CWE | 0 | 1 |  |  |  | CareTeam.reasonCode |  | CodeableConcept | 0 | -1 | CWE[CodeableConcept] |  |  |
9 | ROL-9 | Provider Type | CWE | 0 | -1 |  |  |  | CareTeam.participant.role |  | CodeableConcept | 0 | -1 | CWE[CodeableConcept] |  |  |
10 | ROL-10 | Organization Unit Type | CWE | 0 | 1 | IF ROL-4 VALUED |  |  | CareTeam.participant.onBehalfOf(CareTeam.Organization) |  | Reference | 0 | 1 | CWE[CodeableConcept] |  |  |
10 | ROL-10 | Organization Unit Type | CWE | 0 | 1 | IF ROL-4 NOT VALUED |  |  | CareTeam.participant.member(CareTeam.Organization.type) |  | CodeableConcept | 0 | 1 | CWE[CodeableConcept] | ParticipantOrganizationUnitType |  |
11 | ROL-11 | Office/Home Address/Birthplace | XAD | 0 | -1 |  |  |  |  |  |  |  |  |  |  |  |
12 | ROL-12 | Phone | XTN | 0 | -1 |  |  |  | CareTeam.telecom |  | ContactPoint | 0 | -1 | XTN[ContactPoint] |  |  |
13 | ROL-13 | Person's Location | PL | 0 | 1 |  |  |  |  |  |  |  |  |  |  |  | Unclear yet how we can map to Encounter location, but when part of a care team ROL-11 would be used, not the physical location while in the hospital.
14 | ROL-14 | Organization | XON | 0 | 1 | IF ROL-4 VALUED |  |  | CareTeam.participant.onBehalfOf(CareTeam.Organization) |  | Reference |  |  | XON[Organization] |  |  |
14 | ROL-14 | Organization | XON | 0 | 1 | IF ROL-4 NOT VALUED |  |  | CareTeam.participant.member(CareTeam.Organization) |  | Reference |  |  | XON[Organization] |  |  |

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
Codes from | NarrativeCondition | ComputableANTLR |  | Codes from
ROL-3 | Role-ROL |  |  | is equivalent to | participant.role[1] | participant.role[1]
ROL-4 | Role Person | Depending on ROL-3 |  | is equivalent to | participant.member(Practitioner[1]) | participant.member(Practitioner[1])
ROL-4 | Role Person | Depending on ROL-3 |  | is equivalent to | participant.member(Patient[1]) | participant.member(Patient[1])
ROL-4 | Role Person | Depending on ROL-3 |  | is equivalent to | participant.member(RelatedPerson[1]) | participant.member(RelatedPerson[1])
ROL-5 | Role Begin Date/Time |  |  | is equivalent to | participant.period.start | participant.period.start
ROL-6 | Role End Date/Time |  |  | is equivalent to | participant.period.end | participant.period.end
ROL-8 | Role Action Reason |  |  | is equivalent to | reasonCode | reasonCode
ROL-9 | Provider Type |  |  | is equivalent to | participant.role[2] | participant.role[2]
ROL-10 | Organization Unit Type |  | IF ROL-4 VALUED | is equivalent to | participant.onBehalfOf(Organization[1]) | participant.onBehalfOf(Organization[1])
ROL-10 | Organization Unit Type |  | IF ROL-4 NOT VALUED | is equivalent to | participant.member(Organization[1].type) | participant.member(Organization[1].type)
ROL-12 | Phone |  |  | is equivalent to | telecom | telecom
ROL-14 | Organization |  | IF ROL-4 VALUED | is equivalent to | participant.onBehalfOf(Organization[1]) | participant.onBehalfOf(Organization[1])
ROL-14 | Organization |  | IF ROL-4 NOT VALUED | is equivalent to | participant.member(Organization[1]) | participant.member(Organization[1])

### Notes: