Add a new HRA record for a member¶
As an H&W Staff member, I want to add a new transaction to a member's HRA History ledger, so that a contribution, distribution, interest credit, or forfeiture is reflected in their running HRA balance.
Screen: Members > (open a member record) > HRA History tab > Add HRA Record.
HRA History is one of the fund-gated tabs — H&W Staff is the only non-Super-User role that sees it at all, and the only one with the "Add New HRA Record" action (Add/Update) on it.
What's on this tab¶
Key fields/columns: Contribution Date, Date Posted, Transaction Amount, Transaction Type (Contribution, Interest), Employer/Jobsite, Invoice Number, Transaction Date, Running HRA Balance, Transaction Note, Forfeited.
Actions available: Add HRA Record, Print HRA History.

The Running HRA Balance column increments/decrements across rows as each transaction posts — a new record you add should change every subsequent row's running balance, not just add an isolated line.
Things to watch out for¶
HRA ledger entries aren't simple single-sided transactions
A distribution, an interest credit, and a forfeiture each have a distinct expected shape — historical distribution migration was found double-counting both sides of a transaction (the fix retains only the "distribution" record, not a paired debit/credit), the annual interest transaction type itself needed correcting, and the forfeiture-amount rule needed a concrete worked example from IUOE to pin down. Don't assume a new transaction type you haven't seen before should mirror the shape of a Contribution row. (IUOE-2184)
A missing transaction can be a migration-seeding gap, not a data-entry miss
If a member's HRA History is missing a transaction you'd expect to see, a possible cause on this project is a migration-seeding gap rather than something never entered — check the member's broader BenefitsHistory/jobsite-identity picture (see Look up a member's benefits and dependent history's duplicate-jobsite-number note) before assuming the record simply needs to be added fresh. (IUOE-2564 — Phase 1 stub)
The HRA History tab has an Invoice # column the printed report didn't automatically get
The tab/grid and its corresponding printed report are two separate deliverables in Prizm's architecture — adding the Invoice # column to the on-screen HRA History tab (Release 2.19) did not automatically add it to the printed report; that required a separate follow-up ticket. If something is visible on this tab but missing from its printout, that's an expected class of gap here, not a sign the tab fix didn't really ship. (IUOE-2565)
Verify the entry against the HRA Annual Interest report, not just the tab
After adding a record, you can cross-check that it landed correctly by running the HRA Annual Interest report for an as-of date on or after the transaction's contribution period and comparing balances — see Run the HRA Annual Interest report and reconcile a member's balance. Remember the report includes by contribution period, not post date, so a just-added record with an early contribution period can already show up in a report run for an earlier as-of date than you might expect.