BeyondERP.Newsletter
Menu

Setup step on the Disposable income definition page · Payroll

Set up Disposable income definition

Use this page to create a definition for each state whose formula differs from the federal one, so garnishments are limited correctly; the federal formula is already built in.

Used by
Compensation and benefits manager, Payroll administrator, Payroll manager
Business process
Manage compensation and benefits
Menu item
PayrollDisposableIncome
Main table
PayrollDisposableIncome
Data entity
PayrollDisposableIncomeEntity
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 isA setup page where you define state-specific disposable income definitions that list extra earnings and benefit deductions to exclude when calculating a worker's disposable income for garnishments.
What you do hereUse this page to create a definition for each state whose formula differs from the federal one, so garnishments are limited correctly; the federal formula is already built in.
ExampleFor example, a definition for Texas garnishments is named starting with TX.
Disposable income definition 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 Disposable income definition

Use this page to create a definition for each state whose formula differs from the federal one, so garnishments are limited correctly; the federal formula is already built in.

Steps from Microsoft

  1. Go to Payroll > Setup > Benefits > Disposable income definition.
  2. Select New and enter a name (starting with the state abbreviation) and description.
  3. In the Reduce total wages by the following earnings grid, select Add and choose exempt earning codes.
  4. In the Reduce disposable income by deductions for the following benefits grid, select Add and choose exempt benefits.
  5. Save the definition.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
Reduce total wages by the following earningsEarning codes the state treats as exempt, which are left out of total wages.Microsoft Learn
Reduce disposable income by deductions for the following benefitsBenefits (including other garnishments or tax levies) whose deductions reduce disposable income.Microsoft Learn

Test checklist

  1. Create a definition for one state with the exempt earning codes and benefits from legal.
  2. Enroll a test worker in a garnishment that uses the definition.
  3. Generate a pay statement and check the garnishment is limited using the reduced disposable income.
  4. Check that taxes were subtracted without being listed in the definition.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Disposable income definitionOne definition per state that differs from the federal formula, named with the two-letter state code first (for example TX...), contents set by legal advisors and reviewed yearlyThe federal formula is built in; state definitions change yearly and are hard to map to earning codes and benefits, so Learn recommends legal advisors decide and review them.Editing a definition that is in use: definitions are not date-effective, so the change applies immediately to all garnishments that use it.
Solution architect

5Design impact

Can it be undoneHard to reverse: No date-effective versions: a change applies at once. Deleting an earning code or benefit removes it from every definition, and new codes are never added automatically.
If you change it laterDefinitions are not date-effective, so any change applies at once; Microsoft advises not changing definitions in use. Deleting an earning code or benefit removes it from all definitions. Microsoft Learn
Technical architect

6Technical

Menu itemPayrollDisposableIncome Checked in Dynamics 365
FormPayrollDisposableIncome Checked in Dynamics 365
TablePayrollDisposableIncomeShown as “DISPOSABLE INCOME DEFINITION” in Record infoKey field: NameChecked in Dynamics 365
Data entitiesPayrollDisposableIncomeEntityDisposable income definition Microsoft data model
Who can open itPrivilegesMaintain disposable income definition PayrollDisposableIncomeMaintainView disposable income definition PayrollDisposableIncomeViewDutiesInquire into payroll master data PayrollMasterDataInquireSet up payroll master data PayrollMasterDataMaintain
3 security rolesCompensation and benefits manager HcmCompensationAndBenefitsManagerPayroll administrator HcmPayrollAdministratorPayroll manager HcmPayrollManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itPayroll administrator HcmPayrollAdministratorCompensation and benefits manager HcmCompensationAndBenefitsManagerTo use itPayroll manager HcmPayrollManagerGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=PayrollDisposableIncome
Integrate withPayrollDisposableIncomeEntity data entity Microsoft data model
Data migrationPayrollDisposableIncomeEntity (Disposable income definition): shared by all companies.Microsoft Learn
Everyone

8Sources

To cite this step: PAY-SETUP-140, Set up Disposable income definition. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/PAY-SETUP-140