Fixing "Invalid Reference to QBO Item" Errors in Webgility Online
This article helps Webgility Online users resolve the "Invalid reference to QBO item" error that occurs when posting orders to QuickBooks Online. It explains that the issue is usually due to outdated product mappings and guides users on how to refresh product data to fix it.
Overview
If you're seeing the “Invalid reference to QBO item” error while posting orders from Webgility Online to QuickBooks Online (QBO), it typically means there's a mismatch between the items in your Webgility account and your QBO product list. This usually happens when product names or SKUs have changed in QBO but haven’t been updated in Webgility yet.
The good news? It’s a simple fix.
Why This Happens
This error occurs when an item in an order can't be matched to a product in QuickBooks Online—often because the product was renamed, deleted, or newly added in QBO but hasn’t been synced to Webgility yet.
How to Resolve It
1. Refresh Product Data from QBO
-
Log in to Webgility Online.
-
Go to Sync Settings > Products > Refresh Data.
-
Wait for the sync to complete so your Webgility product list is updated with the latest QBO items.
2. Try Posting the Order Again
-
Once the sync is finished, return to your Orders page.
-
Try posting the affected order(s) to QBO again.
-
The error should no longer appear if the items are now correctly mapped.
Pro Tip
To avoid this error in the future, sync your product catalog regularly—especially after making updates in QuickBooks Online. This keeps everything aligned and ensures smooth order posting.