web
You’re offline. This is a read only version of the page.
close
Skip to main content

Announcements

No record found.

News and Announcements icon
Community site session details

Community site session details

Session Id :
Finance | Project Operations, Human Resources, ...
Active Discussion

4 traps in D365 HR Benefits Management documentation

(0) ShareShare
ReportReport
Posted on by 6

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."

 

  • André Arnaud de Calavon Profile Picture
    308,288 Super User 2026 Season 2 on at

    Hi,

    Thanks for sharing. I do assume you wanted to post this here for learning purposes and you don't have an actual (follow-up) question?

  • Pawel Loniewski Profile Picture
    6 on at

    @André Arnaud de Cal... Yeah. I just registered here, and I wrote that so others would know how these fields actually work.

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Season of Sharing Community Challenge Winners!

Congratulations to our community stars!

Women in Power Builds Momentum

Expanding mentorship, skilling, and AI innovation

Leaderboard > Finance | Project Operations, Human Resources, AX, GP, SL

#1
André Arnaud de Calavon Profile Picture

André Arnaud de Cal... 245 Super User 2026 Season 2

#2
Aayush Tiwari Profile Picture

Aayush Tiwari 227

#3
Subra Profile Picture

Subra 184 Super User 2026 Season 2

Last 30 days Overall leaderboard

Product updates

Dynamics 365 release plans