BeyondERP.Newsletter
Menu

Setup step on the Earning codes page · Payroll

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.

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
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 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: Codes are shared across legal entities and used by many Payroll setups. Gross up, Automatic and Retroactive codes lock tax method, rate basis and unit fields to fixed values. The main account from posting rules can't be changed on earning lines.
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

To cite this step: PAY-SETUP-050, Set up Earning codes. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/PAY-SETUP-050