Skip to content

EOB note retrieval

EOB note retrieval loads the explanation-of-benefits note text recorded for a bill during audit processing. It is a standalone read-only stored-procedure call — it does not depend on, and is not depended on by, audit service or adjustment retrieval — but it shares the same suppression flag and bill-scoping pattern as the other bill child-collection retrievals.

Field Value
Operation ID OP-MB-04
Trigger clsMedicalBill.EOBNotes (lazy read, unless SuppressAuditDetail is set)
Inputs BillID
Outputs Populated clsEOBNoteCollection of clsEOBNote items scoped to the bill
Primary components clsEOBNoteCollection.GetEOBNotes, clsEOBNoteCollection.BeforeRetrieve
Entry point Business\SAIF.Business.Claim.MedicalBill\clsEOBNoteCollection.vb

Steps

  1. Lazy trigger from the parent bill. Reading clsMedicalBill.EOBNotes retrieves the collection only on first access and only when SuppressAuditDetail is false (BR-MB-020); the result is cached on the bill instance for subsequent reads.
  2. Retrieve EOB notes. clsEOBNoteCollection.GetEOBNotes(dpi, billID) calls PK82396_MEDICAL_BILLS.GetEOBNotes (SQL-007, CBP_EOB_NOTE), which restricts its result set to the requested bill identifier (BR-PROC-003).
  3. Load each note row. Each returned row is loaded into a clsEOBNote and added to the collection.

Process flow

The following diagram visualizes this operation's control flow.

flowchart TD
    Start([Bill.EOBNotes read]) --> Suppress{SuppressAuditDetail?}
    Suppress -->|Yes| Skip([Returns Nothing;<br>no retrieval issued])
    Suppress -->|No| Retrieve[GetEOBNotes via<br>PK82396_MEDICAL_BILLS, scoped to BillID]
    Retrieve --> Load[Load each note row<br>into clsEOBNote]
    Load --> Done([Collection cached<br>on parent bill])

Failure and edge-case behavior

  • The collection is read-only; there is no persist/save path.
  • Retrieval is cached after first load, so subsequent reads within the same bill instance's lifetime do not re-issue the call.
  • Bulk-print suppression (SuppressAuditDetail) silently skips this retrieval for affected bills rather than raising an error.

Sources

  • Business\SAIF.Business.Claim.MedicalBill\clsEOBNoteCollection.vb
  • Business\SAIF.Business.Claim.MedicalBill\clsEOBNote.vb