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
| 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]) | |
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