Compensation and benefits manager, Human resource assistant, Human resource manager and 3 more roles
Business process
Develop people strategy
Menu item
HcmBenefitElementSetup
Main table
HcmBenefitType
Data entity
HcmBenefitTypeEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone
1What it is and why
What it is
A setup page where you define the elements that make up a benefit: benefit types, benefit plans and coverage options.
What you do here
Use this page to set up the types, plans and options, with their default settings, before you create benefits and enrol workers in them.
Example
For example, BEAT creates the type Medical with One enrollment per type, the plans Medical PPO and Medical HMO with Payroll impact Deduction and contribution, and the options Employee only and Employee and spouse; this gives 4 benefits, and a worker can be in only one Medical plan for the same period.
The page in Dynamics 365. page title tab to open what to set or check
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 Benefit elements
Use this page to set up the types, plans and options, with their default settings, before you create benefits and enrol workers in them.
Steps from Microsoft
Go to Human resources > Benefits > Setup > Benefit elements.
In the Types area, select New and enter the type name, description and concurrent enrollment setting.
In the Plans area, select New and enter the plan name, description and benefit type.
In the Options area, select New and enter the option name and description.
Select Allow dependent coverage or Allow beneficiary designations if they apply to the option.
Whether the option is available to beneficiaries.Microsoft Learn
No
Common errors and fixes
Message
What to do
A worker can't be enrolled in a second plan of the same type
The type has Concurrent enrollment One enrollment per type, which stops overlapping plans of the type. Use Multiple enrollments per type only where workers may hold several plans, such as term life. Microsoft Learn
Retirement plan fields aren't available on the plan
They show only when the type's payroll category is Retirement. Set the payroll category on the type before creating the plan. Microsoft Learn
The page opens read-only and Edit isn't available
Benefits 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
Create a benefit type with One enrollment per type and a payroll category.
Create a plan of that type with Payroll impact Deduction and contribution, a pretax basis and accounting for the legal entity.
Create two benefits from two plans of the type and enroll a worker in the first.
Try to enroll the same worker in the second for the same period and check it is refused.
Concurrent enrollment One enrollment per type for health-type benefits; Multiple enrollments per type only where a worker may hold several plans (for example term life, worker's compensation). Payroll impact set to what the plan really does; a preset pretax basis rather than Custom.One enrollment per type stops a worker being enrolled in two health plans for the same period. Learn sets worker's compensation types to Multiple enrollments per type, and says to select Custom pretax only when no preset pattern fits.
This 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.
Shared: benefit types, plans and options are not per company. Data management lists the Benefit type, Benefit plan and Benefit option entities as shared; the plan's accounting is entered per legal entity. Checked in Dynamics 365
Can it be undone
Hard to reverse: Plan values such as deduction priority are copied to the worker's benefit at enrollment. Changing the default later doesn't change existing enrollments; each must be changed individually.
If you change it later
The payroll category of the type decides which settings the plan offers, and plan values such as deduction priority are copied to each worker's benefit at enrollment: changing the default later doesn't change existing enrollments, which must be changed one by one. Microsoft Learn
Technical architect
6Technical
Menu item
HcmBenefitElementSetupChecked in Dynamics 365
Form
HcmBenefitElementSetupChecked in Dynamics 365
Table
HcmBenefitTypeShown as “BENEFIT TYPE” in Record infoKey field: BenefitTypeIdChecked in Dynamics 365
Data entities
HcmBenefitOptionEntityBenefit option (The Options area.) Checked in Dynamics 365HcmBenefitPlanEntityBenefit plan (The Plans area.) Checked in Dynamics 365HcmBenefitTypeEntityBenefit type Checked in Dynamics 365
Who can open it
PrivilegesMaintain benefit setup HcmBenefitElementSetupMaintainView benefit setup HcmBenefitElementSetupViewDutiesInquire into benefits process HcmBenefitInquireEnable benefits process HcmBenefitProcessEnableMaintain worker master HcmWorkerMaintainInquire into payroll master data PayrollMasterDataInquireSet up payroll master data PayrollMasterDataMaintainSet up payroll positions and workers PayrollPositionWorkerSetupMaintain6 security rolesCompensation and benefits manager HcmCompensationAndBenefitsManagerHuman resource assistant HcmHumanResourceAssistantHuman resource manager HcmHumanResourceManagerPayroll administrator HcmPayrollAdministratorPayroll manager HcmPayrollManagerRecruiter HcmRecruiterChecked in Dynamics 365
Roles to set it up and use it
To 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
HcmBenefitTypeEntity data entity Checked in Dynamics 365
Data migration
HcmBenefitTypeEntity Benefit type. Shared by all companies.HcmBenefitPlanEntity Benefit plan.HcmBenefitOptionEntity Benefit option.Load order: Not in a default template. Load Benefit type, then Benefit plan, then Benefit option, before the benefits are created.Microsoft Learn