Configure Payroll Upload Settings and Prepare Payroll Data for Upload

Overview

This article explains how to configure Payroll Upload Settings in eComply and prepare payroll files for upload into a Certified Payroll Report (CPR). This process allows users to import employee payroll information using a structured file instead of entering data manually.

Steps

Configuring Payroll Upload Settings

Before uploading payroll data, you must first configure your organization’s payroll upload format.

  1. Navigate to Settings.
  2. Scroll to Payroll Upload Settings.
  3. From the Basic Settings tab, locate the Accounting Profile field. It will likely show as Unassigned if this is your first time setting up a template.
  4. Select the dropdown menu to review the supported payroll systems.
  5. Select the payroll system you use.

    If your payroll system is not listed, you have the following options:

    1. Check to see if your payroll software can export the data into one of the supported payroll software formats.
    2. Select LCM CSV, which is a template where you can populate your data and upload it to the system. 
    3. Choose to manually enter your data when creating a CPR. Once you have created a CPR, you can copy it to a new one and change the wage and hours being reported for the next reporting period.
  6. Select Submit to save your selection.

Preparing the Payroll File

After configuring the Payroll Upload Settings, you will need to review the file you plan to upload into the system.

Using a payroll system export file

  1. Export your file in the applicable format from your payroll system. 
  2. Verify the following fields:
    • Payroll Number & Week Ending Date: These must be precise to avoid system errors. 
    • Employee Identity: Ensure the first name, last name, and SSN are correct so the system can match the record to the specific employee. 
    • Trade: The craft category for the employee. 
    • Classification: Worker level, such as Apprentice or Journeyman.
    • Rate: The hourly rate for the employee.
    • Hours: The hours worked by the employee.
  3. Save the completed file to your computer.

Using the LCM CSV Template

  1. From the left Navigation pane, select Settings > Payroll Upload Settings.
  2. On the Basic Settings tab, locate Template, and download the LCM CSV file. 

    Note: On first use, select Submit to reveal the template and then select the linked .csv file to download it.

  3. Complete all required fields for each employee. See the Required Fields table below.
  4. Complete any additional fields that apply to the employee’s payroll. Some information needed to submit a CPR may not be noted as required because the required value depends on the payroll data. For example, you must report hours worked, but the type of hours—such as regular time or overtime—may vary.  See the Additional Fields table below.
  5. Save the completed file using a name that identifies the project and week-ending date.

Required fields

Field Definition
weekEndDate CPR Week Ending Date. Must be a valid date in mm/dd/yyyy format and cannot be 0.
firstName Employee's first name.
lastName Employee's last name.
ssn Social Security Number in ###-##-#### format. Cannot contain X. To show the last 4 digits, use this format: 000-00-1234.
exemption Exemption value. Valid options are 0–99.
ethnicity Ethnicity code. 1 = Caucasian; 2 = African American; 3 = Hispanic; 4 = Native American or Alaskan; 5 = Asian or Pacific Islander; 6 = Other;  7 = Asian Indian. Must use the applicable code.
address Employee's address.
city Employee's city.
state Employee's state. Must use the state abbreviation.
zip ZIP or postal code. Accepted examples: 12345, 12345-1234, L6J 5E4, or L6J5E4. If the first digit is 0, enter an apostrophe before the ZIP code. For example, '01234.
country Employee's country.
fica FICA amount, including Social Security and Medicare combined.
fedWH Federal income tax withheld.
stWH State income tax withheld.
grossPayAllProjects Employee's gross pay for all projects. 
netPay Employee's net pay.
classification Employee's classification. Can be mapped to a matching classification in the system.
trade Employee's trade. Journeymen or Apprentice
grossPayThisProject Employee's gross pay for this project. 
rtRate Regular Time hourly rate. This field is required but can be 0 when there are no Regular Time hours. 
SDI State Disability Insurance. If not applicable, enter 0.
Etax KCMO earnings tax. Required for KCMO only. If the project is not KCMO, enter 0

Additional fields

Employee and Payroll Information

Field Definition
payRollNumber Payroll number.
assignedEmpID Employee ID.
titleCourtesy Employee courtesy title.
middleInitial Employee's middle initial.
suffix Employee's name suffix.
title Employee's craft, for example, Electrician.
birthdate Employee's birth date in mm/dd/yyyy format.
gender Employee's gender. M = Male; F = Female.
contactNo Employee's contact phone number. Example: (111)123-4567. With an extension: (111)123-4567-890.
maritalStatus Marital status. S = Single; M = Married.
officeNo Employee's office phone number. Example: (111)123-4567. With an extension: (111)123-4567-890.
unionName Union name.
hireDate Employee's hire date in mm/dd/yyyy format.
federalID Federal ID number.
alienNo Alien number.
apprenticeshipNo Apprenticeship number.
checkNumber Check number.

 Other Deductions

Field Definition
otherDeduction1 Description of other deduction 1.
value1 Amount of other deduction 1.
otherDeduction2 Description of other deduction 2.
value2 Amount of other deduction 2.
otherDeduction3 Description of other deduction 3.
value3 Amount of other deduction 3.
otherDeduction4 Description of other deduction 4.
value4 Amount of other deduction 4.
otherDeduction5 Description of other deduction 5.
value5 Amount of other deduction 5.

 The accepted Other Deduction descriptions are: 

  • Child Support
  • Company Finance Retirement Plan / Pension
  • Deferred Compensation Plan / 401K
  • Dental Insurance
  • Disability Insurance
  • Employee Savings Plan
  • Garnishment
  • Health Insurance
  • Life Insurance
  • Miscellaneous
  • Section 125 Cafeteria
  • Supplemental Dues
  • Union Vacation Fund
  • Vision Insurance

 Other Project Hours and Benefits

Field Definition
otherProjectsRTHrs Regular Time hours worked on other projects.
otherProjectsOTHrs Overtime hours worked on other projects.
benefitsPaidToUnion Indicates whether benefits were paid to the union. Y = Yes; N = No.
benefitsPaidToEmployee Indicates whether benefits were paid directly to the employee, including cash in lieu of benefits. Y = Yes; N = No.
benefitsPaidToOther Indicates whether benefits were paid to another recipient. Y = Yes; N = No.
benefitsPaidTo1 Name of the union receiving benefits.
benefitsPaidTo2 Name of the employee receiving benefits.
benefitsPaidTo3 Name of the other recipient receiving benefits.
isFridayMakeUpDay Indicates whether Friday is a make-up day. Y = Yes; N = No.
isSaturdayMakeUpDay Indicates whether Saturday is a make-up day. Y = Yes; N = No.
isSundayMakeUpDay Indicates whether Sunday is a make-up day. Y = Yes; N = No.

 Regular Time

Field Definition
rt1 Regular Time hours for the 1st day of the pay period.
rt2 Regular Time hours for the 2nd day of the pay period.
rt3 Regular Time hours for the 3rd day of the pay period.
rt4 Regular Time hours for the 4th day of the pay period.
rt5 Regular Time hours for the 5th day of the pay period.
rt6 Regular Time hours for the 6th day of the pay period.
rt7 Regular Time hours for the 7th day of the pay period.
rtBenefit Regular Time supplemental benefit rate.

Swing Time

Field Definition
st1 Swing Time hours for the 1st day of the pay period.
st2 Swing Time hours for the 2nd day of the pay period.
st3 Swing Time hours for the 3rd day of the pay period.
st4 Swing Time hours for the 4th day of the pay period.
st5 Swing Time hours for the 5th day of the pay period.
st6 Swing Time hours for the 6th day of the pay period.
st7 Swing Time hours for the 7th day of the pay period.
stRate Swing Time hourly rate.
stBenefit Swing Time supplemental benefit rate.

Overtime

Field Definition
ot1 Overtime hours for the 1st day of the pay period.
ot2 Overtime hours for the 2nd day of the pay period.
ot3 Overtime hours for the 3rd day of the pay period.
ot4 Overtime hours for the 4th day of the pay period.
ot5 Overtime hours for the 5th day of the pay period.
ot6 Overtime hours for the 6th day of the pay period.
ot7 Overtime hours for the 7th day of the pay period.
otRate Overtime hourly rate.
otBenefit Overtime supplemental benefit rate.

Graveyard Time

Field Definition
gt1 Graveyard Time hours for the 1st day of the pay period.
gt2 Graveyard Time hours for the 2nd day of the pay period.
gt3 Graveyard Time hours for the 3rd day of the pay period.
gt4 Graveyard Time hours for the 4th day of the pay period.
gt5 Graveyard Time hours for the 5th day of the pay period.
gt6 Graveyard Time hours for the 6th day of the pay period.
gt7 Graveyard Time hours for the 7th day of the pay period.
gtRate Graveyard Time hourly rate.
gtBenefit Graveyard Time supplemental benefit rate.


Note:

  1. Numbers must be in numeric format. It should exclude dollar ($) and comma (,) symbols. 
  2. If possible, total tax and other deductions should be broken down to FICA, Fed Withholding, State Withholding.

Uploading the CPR Data

The next step is to create a new CPR and import the payroll data file. You may also need to perform payroll import mapping. For more information, see Upload CPR Data and Perform Payroll Import Mapping.

Summary

You can streamline CPR creation by configuring your payroll upload format and preparing employee payroll data from a supported payroll system or the LCM CSV template. Reviewing required employee, payroll, and classification information before uploading helps ensure the data can be matched and processed correctly in eComply. 

If you require additional assistance, select Submit a Request to create a support ticket.

 

Related to