Permission Required: Users with the Admin Profile, External Accountant and Custom Profile can access this feature
Regional Availability: Australia, India, Singapore, United States
Overview
When integrating Xero with Volopay, you may encounter certain syncing errors that prevent successful reconciliation or posting of transactions. Below are some of the most common errors, their causes, and recommended resolutions.
Common Errors & Their Root Causes
Error | What it Means | How to Fix It |
Authentication Unsuccessful | The token used to authorize Volopay against your Xero account has expired. | Log in to your Xero account, disconnect the integration, and reconnect it with Volopay. |
Multicurrency Bank Transfers Not Supported | Transactions involving three or more currencies cannot be reconciled in Xero. | Ensure only two currencies are involved before syncing. |
Payment Amount Exceeds the Amount Outstanding | The payment entered is greater than the remaining balance of the bill/invoice. | Remove any duplicate manually applied payments in Xero, then resync. |
Invalid Account Code (e.g., 300, 440, 800) | The account code mapped in Xero’s chart of accounts is incorrect or invalid for the document. | Map the correct accounting code at the plan/add-on level and retry syncing. |
Payments Can Only Be Made Against Authorised Documents | Payments were applied to invoices/bills that are in Draft or already Paid instead of Authorised status. This often happens if manual payments are entered directly in Xero. | Remove the manual payment in Xero and then resync from Volopay. |
Feed Connection ID Not Specified or Invalid | The Xero feed is invalid, usually due to an expired trial account or mismatch in country settings. | Ensure your Xero account is active and valid. If expired, upgrade to a paid account or set up a new organization before reconnecting to Volopay. |
Lock Date Restriction | A financial lock date is set in Xero, preventing entries or edits before that date. | In Xero, navigate to Accounting > Advanced > Financial Settings > Lock Dates and adjust/remove the lock date. |
Missing Invoice ID or Number | The invoice ID or number was not passed from the backend when processing the payment. | Contact the Volopay support team to get this corrected. |
💡 Tip: Most errors are caused by mismatches between Volopay and Xero settings. Double-check your setup, and if the issue continues, please contact our support team with the error message.