Skip to content
  • There are no suggestions because the search field is empty.

How to Fix Product Sync Failures and Timeout Errors with Channel Advisor in Webgility Desktop

This article helps Webgility Desktop users troubleshoot and resolve product sync failures, timeout errors, and product mapping issues when using Webgility Desktop with Channel Advisor and QuickBooks Desktop. It provides step-by-step guidance and tips to verify that everything is working correctly after the fixes.

What’s Going On

When you sync products between ChannelAdvisor, Webgility Desktop, and QuickBooks, you might occasionally see download failures or timeout errors—especially if you’re pulling a large catalog or have mapping mismatches. This guide walks you through easy, friendly steps to get everything running smoothly again.

Quick Prep Checklist

  • Update Webgility Desktop to the latest version

  • Back up your Webgility database before making changes

  • Confirm you have valid login details for Webgility, ChannelAdvisor, and QuickBooks

Step-by-Step Fix

1. Make Sure Everything’s Up to Date

  • In Webgility Desktop, go to Help > Check for Updates and install any new releases.

  • After updating, restart the app to load all improvements.

2. Verify Your Credentials

  • In Webgility, head to Connections > Sales Channels > Manage Sales channels and re-enter or test your ChannelAdvisor connection.

  • Open ChannelAdvisor and QuickBooks in your browser (or desktop app) to double-check you can log in without issues.

3. Try a Small Batch Download

  • Go to Products > All Products.

  • Instead of grabbing your entire catalog, select a small subset (e.g., 50–100 items) first.

  • If this succeeds, gradually increase the batch size until you find a comfortable limit.

4. Check Your Product Mapping

  • Under Products > All Products > Mapped (All Filter), make sure each ChannelAdvisor SKU lines up with the correct QuickBooks item.

  • Watch out for duplicate SKUs or blank mappings—these can cause unexpected timeouts.

5. Optimize for Timeout Errors

  • If you still see a timeout, split your download into even smaller batches.

  • Ensure your network is stable—use a wired connection if Wi-Fi is spotty.

  • Close other heavy network apps (like large file downloads or video streams) during sync.

6. Run a Full Test Sync

  • Once batches download cleanly and mappings look good, go to Sync Now in the main Webgility toolbar.

  • Confirm that all your products appear in QuickBooks as expected.

Friendly Tips for Next Time

  • Batch wisely: Syncing 1,000 items at once can overwhelm any system—smaller chunks keep things zippy.

  • Keep mappings neat: A quick mapping audit every month prevents surprises.

  • Stay updated: Regular updates and backups save you from troubleshooting headaches later.