Reference·ROL Segment·ROL-3
HL7 v2 Reference

ROL-3 in HL7 v2: A Field Guide to Role-ROL

Jul 28, 2026 · 4 min read
← ROL-1 ROL-4 →

ROL-3 is the field that actually tells a receiving system what kind of participant this ROL segment describes, and it is where local code table drift causes some of the quietest interface failures around.

Quick answer

ROL-3 carries a coded value naming the specific role a person or organization is playing in the message, such as attending provider, referring provider, or consulting provider. The code typically comes paired with a display name and the identifier of the table it was pulled from, since many organizations maintain their own local role tables rather than relying on a single universal list.

What this field contains

Structure
Coded element — usually three components: the code itself, a human-readable text description, and the name of the table it came from
Common values
Provider role codes — attending, referring, and consulting provider are the most frequently seen, though organizations often extend the list locally
Common failure
Code table mismatch — sending and receiving systems using different local tables for the same conceptual role, so the code parses fine but maps to nothing on the other end

Example

Synthetic example Generated by Synthibase
ROL|2|UP|RT^Referring Provider^SYNTHIBLOCAL|4498210^OKONKWO^DAVID^^^DR^MD|20260727093000

ROL-3 here is RT^Referring Provider^SYNTHIBLOCAL, marking this role as the referring provider using a fictional local code table.

Where this trips people up

Because so many organizations define their own role code tables instead of relying on a shared standard, a code that means "consulting provider" in one system's table can be undefined, or worse, mean something else entirely, in another. Test suites that only ever generate the attending-provider code miss this entirely, since it is a single well-known value everyone happens to agree on. The moment a message needs a less common role, the code-table assumption baked into the receiving system's mapping logic is what actually gets tested.

HL7 v2 ROL Segment Guide: Fields, Format, and Testing Gotchas
Epic vs. Cerner vs. MEDITECH: An Interoperability Comparison
HL7 ADT Messages: A01 through A08 Explained
Cover the full spread of role codes, not just the obvious one
Synthibase generates test messages across attending, referring, consulting, and locally defined role codes, so your code-table mapping logic gets tested against more than the one everyone remembers.
Start free trial →
This page is written independently by Synthibase for testing and informational purposes. It is not an official publication of HL7 International or X12/Washington Publishing Company, and is not a substitute for reviewing the official standard or your trading partner's companion guide. See our Terms of Service for full legal terms.