An error has occurred
One of the workers have not been finalized (incomplete), or has been terminated in KeyPay
Ask the client to resolve the issue in KeyPay.
If the client confirms there is no issue with the workers, but is still unable to export, contact the payroll champion so they can ask KeyPay about this.
V3 instances will tell you which workers are incomplete
Keypay set up is incomplete for <<worker name>>
PayCategoryId does not match an id for any PayCategory
Confirm with the client if the paycategory exists in KeyPay
Confirm with the client if the timesheet’s pay category is not a System pay category in KeyPay (you cannot export timesheets using system pay categories)
In KeyPay, it will show system beside the name if it is a system pay category
If the pay category does not exist or is a system pay category, as the client to follow the steps below to resolve the issue
create a new pay category in KeyPay,
sync it to Expedo,
update the engagement and assignment with the new pay category
re-verify the timesheet
permanent fix is to exclude system pay categories from being synced to Expedo.
Ticket for reference: https://expedo.atlassian.net/browse/TTBP-772
StartTime for <<worker name>> cannot be before employee start date (<<start date>>)
The timesheet’s period is earlier than the employee start date in KeyPay
Ask the client to update the employee start date in KeyPay and re-export the payroll batch
Error 504: Gateway timeout
KeyPay is down
Ask client to wait for a few minutes before re-exporting the payroll batch
Key does not match an id for any employee
The Expedo worker’s KeyPay ID is incorrect
Update the worker profile with the correct KeyPay ID
Payroll batch stuck at exporting
THINGS TO CHECK
Check if the payroll batch has a Pay run # in the list
If there is a pay run #, this means that the pay run has been created in KeyPay. Please confirm with the client if the Pay run is still in KeyPay.
If the client cannot find the pay run in KeyPay, it is possible that they have deleted it themselves, or it was automatically deleted by KeyPay.
KeyPay automatically deletes pay runs if there are invalid data. This is usually caused by pay run inclusions/super adjustments that don’t have values in KeyPay.
Note - this is KeyPay’s response related to this issue:
Please ask the client to check if there are any workers with super adjustments or pay inclusions that don’t have amounts or types.
Once the client has cleaned up the data in KeyPay. The Dev team will revert the payroll batch's status to pending in order for the user to re-export the batch.
The API Key of the Employer of Record is already expired or not authorized to do any transactions
Ask the client to generate a new API Key (taken from the KeyPay site with a similar Business ID in the Integration Settings in Expedo) and update it.