QuickBooks (QBO) sync errors

Problem Statement

You need to identify and fix common sync errors when using the QuickBooks Online integration with Chargebee.

Solution

Below are frequent errors, their likely causes, and what to do.

| Error | Reason | What to do | |-------|--------|------------| | Cannot sync the invoice as the associated PLAN [name] could not be synced to QuickBooks | The plan linked to the invoice or credit note is not synced to QuickBooks. | Sync the plan first, then sync the invoice. For help, contact Chargebee Support. | | Sync has failed to complete; you can try again after some time or contact Chargebee Support | Authentication failed, sales tax is enabled in Chargebee but not in QuickBooks, or there is a multi-currency mismatch. | Check authentication, tax settings, and currency in both systems. Contact Chargebee Support if it persists. | | Sync errors without an error message | A dependent entity (e.g. customer) was removed or archived in QuickBooks, so the sync fails with no message. | Contact Chargebee Support to correct mapping or re-sync. | | Cannot sync the invoice as the invoice date is before the sync start date | You chose a sync start date (e.g. 25 Aug 2020) during setup and are trying to sync invoices dated before that. | Either enter those invoices manually in QuickBooks or contact Chargebee Support to exclude them from future syncs. |

If you see an error not listed here, contact Chargebee Support.