Configure earn codes in WFM admin portal

You can configure earn codes and their mappings in WFM admin portal so you can view how earn codes correspond to time codes and hour types, while also reducing the complexity of payroll export XML mappings.

To access the earn code maintenance form, in WFM admin portal, select Maintenance > Payroll Settings > Earn Code. You can use the Earn Code maintenance form to create and maintain earn codes and mappings that are used in payroll export and timesheet processing.

This table shows the fields in the earn code maintenance form:

Filed name Type Required Notes
Earn Code String Yes This value must be unique.
Description String No
Start Date Date Yes

Defines when the earn code becomes effective

Use this field to control when the earn code can be used and to avoid unnecessary retro calculations.

End Date Date Yes

Defines when the earn code stops being effective

Use this field instead of creating multiple rows for the same earn code.

Priority Number Yes
  • 1 indicates the highest priority.
  • This value is used when earn code mappings could resolve into multiple earn codes for the same work detail or work premium record.
Time Code String No The time code that this mapping applies to. If blank, the mapping can apply to any time code that matches the other criteria.
Hour Type String No The hour type that this mapping applies to. If blank, the mapping can apply to any hour type that matches the other criteria.
Pay Rule String No The pay rule that this mapping applies to. Use this to define mappings that are specific to a group of employees.
Job / Job Group String No The job or job group that this mapping applies to. Use this field to map specific jobs to different earn codes.
Labor Metric 1–N String No Optional labor metric fields that further restrict when the mapping is used. These fields are available only when the corresponding labor metrics are configured.
Include in Export Boolean Yes Indicates whether time records that match this mapping are included in payroll export processing.
Notes String No Optional notes about a specific mapping.
Note: 

Earn codes are typically created as a single row per code. To inactivate an earn code, you can change the effective dates instead of creating duplicate earn code records.