BeyondERP.Newsletter
Menu

Setup page · Human resources

Benefits

A list and details page where you keep the benefits your organisation offers, each one a combination of a benefit plan and a coverage option that workers can enrol in.

Used by
Compensation and benefits manager, Human resource assistant, Human resource manager and 3 more roles
Business process
Develop people strategy
Menu item
HcmBenefitList
Main table
HcmBenefit
Data entity
HcmBenefitEntity
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA list and details page where you keep the benefits your organisation offers, each one a combination of a benefit plan and a coverage option that workers can enrol in.
What you do hereUse this page to create benefits from benefit plans and options, set the dates they are available, and decide how eligibility is determined, for example by assigning an eligibility rule type.
ExampleFor example, BEAT creates the benefit Medical PPO with the option Employee only, effective 1 January 2027, with Eligibility set to Rule based and the rule type Full-time; an open enrollment event for 120 employees finds the 95 full-time employees eligible, and only they can be enrolled.
Benefits page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Set up Benefits

Use this page to create benefits from benefit plans and options, set the dates they are available, and decide how eligibility is determined, for example by assigning an eligibility rule type.

Steps from Microsoft

  1. Go to Human resources > Benefits > Benefits.
  2. Find and select the benefit you want, and open it.
  3. Expand the Eligibility rules section.
  4. Select Edit.
  5. In the Eligibility field, select the eligibility method.
  6. In the Rule type field, select the rule type you created earlier.
  7. Select Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
Type / Plan / OptionTogether these identify the benefit: the benefit type, the provider's plan, and the coverage option.Microsoft Learn Medical / Medical PPO / Employee only
Effective / ExpirationThe date range when the benefit is available to workers.Microsoft Learn 1/1/2027 to Never
EligibilityHow eligible workers are found: all workers, rule based, or bypassing the eligibility process.Microsoft Learn Rule based
Rule typeThe eligibility rule type assigned to the benefit when eligibility is rule based.Microsoft Learn Full-time
Eligibility overridesWorkers listed here are eligible for the benefit regardless of the usual eligibility criteria.Microsoft Learn Julia Funderburk, 1/1/2027 to 12/31/2027

Common errors and fixes

MessageWhat to do
A worker can't be enrolled in the benefitWith Rule based or All workers are eligible, the worker must be in a processed eligibility event first. Process an event that includes the worker, or add an eligibility override whose dates cover the coverage start date. Microsoft Learn
Nothing is deducted or contributed for the benefit, and the Payroll FastTab is missingThe plan's Payroll impact is None. Set Payroll impact on the plan on Benefit elements to what the plan really does, then fill the Payroll FastTab of the benefit. Microsoft Learn
The page opens read-only and Edit isn't availableBenefits management is turned on, which makes the legacy Benefits pages read-only. It can be turned off only in a Sandbox environment; in Production keep working in the Benefits management workspace. Microsoft Learn

Test checklist

  1. Create a benefit from a plan and option with Effective and Expiration dates.
  2. Set Eligibility to Rule based and select a Rule type.
  3. Create an eligibility event from the benefit, add workers, and select Process.
  4. Select Show results and check eligible and ineligible workers match the rule.
  5. Enroll an eligible worker and check the Payroll values default from the benefit on the worker's benefit.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up BenefitsRule based eligibility for most benefits; All workers are eligible only for benefits everyone gets (for example parking); Bypass eligibility process only for garnishments and tax levies.Learn says Rule based is the method used for most benefits. All workers are eligible still limits enrollment to processed eligibility events, while Bypass eligibility process lets anyone be enrolled at any time.Keep benefits on the Benefits pages, or move to the Benefits management feature?Using Bypass eligibility process for ordinary benefits: the benefit is left out of eligibility processing and any worker can be enrolled at any time, so open enrollment controls don't apply.Test: Rule based eligibility limits enrollment

Feature management and licence

Feature to turn onBenefits management (Must be off)
Licence or add-inThis page is part of the legacy Benefits workspace. Turning on Benefits management in Feature management makes it read-only, and in a Production environment Benefits management can't be turned off again; Microsoft recommends enabling and testing it in a Sandbox first. Benefits are kept by the Compensation and benefits manager and the Payroll administrator; HR managers and assistants, recruiters and payroll managers read them.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared: benefits are not per company. Data management lists the Benefit entity as shared, so every legal entity uses the same benefits; payroll accounting is set per legal entity on the plan. Checked in Dynamics 365
Can it be undoneHard to reverse: Benefit records can be edited, but expiring a benefit also changes enrolled workers' coverage end dates. Separately, turning on Benefits management makes this page read-only, and in Production that can't be undone. Microsoft Learn
If you change it laterThe Payroll FastTab values of a benefit are the defaults copied to each worker's Maintain benefits page at enrollment, and the eligibility method decides who can enroll: Bypass eligibility process lets any worker be enrolled at any time, while All workers are eligible and Rule based need a processed eligibility event first. Microsoft Learn
Technical architect

6Technical

Menu itemHcmBenefitList Checked in Dynamics 365
FormHcmBenefit Checked in Dynamics 365
TableHcmBenefitShown as “BENEFIT” in Record infoKey field: BenefitIdChecked in Dynamics 365
Data entitiesHcmBenefitEntityBenefit Checked in Dynamics 365
Who can open itPrivilegesMaintain benefits HcmBenefitInquiryMaintainView a list of benefits HcmBenefitInquiryViewAccess benefits workspace HcmBenefitWorkspaceDutiesInquire into benefits process HcmBenefitInquireEnable benefits process HcmBenefitProcessEnableAccess benefits workspace HcmBenefitWorkspaceMaintain worker master HcmWorkerMaintainInquire into payroll master data PayrollMasterDataInquireSet up payroll master data PayrollMasterDataMaintainInquire into payroll position and worker setup PayrollPositionWorkerSetupInquireSet up payroll positions and workers PayrollPositionWorkerSetupMaintain
6 security rolesCompensation and benefits manager HcmCompensationAndBenefitsManagerHuman resource assistant HcmHumanResourceAssistantHuman resource manager HcmHumanResourceManagerPayroll administrator HcmPayrollAdministratorPayroll manager HcmPayrollManagerRecruiter HcmRecruiter
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itCompensation and benefits manager HcmCompensationAndBenefitsManagerPayroll administrator HcmPayrollAdministratorTo use itHuman resource manager HcmHumanResourceManagerHuman resource assistant HcmHumanResourceAssistantRecruiter HcmRecruiterPayroll manager HcmPayrollManagerGive people one of these roles. On this system, 6 roles can open this page.Checked in Dynamics 365
Actions on the pageBenefit(Action Pane without tabs): New, Delete, Maintain versions, Enrolled workers, Benefit elements, As of dateChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=HcmBenefitList
Integrate withHcmBenefitEntity data entity Checked in Dynamics 365
Data migrationHcmBenefitEntity Benefit: the plan and option combinations workers enroll in. Shared by all companies.Load order: Benefit types, plans, options and benefits aren't in a default Data management template (the Legacy benefits template starts with eligibility). Build a data project that loads Benefit type, Benefit plan and Benefit option before Benefit, then load the Legacy benefits template for eligibility events and coverage groups.Load first: HcmBenefitTypeEntity, HcmBenefitPlanEntity, HcmBenefitOptionEntityMicrosoft Learn
Everyone

8Sources