HI,
I lost a few hours last week because Benefits Management kept calculating 0.00 for pension contributions and wrong amounts for life insurance. My mistake was trusting the Microsoft Learn documentation literally.
Sharing the 4 traps I hit so you don't waste an evening on the same fields:
1. Tier rates: Level is an upper bound, not a lower bound :)
The docs say Level "represents the lower bound of the tier." I entered 0.00 to cover all salaries from zero up, and the system returned 0.00 for everyone. In X++, Level is the upper bound ("salary up to X"). For a single catch-all tier, enter 9999999.00. (The example on page 1460 actually contradicts the table on page 1461.)
2. Coverage options: double division by 100
The docs call the fields Percent and Divisor, while the UI calls them Multiplier and Base amount. The engine already divides Multiplier by 100:
Coverage = Salary * (Multiplier / 100) / Base amount
For 4x Salary, setting Multiplier = 400 and Base amount = 100 divides by 100 twice (2,320 instead of 232,000 on a 58,000 salary). Set Base amount to 1.00.
3. Benefit plans: 0.00 is a hard cap of zero
Leaving Maximum coverage (Life) or Maximum annual contribution (Savings) at the default 0.00 does not mean "no limit." It caps the benefit at zero. Set them to 9999999.00, and on Savings plans also fill in Employer match, Employer match percent, and Employer match cap.
4. Rates tables (pages 1459, 1462): copy-paste descriptions :)
All four employee and employer amount fields have the same pasted description saying the employer pays the amount, and the Smoker rows say "for a nonsmoking employee."