HL7 Version 2 to FHIR
1.0.0 - STU 1 International flag

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

ConceptMap: Segment ROL [GeneralPractitioner] to Patient Map (Experimental)

Official URL: http://hl7.org/fhir/uv/v2mappings/ConceptMap/segment-rol-generalpractitioner-to-patient Version: 1.0.0
Standards status: Informative Computable Name: SegmentROLGeneralPractitionerToPatient

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 Patient Resource.

This ConceptMap represents the mapping from the HL7 V2 ROL Segment to the FHIR Patient Resource. See also the FHIR Shorthand or the CSV Source.

HL7 v2Condition (IF True, args)HL7 FHIRComments
Sort OrderIdentifierNameData TypeCardinality - MinCardinality - MaxComputable ANTLRComputable FHIRPathNarrativeFHIR AttributeExtensionData TypeCardinality - MinCardinality - MaxData Type MappingVocabulary Mapping
(IS, ID, CE, CEN, CWE)		Assignment
1ROL-1Role Instance IDEI01Patient.generalPractitioner(Patient.PractitionerRole.identifier)Identifier0-1EI[Identifier-Extension]
2ROL-2Action CodeID11if mapped to a restful service to progress the message.
3ROL-3Role-ROLCWE11Patient.generalPractitioner(Patient.PractitionerRole.code)CodeableConceptCWE[CodeableConcept]ProviderRole
4ROL-4Role PersonXCN1-1Patient.generalPractitioner(Patient.PractitionerRole.practitioner)Reference(Patient.Practitioner)XCN[Practitioner]
5ROL-5Role Begin Date/TimeDTM01Patient.generalPractitioner(Patient.PractitionerRole.period.start)dateTime
6ROL-6Role End Date/TimeDTM01Patient.generalPractitioner(Patient.PractitionerRole.period.end)dateTime
7ROL-7Role DurationCWE01
8ROL-8Role Action ReasonCWE01
9ROL-9Provider TypeCWE0-1
10ROL-10Organization Unit TypeCWE01
11ROL-11Office/Home Address/BirthplaceXAD0-1IF XAD.7 IN ("N","BDL","F","H","P","BR","V")Patient.generalPractitioner(Patient.PractitionerRole.Practitioner(Patient.Practitioner.address)Address0-1XAD[Address]
11ROL-11Office/Home Address/BirthplaceXAD0-1IF XAD.7 IN ("M","O","S","SH","TM")Patient.generalPractitioner(Patient.PractitionerRole.location(Patient.Location.address)Address0-1XAD[Address]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]))
11ROL-11Office/Home Address/BirthplaceXAD0-1IF XAD.7 IN ("B","BI","L")Patient.generalPractitioner(Patient.PractitionerRole.organization.(Patient.Organization.address)Address0-1XAD[Address]
11ROL-11Office/Home Address/BirthplaceXAD0-1IF XAD.7 IN ("BA","C","RH")Requires local consideration whether to use practitioner, location, or organization destination.
12ROL-12PhoneXTN0-1Patient.generalPractitioner(Patient.PractitionerRole.telecom)ContactPoint0-1XTN[ContactPoint]
13ROL-13Person's LocationPL01Patient.generalPractitioner(Patient.PractitionerRole.location(Patient.Location)Reference(Patient.Location)01PL[Location]We seek more information on how this is mapped/merged with ROL-11.
14ROL-14OrganizationXON01Patient.generalPractitioner(Patient.PractitionerRole.organization.(Patient.Organization)Reference(Patient.Organization)01XON[Organization]We seek more information on how this is mapped/merged with ROL-11.

Mapping from (not specified) to (not specified)


Group 1 Mapping from unspecified code system to unspecified code system

Source Concept DetailsRelationshipTarget Concept DetailsComment
Codes from ComputableANTLRCodes from
ROL-1Role Instance IDis equivalent togeneralPractitioner(PractitionerRole.identifier)generalPractitioner(PractitionerRole.identifier)
ROL-3Role-ROLis equivalent togeneralPractitioner(PractitionerRole.code)generalPractitioner(PractitionerRole.code)
ROL-4Role Personis equivalent togeneralPractitioner(PractitionerRole.practitioner)generalPractitioner(PractitionerRole.practitioner)
ROL-5Role Begin Date/Timeis equivalent togeneralPractitioner(PractitionerRole.period.start)generalPractitioner(PractitionerRole.period.start)
ROL-6Role End Date/Timeis equivalent togeneralPractitioner(PractitionerRole.period.end)generalPractitioner(PractitionerRole.period.end)
ROL-11Office/Home Address/BirthplaceIF XAD.7 IN ("N","BDL","F","H","P","BR","V")is equivalent togeneralPractitioner(PractitionerRole.Practitioner(Practitioner.address))generalPractitioner(PractitionerRole.Practitioner(Practitioner.address))
ROL-11Office/Home Address/BirthplaceIF XAD.7 IN ("M","O","S","SH","TM")is equivalent togeneralPractitioner(PractitionerRole.location(Location.address))generalPractitioner(PractitionerRole.location(Location.address))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]))
ROL-11Office/Home Address/BirthplaceIF XAD.7 IN ("B","BI","L")is equivalent togeneralPractitioner(PractitionerRole.organization.(Organization.address))generalPractitioner(PractitionerRole.organization.(Organization.address))
ROL-12Phoneis equivalent togeneralPractitioner(PractitionerRole.telecom)generalPractitioner(PractitionerRole.telecom)
ROL-13Person's Locationis equivalent togeneralPractitioner(PractitionerRole.location(Location))generalPractitioner(PractitionerRole.location(Location))We seek more information on how this is mapped/merged with ROL-11.
ROL-14Organizationis equivalent togeneralPractitioner(PractitionerRole.organization.(Organization))generalPractitioner(PractitionerRole.organization.(Organization))We seek more information on how this is mapped/merged with ROL-11.

Notes: