Paylocity Bi-Directional: Troubleshooting if your New Hire did not send to Paylocity

If the new hire fails to send to Paylocity, it is usually because a required piece of information is missing or the information is not correctly formatted for Paylocity to accept the information. In this article, we will cover how to troubleshoot those Paylocity Errors.

In this article:
How will you know if the new hire transfer fails
Troubleshooting Common Error Messages
How to resend the new hire to Paylocity
Additional Resources

How will you know if the new hire transfer fails

On the candidate's profile in ClearCompany, on the 'Hire' tab, the status of integration will say "Failed".

Troubleshooting Common Error Messages

Next to the "Status", you will see a "Message" column. This displays the error code if the status is "failed." Below is a list of common error codes for each integration and their common fixes.

Common Error Messages

":Error occured persisting data, refer to LogGroupId:9b48d3ed-abe9...etc"

To resolve:

The candidate has two last names or a special character like a hyphen in their name. Remove any spacing or characters and resync. For example, deleting a '.' in the name, or check for foreign characters "-" or "()", or upping the Maximum Username allowance.

"Wrong 'companyid' value"

To resolve:

1. If you utilize multiple company codes in Paylocity ensure you have selected a company code in your Requisition Custom Field.
2. If you have a single company code in Paylocity, please reach out to ClearCompany support with the company code from your Paylocity account.

"costCenter3: costCenter3 must be one of the following;..."

The CostCenter that is being sent over is not an accepted value in your Paylocity system.

To resolve:

1. Ensure the cost center is a valid option in Paylocity
2. If so, then reach out to ClearCompany support.

"* Invalid format. CustomFieldId must be an integer if DataExportField.SourceType == CustomReqField. * Parameter name: fieldname"

To resolve:

1. This error message can be resolved with the help of our support team.

Object reference not set to an instance of an object.

To resolve:

1. This error message can be resolved with the help of our support team.

Authentication failed for Paylocity Outbound Integration.

To resolve:

1. This error message can be resolved with the help of our support team.

Input String is not in Correct Format

To resolve:

1. This error message can be resolved with the help of our support team.

Paylocity Errors- Support

If the error is not listed above, please contact our support team, at [e-mail].

How to resend the new hire to Paylocity

After the problem has been resolved, you will want to manually trigger the new hire's information to send to Paylocity. To do so, follow these steps.

Guide

1. Navigate to the Candidate's Profile.
2. Click on the Hire tab.
3. At the bottom of the screen, you will see the Integrations section. On the right-hand side, click Send Data.
4. Then select the name of the integration you wish to resend from the drop-down. 
5. Click Send Data. 

After the new hire attempts to transfer to Paylocity, you'll see if it was successful in the Status column on the Hire tab of the candidate's profile. Note, that it may take up to a minute for the export to process but if you still see a 'Pending' integration status, please refresh the page and the status should be updated.