When your payroll fails to send automatically to Deel, you can download the file and submit it manually. This article explains how to access failed payroll files, identify the reason for submission failures using error messages, and take the appropriate corrective action based on the specific error you encounter.

Preparation: Understand how the Deel access token works

Kenjo and Deel are connected through an API (application programming interface). Your payroll is automatically transferred through this connection.

For the transfer to work, the access token must be correctly entered in your payroll settings.

Note: You receive the access token during your onboarding with Deel, not from Kenjo. If you have questions about the token, contact Deel directly.

Here's how to add the access token in Kenjo:

Go to Payroll > Payroll settings.
In the Payroll provider info section, enter the token you copied from your Deel developer center in the Access token field.
Click SAVE.

Prepare the file for sending

When you miss the deadlines for sending your payroll to Deel, follow these steps to download the file and send it manually.

Go to Payroll > Payroll Overview
Click SEND PAYROLL
You will see a small red x to the right of the magnifying glass with the text Payroll sent
Click the link View details
You will see another small red X with text
Click the link ending in .xlsx to download the payroll as a file

At the moment the error messages are in English only.

Check the file for causes of errors

Open the file
Look for the status column and filter for failed
The failed field indicates that for one or more or all employees it was not possible to send the payroll file to the provider
An error message to the right of the status column will explain the reason for the failure. Depending on the error, take the respective step:

Check out this video to understand your to-dos

Interpret error messages and solutions

Here is an overview of the possible error codes and the required actions:

Status Error message	What to do
Delayed submission is not allowed. Payroll cycle is already closed.	You are trying to submit this payroll after the last possible submission day. Simply send this file to Deel manually.
Invalid request body	The format of some of the content is incorrect. Make sure that you haven’t edited something in the file by accident.
data.shifts.0.external_id: String must contain at most 48 character(s)	Shift ID can't be longer than 48 characters.
data.shifts.0.summary.total_payable_hours: Number must be greater than 0	For this employee Kenjo tries to send a wage type with 0 or negative value for this period, which is not possible.
Shift Rate not found	The shift rate/ wage type is missing on Deel. It needs to be created.
Contract with id XXXX not found	Contract ID can't be found. Either it is a wrong ID or it wasn't yet created in Deel.
Shift with external id XXXXX not found	Wage type data that was integrated before is not found. Data was deleted on Deel.
The following external IDs are not unique: XXXXXXXXXXXX	Wage type data for that period is already created. You need an update instead of creation.

Send the file to your payroll provider

Once you have successfully downloaded the file, send the downloaded data to Deel via payroll ticket or email.

Resolve failed payroll submissions to Deel