Accounting > Troubleshooting Common Xero Errors

Below are common errors that you might encounter when attempting to post a pay run or an ETI Utilised journal to Xero, as well as how to troubleshoot and resolve them:

“The LineAmount cannot be zero or empty”

This error occurs when there is a line item or account that has a 0 (or blank) value, which Xero does not allow. Note that the most common cause of this error is duplicate account mappings. Follow the steps below to find out which items have been duplicated:

  • View the Journal Summary (via the Send to Xero link) and confirm which line item/account has the R0 value.
  • Alternatively, go to Settings > Accounting > Accounting Integration and view the Pay Run Mapping page for the relevant integration. Check for any duplicate mappings, specifically between the Debit and Credit sides and correct them.

Please note: If you need to reconcile the accounts, you must do so in Xero.

“Account code ‘xyz’ has been archived, or has been deleted. Each line item must reference a valid account”

This error occurs when one or more items have been mapped to a Xero account which has been archived or deleted. Follow the below steps:

  • Go to Settings > Accounting > Accounting Integration and view the Pay Run Mapping page for the relevant integration.
  • Check for any items mapped to a deleted or archived Xero account.
  • Click on Update Chart of Accounts to update the Xero accounts and remap the affected items.

“Account code ‘xyz’ is not a valid code for this document”

The most common cause for this error is when a Xero account code has been changed, but the Chart of Accounts has not been updated on SimplePay. Follow the below steps:

  • Go to Settings > Accounting > Accounting Integration and view the Pay Run Mapping page for the relevant integration.
  • Check for any items mapped to an Xero account whose code has recently changed.
  • Click on Update Chart of Accounts to update the Xero accounts and remap the affected items.
You are using the help system of SimplePay, a payroll system that simplifies the payroll process. Designed just for South Africa, it's a fully online solution. Read more.