BeyondERP.Newsletter
Menu

Setup page · Payroll

Earning codes

A setup page where you create earning codes, which uniquely identify each type of earning workers receive and carry its accounting, tax, reporting and gross-up settings.

Used by
Compensation and benefits manager, Payroll administrator, Payroll manager
Business process
Manage compensation and benefits
Menu item
PayrollEarningCode
Main table
PayrollEarningCode
Data entity
PayrollEarningCodeEntity
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 create earning codes, which uniquely identify each type of earning workers receive and carry its accounting, tax, reporting and gross-up settings.
What you do hereUse this page to create an earning code for every type of earning, such as hourly pay by shift, salary, premiums, leave, benefit accruals and retroactive pay.
ExampleFor example, a double-time earning code uses rate basis Hourly with a multiplier of 2.
Earning codes 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 Earning codes

Use this page to create an earning code for every type of earning, such as hourly pay by shift, salary, premiums, leave, benefit accruals and retroactive pay.

Steps from Microsoft

  1. Go to Payroll > Setup > Earnings > Earning codes.
  2. Select New and enter the earning code, unit of measure and description.
  3. Select the payment run type and whether the code is productive or a base earnings component.
  4. On the General tab, set the rate basis, amount or multiplier and tax method.
  5. On the Accounting tab, select the legal entity and set dimensions and posting rules.
  6. On the Reporting tab, set the Form W-2 control data.
  7. Optionally add the code to earning code groups.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Unit of measureHow the work is measured: Hours, Pieces or Each.Microsoft Learn QuantityUnit
ProductiveMarks the code as used for productive (worked) hours, which affects benefit and tax calculations such as the FLSA regular-rate premium.Microsoft Learn IsProductive
Include in payment run typeThe payment run types (Primary, Additional, Primary and additional, Gross up, Automatic) that process this code.Microsoft Learn IncludeInPaymentType
Base earnings componentIncludes the earnings in worker base pay, which drives salaried earnings and pay-based benefits.Microsoft Learn IsBaseEarningsComponent
Rate basisWith Amount or multiplier, determines how the earnings amount is calculated, for example Flat amount or Hourly.Microsoft Learn RateBasis
Amount or multiplierThe multiplier used to calculate earnings, or a currency amount when the rate basis is a flat amount.Microsoft Learn DefaultFormula
Tax methodThe withholding rate used for the code: Regular, Supplemental or Exempt.Microsoft Learn TaxMethod
Posting rulesThe accounting rules applied when earnings for this code are posted, set per legal entity on the Accounting tab.Microsoft Learn

Test checklist

  1. Create an hourly code with Rate basis Hourly and multiplier 2 and check a worker with a 35.00 hourly equivalent gets 70.00 per hour.
  2. Set the Accounting tab for the legal entity and check the main account on a generated earning line.
  3. Generate a pay statement with a Primary run type and check codes of type Additional are left off.
  4. Check the Form W-2 box on the Reporting tab for codes that must be reported.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Earning codesInclude in payment run type = Primary and additional for regular pay codes; one earning code per type of earning (per shift, per salary plan, per leave type, per accrual plan, plus a matching retro code)A Primary code can be used in only one payment run per pay period, which blocks a same-period correction run; Primary and additional can be used more than once.Which payment run type should regular earning codes use?Adding or changing an earning code later without updating every place it is used (earning code groups, benefit accrual plans, disposable income definitions, benefit earning basis), so calculations silently leave it out.Test: Payment run type controls inclusion
Solution architect

5Design impact

Can it be undoneHard to reverse: Fields can be edited, but the code is shared by all legal entities and referenced by groups, plans, definitions and worker assignments, so every change must be checked everywhere it is used. Deleting a code also removes it from all disposable income definitions. Microsoft Learn
If you change it laterEarning codes are used across many Payroll setups, so creating or changing one means checking and updating every place it should be used. Microsoft Learn
Technical architect

6Technical

Menu itemPayrollEarningCode Checked in Dynamics 365
FormPayrollEarningCode Checked in Dynamics 365
TablePayrollEarningCodeShown as “EARNING CODE” in Record infoKey field: EarningCodeChecked in Dynamics 365
Data entitiesPayrollEarningCodeEntityEarning code Microsoft data model
Who can open itPrivilegesMaintain earning codes PayrollEarningCodeMaintainView earning codes PayrollEarningCodeViewDutiesInquire 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
Actions on the page(Action Pane without tabs): Maintain versions, As of dateChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=PayrollEarningCode
Integrate withPayrollEarningCodeEntity data entity Microsoft data model
Data migrationPayrollEarningCodeEntity (Earning code): 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.