BeyondERP.Newsletter
Menu

Setup page · Payroll

Disposable income definition

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

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

Business processManage compensation and benefits
Menu pathPayroll › Setup › Benefits › Disposable income definition
Set up firstEarning codes Microsoft Learn Benefits Microsoft Learn
Used next byBenefit elements (garnishments and tax levies) Microsoft Learn
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: Changes take effect immediately with no history, so Microsoft advises not changing definitions in use; create a new one instead. Garnishments and tax levies are excluded only if you add them as benefits. Microsoft Learn
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

KEEP EXPLORING

More in Payroll.

Open the other pages and setup steps in this module, or go back to the Atlas Hub to search every page.