Earn Code Overview and Enablement

An Earn Code is a unique identifier used to categorize the types of transactions associated with an employee, such as, but not limited to:

  • Rate: Weekend, REG, OT pay
  • Dollars: Bonus, Per Diems, Background Check
  • Units: Quantity of reported transactions

Earn Codes ensure that employees are paid correctly and the customer is billed correctly. They can be entered by the employee, generated automatically, or modified by an administrator.

Create an Earn Code Template for Earn Codes that are frequently used together. Users can select the template when creating a new Rate Card instead of each Earn Code individually.

Earn Codes are setup for your entire Bullhorn instance. They are not limited by Private Label or Department.

Adding Earn Codes is typically a system or billing administrator function. Contact Bullhorn Support to update access.

Earn Code Usage Guidelines

To ensure the connection between Bullhorn ATS to Bullhorn Time & Expense and your Bullhorn to third party Payroll Provider integration function correctly, ensure you follow these guidelines:

  • Do not rename or modify the default Earn Codes. The default Earn Codes are Reg, OT, and DT. These are base codes within Bullhorn ATS and Bullhorn Time & Expense. They should not be renamed or modified. All other Earn Codes are set up based on client requirements.
  • None of the Earn Codes should be coded as “Worked.” This is a reserved word used by Time & Expense and using it improperly will prevent data from flowing from Time & Expense to Bullhorn.

All transactions originating from Bullhorn ATS and Bullhorn Time & Expense must have an Earn Code assigned. This includes the following types of records:

  • Manually entered or system-generated payable and billable transactions.
  • Taxes, surcharges, and discounts on invoices and payable and billable charges.
  • Rate Card line items.

For additional information on the connect between Earn Codes in ATS and Adjustement Codes in BTE, see Earn Code Integration with Bullhorn Time & Expense.

Earn Code Configuration

Entitlements

Menu and Action Entitlements give user types the ability to View, Add, and Edit Earn Codes and Earn Code Templates. Contact Bullhorn Support to update entitlements.

System Settings

In Bullhorn ATS, navigate to Menu > Admin > System Settings to select the default Earn Code group.

  • System Setting: defaultEarnCodeGroup

  • Title: Default Earn Code Group ID for a Rate Card

  • Default Value: 0

Entity Titles

Navigate to Menu > Admin > Entity Titles to change the display of Earn Code related labels.

Field Maps Earn Codes

The Field Maps list the fields available to the Earn Code List and Add/Edit Earn Code page. Navigate to Menu > Admin > Field Mappings > Earn Code to make updates.

View Layout

View Layout controls the columns displayed on the Earn Codes List. Navigate to Menu > Admin > View Layout > Earn Code to update these.