Segment ROL in FHIR

How segment ROL (Role) becomes FHIR R4 resources, from the HL7 Version 2 to FHIR guide.

HL7 v2 definition: Definition of ROL in HL7 v2 2.8
Maps: Patient (GeneralPractitioner)Encounter (PractitionerRole)CareTeam RelatedPerson
Used in messages: ADT_A01 ADT_A02 ADT_A05 ADT_A06

To PatientGeneralPractitioner11 rows

HL7 v2 source	v2 type	FHIR element	FHIR type	Conditions and notes
ROL-1Role Instance Id	EI	generalPractitioner(PractitionerRole.identifier)	Identifier
ROL-3Role-rol	CWE	generalPractitioner(PractitionerRole.code)	CodeableConcept	Code map v3-participationtype
ROL-4Role Person	XCN	generalPractitioner(PractitionerRole.practitioner)	`Reference(`Practitioner`)`
ROL-5Role Begin Date/Time	DTM	generalPractitioner(PractitionerRole.period.start)	`dateTime`
ROL-6Role End Date/Time	DTM	generalPractitioner(PractitionerRole.period.end)	`dateTime`
ROL-11Office/Home Address/Birthplace	XAD	`generalPractitioner(PractitionerRole.Practitioner(Practitioner.address))`	Address	If `IF XAD.7 IN ("N","BDL","F","H","P","BR","V")`
ROL-11Office/Home Address/Birthplace	XAD	`generalPractitioner(PractitionerRole.location(Location.address))`	Address	If `IF XAD.7 IN ("M","O","S","SH","TM")`
ROL-11Office/Home Address/Birthplace	XAD	`generalPractitioner(PractitionerRole.organization.(Organization.address))`	Address	If `IF XAD.7 IN ("B","BI","L")`
ROL-12Phone	XTN	generalPractitioner(PractitionerRole.telecom)	ContactPoint
ROL-13Person's Location	PL	`generalPractitioner(PractitionerRole.location(Location))`	`Reference(`Location`)`
ROL-14Organization	XON	`generalPractitioner(PractitionerRole.organization.(Organization))`	`Reference(`Organization`)`

To EncounterPractitionerRole10 rows

HL7 v2 source	v2 type	FHIR element	FHIR type	Conditions and notes
ROL-1Role Instance Id	EI	participant[1].individual.reference	Identifier
ROL-1Role Instance Id	EI	participant[1].individual[1](PractitionerRole.identifier)
ROL-3Role-rol	CWE	participant[1].type	CodeableConcept	Code map v3-participationtype
ROL-4Role Person	XCN	participant[1].individual(PractitionerRole.practitioner)	`Reference(`Practitioner`)`
ROL-5Role Begin Date/Time	DTM	participant[1].period.start	`dateTime`
ROL-6Role End Date/Time	DTM	participant[1].period.end	`dateTime`
ROL-11Office/Home Address/Birthplace	XAD	participant[1].individual(PractitionerRole.practioner(Practitioner.address))	Address
ROL-12Phone	XTN	participant[1].individual(PractitionerRole.telecom)	ContactPoint
ROL-13Person's Location	PL	participant[1].individual(PractitionerRole.location(Location))	`Reference(`Location`)`
ROL-14Organization	XON	participant[1].individual(PractitionerRole.organziation.(Organization))	`Reference(`Organization`)`

To CareTeam13 rows

HL7 v2 source	v2 type	FHIR element	FHIR type	Conditions and notes
ROL-3Role-rol	CWE	participant.role[1]	CodeableConcept	Code map v3-participationtype
ROL-4Role Person	XCN	participant.member(Practitioner[1])	`Reference`	Depending on ROL-3
ROL-4Role Person	XCN	participant.member(Patient[1])	`Reference`	Depending on ROL-3
ROL-4Role Person	XCN	participant.member(RelatedPerson[1])	`Reference`	Depending on ROL-3
ROL-5Role Begin Date/Time	DTM	participant.period.start	DateTime
ROL-6Role End Date/Time	DTM	participant.period.end	DateTime
ROL-8Role Action Reason	CWE	reasonCode	CodeableConcept
ROL-9Provider Type	CWE	participant.role[2]	CodeableConcept
ROL-10Organization Unit Type	CWE	participant.onBehalfOf(Organization[1])	`Reference`	If `IF ROL-4 VALUED`
ROL-10Organization Unit Type	CWE	participant.member(Organization[1].type)	CodeableConcept	If `IF ROL-4 NOT VALUED`Code map unspecified_mapping
ROL-12Phone	XTN	telecom	ContactPoint
ROL-14Organization	XON	participant.onBehalfOf(Organization[1])	`Reference`	If `IF ROL-4 VALUED`
ROL-14Organization	XON	participant.member(Organization[1])	`Reference`	If `IF ROL-4 NOT VALUED`

To RelatedPerson7 rows

HL7 v2 source	v2 type	FHIR element	FHIR type	Conditions and notes
ROL-1Role Instance Id	EI	identifier	Identifier
ROL-3Role-rol	CWE	relationship	CodeableConcept	Code map v3-participationtype
ROL-4Role Person	XCN	`$this`
ROL-5Role Begin Date/Time	DTM	period.start	`dateTime`
ROL-6Role End Date/Time	DTM	period.end	`dateTime`
ROL-11Office/Home Address/Birthplace	XAD	address	Address
ROL-12Phone	XTN	telecom	ContactPoint