NEWFree ROI Calculators — quantify what prior auth and siloed data are costing your organization.Prior Auth ROI Siloed Data ROI
HL7 v2Segment5 min read

HL7 PRB Segment: Problem Details

The PRB segment carries one problem-list entry: the problem code, when it was established and resolved, its life-cycle status, onset, and ranking. It is the core of the PPR (patient problem) message and underpins problem-oriented records.

Purpose

PRB conveys a single clinical problem and its management metadata — identity (PRB-3), instance and episode links, established/resolution dates, life-cycle status, onset, and certainty/ranking — using an action code (PRB-1) to add, update, or delete the entry.

Used in

PRB appears in problem-oriented messages: PPR (patient problem) and related care-record messages. See PPR.

Field-by-field reference

Source: HAPI HL7v2 v2.5.1 javadocs (PRB) for sequence, name, and data type. Length is not published in the javadocs (); Required and Table # are filled from the HL7 v2.5.1 standard where well-established.

SeqNameData TypeLengthReqRepeatTable #Description
PRB-1Action CodeIDRHL70287Add/update/delete the problem.
PRB-2Action Date/TimeTSRWhen the action occurred.
PRB-3Problem IDCERThe coded problem (e.g. ICD-10/SNOMED).
PRB-4Problem Instance IDEIOUnique problem instance.
PRB-5Episode of Care IDEIOEpisode of care link.
PRB-6Problem List PriorityNMOPriority on the list.
PRB-7Problem Established Date/TimeTSOWhen established.
PRB-8Anticipated Problem Resolution Date/TimeTSOExpected resolution.
PRB-9Actual Problem Resolution Date/TimeTSOActual resolution.
PRB-10Problem ClassificationCEOClassification.
PRB-11Problem Management DisciplineCEOYManaging discipline.
PRB-12Problem PersistenceCEOPersistence (chronic, acute).
PRB-13Problem Confirmation StatusCEOConfirmation status.
PRB-14Problem Life Cycle StatusCEOLife-cycle status (active, resolved).
PRB-15Problem Life Cycle Status Date/TimeTSOStatus date.
PRB-16Problem Date of OnsetTSOOnset date.
PRB-17Problem Onset TextSTOOnset description.
PRB-18Problem RankingCEORanking.
PRB-19Certainty of ProblemCEOCertainty.
PRB-20Probability of Problem (0-1)NMOProbability.
PRB-21Individual Awareness of ProblemCEOPatient awareness.
PRB-22Problem PrognosisCEOPrognosis.
PRB-23Individual Awareness of PrognosisCEOAwareness of prognosis.
PRB-24Family/Significant Other Awareness of Problem/PrognosisSTOFamily awareness.
PRB-25Security/SensitivityCEOSecurity/sensitivity.

Most-used fields

  • PRB-1 Action Code and PRB-2 Action Date/Time drive add/update/delete of the problem entry.
  • PRB-3 Problem ID is the coded problem; PRB-14 Life Cycle Status and PRB-16 Onset track its clinical course.

Version differences (2.3 to 2.8.2)

  • PRB was introduced with problem/goal messaging in v2.3 and is stable through later versions.
  • Coded fields use CE; later versions add CWE-style coding in some implementations.

Common mistakes

  • Ignoring PRB-1 and treating every PRB as an add, duplicating problems.
  • Confusing PRB-14 life-cycle status with PRB-13 confirmation status.

Examples

Minimal valid PRB:

PRB|AD|20260610100000|E11.9^Type 2 diabetes^I10

Fully-populated PRB:

PRB|AD|20260610100000|E11.9^Type 2 diabetes^I10|PRB55^MERCYGEN||1|20240101000000|||C^Chronic^L||CH^Chronic^L|CONF^Confirmed^L|A^Active^L|20240101000000|20231215000000

Annotated breakdown of the fully-populated example (selected fields):

PRB                        ← segment ID
AD                         ← PRB-1  Action Code (Add)
20260610100000             ← PRB-2  Action Date/Time
E11.9^Type 2 diabetes^I10  ← PRB-3  Problem ID
PRB55^MERCYGEN             ← PRB-4  Problem Instance ID
1                          ← PRB-6  Problem List Priority
A^Active^L                 ← PRB-14 Problem Life Cycle Status
20231215000000             ← PRB-16 Problem Date of Onset

In-context inside a PPR^PC1 (problem add):

MSH|^~&|EHR|MERCYGEN|REG|MERCYGEN|20260610100000||PPR^PC1^PPR_PC1|MSG910|P|2.5.1
PID|1||MR12345^^^MERCYGEN^MR||DOE^JOHN^Q||19800101|M
PRB|AD|20260610100000|E11.9^Type 2 diabetes^I10|PRB55^MERCYGEN||1

In-context inside a PPR^PC2 (problem update):

MSH|^~&|EHR|MERCYGEN|REG|MERCYGEN|20260701100000||PPR^PC2^PPR_PC2|MSG911|P|2.5.1
PID|1||MR12345^^^MERCYGEN^MR||DOE^JOHN^Q||19800101|M
PRB|UP|20260701100000|E11.9^Type 2 diabetes^I10|PRB55^MERCYGEN|||||| |||RES^Resolved^L

FHIR mapping

No segment-level ConceptMap is published in the v2-to-FHIR IG for PRB. A problem-list entry maps conceptually to Condition (with clinicalStatus/verificationStatus from the life-cycle and confirmation fields); implementations define this locally.

Engine considerations

  • Branch on PRB-1 — update/delete must act on the existing problem (matched by PRB-4), not create duplicates.
  • Map PRB-14 life-cycle status to the target system's active/resolved states.

How Vorro parses and produces PRB

Vorro keys problems by PRB-4 instance id, applies PRB-1 add/update/delete semantics idempotently, and maps life-cycle and confirmation status to FHIR Condition status elements on output.

  • GOL — goals associated with the problem.
  • PTH — pathways linking problems and goals.
  • PPR messages — the problem message PRB heads.

Sources

← Back to HL7 v2 Guide

Ready to Integrate This Into Your Workflow?

Talk to a Vorro expert about implementing HL7 v2 in your specific environment.

Browse HL7 v2 Guides
HL7 PRB Segment: Problem Details | Vorro Academy | Vorro