Understand a member's buckets¶
As a Membership Staff member, I want to read a member's Buckets tab correctly, so that I can answer whether they owe an initiation fee, have an open step-up charge, or settled a bad check fee — without misquoting a stale or filtered total.
Screen: Members > Buckets
A bucket is an open financial "hold" transaction sitting on a member's record — Initiation Fees, Step-Ups, and Bad Check Fees are the recurring examples — separate from the member's regular Dues payment ledger (Members > Payments).
Most other roles only see this tab, they can't act on it
Per the Roles & Security Matrix, only Super User and Membership Staff have
Add/Update on Buckets (including Add New Bucket) — every other role (Business Agent,
Management, Accounting, Contract, H&W Staff, ETF Staff) is View Only. See
Create and manage a bucket for the write side.
What's on the screen¶
- A Show Open Transactions Only checkbox filters the grid down to buckets that haven't been paid off yet — useful when a member has years of historical buckets and you only care what's still outstanding.
- The grid itself has four columns: Transaction Type (e.g. Initiation Fee, Step Up, Bad Check Fee), Transaction Amount, Open/Paid status, and Transaction Date.
- A Total Amount footer sums the grid.
Reading the Total Amount footer correctly¶
The Total Amount footer sums whatever rows are currently visible in the grid — which means its meaning changes depending on whether Show Open Transactions Only is checked:
- With the filter on, Total Amount is the member's current outstanding bucket balance — the number most people actually want when they ask "does this member owe anything on a bucket."
- With the filter off, Total Amount includes paid-off historical buckets too, so it will be larger and does not represent money currently owed.
Before quoting a bucket total to anyone (a business agent asking if a member can withdraw, an accounting question about an outstanding fee), check which state the filter is in — a number copied from the unfiltered view will overstate what's actually still open.
Things to watch out for¶
Step-up/bucket calculations need a realistic test member
Step Up and bucket amounts depend on the member having a realistic work history and a settled balance. Two separately reported "wrong amount" cases both turned out to be artifacts of an unrealistic test scenario (a terminated member with no current work record, and a member without a settled balance yet) rather than calculation bugs — re-testing with a realistic member and a settled balance produced the correct amount both times. (IUOE-1904, IUOE-2057)
Bucket payment allocation is only confirmed reliable for one scenario
Whether a bucket payment's Amount Paid correctly matches Amount Applied has only been confirmed working for a full walk-in payment against an adjusted bucket. Phone payment, employer payment, and unadjusted-bucket scenarios have shown apparent mismatches in testing and aren't confirmed reliable — don't assume a clean bucket-payment number generalizes across payment channels. This is covered in more depth in Reconcile an invoice discrepancy report. (IUOE-2705)
COBRA uses buckets too, but differently
H&W Staff manages a separate, auto-generated flavor of bucket for COBRA premium billing — see Manage COBRA buckets if a member you're looking at has COBRA coverage and their bucket history looks unusual (e.g. requiring full payment with no partial-payment option).