Troubleshooting

Failed syncs, expired connections, licence errors, debug logs and logging a case.

15 articles, in the order they're best read

  1. 1Why a Sync Failed and How to Retry ItRead Sync History and the Debug Log Viewer, understand the common causes, and push a corrected record again.
  2. 2Records Aren't Syncing at AllWhen nothing is moving, work through these in order.
  3. 3An Invoice Failed to CreateThe usual causes, in the order worth checking.
  4. 4Duplicate Contacts in XeroWhy duplicates appear, how to clean them up, and how to stop it happening again.
  5. 5Reconnecting an Expired Xero ConnectionWhat causes the connection to drop, how to spot it, and how to restore it.
  6. 6Licence and Subscription ErrorsWhat the licence messages mean and how to clear them.
  7. 7“Sync Is Currently Running” When Removing a Xero OrganisationWhy the warning appears when no sync is running, and what to do about it.
  8. 8When Your Own Automation Blocks the SyncExempt TwoCanConnect's rollup writes from your validation rules by ignoring saves that only change its fields.
  9. 9Data Quality GuardsWhat happens when Xero data doesn't fit Salesforce, and which side wins when both change.
  10. 10Self-Diagnose, Debug Logs and Logging a CaseThe Help & Troubleshooting screen — the Self Diagnosis Tool for a stuck invoice, and the five steps that make a support case fast to resolve.
  11. 11Downloading and Reading Debug LogsWhere the logs are, what they contain, and what to look for.
  12. 12The Admin Overview ScreenCheck field permissions, API callouts remaining and what's actually synced.
  13. 13Granting Login Access to SupportLet a support engineer see the problem in your org, safely.
  14. 14Finding Your Salesforce Org IDWhere to find it, and why every support case should include it.
  15. 15Known Issues and LimitsDocumented limits, and behaviour that surprises people but is working as intended.

Still need help?