Short answer
A modern 401(k) recordkeeping system is an immutable transaction ledger with participant positions by money source and investment. Balances are derived, never edited; valuation is daily (units and prices) or balance-forward (periodic earnings allocation); and plan totals reconcile to payroll, the trust and the custodian every cycle.
The core data model
Recordkeeping starts with a few entities and their relationships:
- Plan with its provisions, money sources and investment menu, each with effective dates.
- Participant with employment, service and beneficiary data.
- Money source such as pre-tax deferral, Roth deferral, employer match, safe harbor, profit sharing and rollover, each with its own vesting and distribution rules.
- Investment with identifiers and price history.
- Position: participant × source × investment, holding units or dollars.
- Transaction: every event that changes a position.
Getting money sources right is the single most important design decision. Roth and pre-tax money must never mix, employer money vests on its own schedule, and distributions and loans draw from sources in a defined order.
Transactions, not balances
The ledger is append-only. Contributions, trades, fees, loan issues and repayments, distributions, forfeitures and earnings allocations are all transactions with an effective date, a posting date, a source and a reason. A participant’s balance on any date is the sum of transactions up to that date. Corrections are reversing and correcting entries with an approver, not edits. This one rule makes statements, audits and historical restatements possible.
transaction(id, plan_id, participant_id, source, investment,
type, units, amount, price, effective_date,
posted_at, batch_id, reason, approved_by)
Valuation models
| Model | How it works | Typical use |
|---|---|---|
| Daily valuation | Positions held in units; valued daily with fund prices; trades placed and confirmed per cycle | Recordkeepers of participant-directed plans |
| Balance-forward | Positions held in dollars; earnings allocated periodically by a formula | Pooled, trustee-directed plans, often administered by TPAs |
Daily-valued systems need trade aggregation, confirmation import and price history. Balance-forward systems need careful allocation formulas (for example weighted average balance) and period close procedures.
Main processing flows
- Contribution posting: payroll remittance validated, mapped to sources and elections, posted, and matched to the deposit.
- Trading: net orders by fund, trade confirmations imported, units posted at the confirmed price.
- Loans: availability calculated from vested balances, amortization schedule, repayments through payroll, default handling.
- Distributions: vesting applied, forfeitures created, payment instructions recorded for the paying agent.
- Fees: plan and participant fees calculated and deducted with disclosure data kept.
- Statements: generated from the ledger for a period, never from a separate copy.
Reconciliation
Three reconciliations should run every cycle: payroll remittance to posted contributions, ledger totals to the trust or omnibus account, and ledger positions to custodian positions. Differences go to an exception queue with ageing. A system that cannot reconcile on demand will eventually produce a balance nobody can explain.
Controls and audit
- Maker-checker approval on manual adjustments.
- Immutable audit log of who did what, when and why.
- Segregated environments, with synthetic data outside production.
- Access reviews and least-privilege roles.
- Reproducible period closes.
The US Department of Labor’s cybersecurity guidance for plan service providers is a useful checklist for the security side.
Scaling
Recordkeeping load is spiky: payroll days, quarter ends and year-end. Batch posting should be idempotent and resumable, large plans should be processable in parallel by plan, and read models for portals should be separated from the posting path so participant traffic never slows processing. See Building scalable retirement plan processing systems.
References
- US Department of Labor, EBSA: cybersecurity program best practices
- US Department of Labor: Form 5500 series
- IRS: COLA increases for dollar limitations on benefits and contributions
Written by the Software Home engineering team, which builds 401(k) software and the KinetiPlan platform; we have an interest in some of the choices discussed. General information only, not legal, tax or investment advice.