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.
- Navigate to Setup
- Scroll to Payroll Upload Settings.
- 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.
- Select the dropdown menu to review the supported payroll systems.
-
Select the payroll system you use.
If your payroll system is not listed, you have the following options:
- Check to see if your payroll software (LCP Tracker, ADP, QuickBooks 2014, etc.) can export the data into one of the supported payroll software formats. If it is available you will simply download the export from your accounting software and directly upload the file into the CPR. There will not be a downable file provided.
- Select eComply CPR CSV Template or Legacy eComply CPR CSV Template, which is a template where you can populate your data and upload it to the system.
- 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.
- Select Submit to save your selection.
Preparing the Payroll File
Depending on the type of upload you will utilize there are a few requirements you want to review. 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
Follow these instructions if you are using a payroll system to submit your CPR data.
- Export your file in the applicable format from your payroll system.
- Verify the following fields are present in your file:
- 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.
- Save the completed file to your computer.
- Proceed to reporting your certified payroll report. You may also need to perform specific mapping. For more information, see Upload CPR Data and Perform Payroll Import Mapping.
Using the eComply CPR CSV Template
Following these instructions if you are using our standard downloadable file.
- From the left Navigation pane, select Setup > Payroll Upload Settings.
-
On the Basic Settings tab, locate Template, and download the eComply CPR CSV Template (or Legacy eComply CPR CSV Template) file.
Note: On first use, select Submit to reveal the template and then select the linked .csv file to download it.
- Complete all required fields for each employee. See the Required Fields table below.
- 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.
- Save the completed file using a name that identifies the project and week-ending date.
- Proceed to reporting your certified payroll report. For more information, see Upload CPR Data and Perform Payroll Import Mapping.
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:
- Numbers must be in numeric format. It should exclude dollar ($) and comma (,) symbols.
- If possible, total tax and other deductions should be broken down to FICA, Fed Withholding, State Withholding.
Summary
You can streamline CPR creation by configuring your payroll upload format and preparing employee payroll data from a supported payroll system or either of the eComply CPR CSV templates. 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