Payroll & Finance Errors

Error code	What it means	What to do
PAYROLL_SYSTEM_NOT_FOUND	No payroll system configured.	Set up the payroll integration in Company → Integrations.
PAYROLL_RUN_NOT_FOUND	Payroll run record not found.	Verify the run ID or check payroll history.
PAYROLL_RUN_ALREADY_IN_PROGRESS	A payroll run is already in progress.	Wait for the current run to complete before starting another.
PAYROLL_RUN_COOLDOWN_PERIOD_ACTIVE	Payroll run cooldown is active.	Wait for the cooldown period to expire before retrying.
PAYROLL_EMPLOYEE_NOT_FOUND	Payroll employee record not found.	Verify the employee exists in the payroll system.
PAYROLL_EMPLOYEE_ALREADY_DEACTIVATED	Payroll employee is already deactivated.	No further action needed — employee is already inactive.
FINANCE_SYSTEM_NOT_FOUND	No finance system configured.	Set up the finance integration in Company → Integrations.
FINANCE_INVOICE_NOT_FOUND	Finance invoice not found.	Verify the invoice exists in the finance system.
COMPANY_ALREADY_HAS_FINANCE_CONNECTION	A finance connection already exists.	Remove the existing connection before adding a new one.
FINANCE_CONNECTION_REQUEST_INVALID_ACCESS	Finance connection request is invalid.	Verify the connection key and retry.
ZENEGY_DEDUCTION_NOT_FOUND	Zenegy deduction not found.	Check the deduction configuration in Zenegy.
ZENEGY_ORGANIZATION_ADMIN_MISSING	Zenegy organisation admin is missing.	Assign an organisation admin in Zenegy before syncing.