Troubleshooting QuickBooks Online Disconnection and Order Sync Issues in Webgility
This article helps Webgility Desktop users who experience intermittent disconnections or order synchronization failures when integrated with QuickBooks Online. It provides step-by-step troubleshooting to maintain a stable connection and ensure reliable syncing of orders through Scheduler, especially in high-transaction environments.
Overview
Webgility Desktop integration with QuickBooks Online can encounter intermittent disconnections and order sync failures, particularly in high-activity environments. This article provides step-by-step troubleshooting for ensuring connection between the two applications.
Common Symptoms
- Frequent disconnects between Webgility Desktop and QuickBooks Online
- Unexpected overselling due to missed or failed syncs
- Store switching errors or store profile connection failures
- Order fetch errors and delayed data updates
Immediate Workarounds
If the above issues occur, perform the following steps to maintain connection and data integrity:
- Manually Reconnect to QuickBooks Online
- Go to Webgility Desktop > Connections > Accounting/POS/ERP > Edit Connection.
- Re-authenticate when prompted.
- Restart the Webgility Application
- Exit Webgility completely.
- Relaunch the app and attempt sync operations again.
Diagnosing Root Causes
1. Scheduler Failures
- Inspect the Webgility Scheduler logs under the Webgility icon in the system tray (right-click on it and view logs). Look for missed schedule events or unhandled exceptions.
- Ensure the Scheduler service is running as a background process (check Windows Services console).
- Restart the Scheduler service if stopped.