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

How to solve WooCommerce Order Download Failures Caused by an Outdated Store Module

This article helps Webgility Desktop users troubleshoot order download issues from WooCommerce into Webgility Desktop, often caused by an outdated Webgility store module plugin running on WooCommerce. It provides steps to check and update the integration, along with guidance on resolving other common connection problems such as blocked IP addresses, incorrect URLs, and version mismatches.

Overview

If you're having trouble downloading orders from your WooCommerce store into Webgility Desktop, an outdated store module integration is a common reason. This guide will walk you through how to check for and fix this issue, along with other common connection problems like blocked IP addresses, incorrect URLs, and version mismatches.


Symptom

  • Orders aren't downloading from WooCommerce into Webgility Desktop.
  • You might see an error or alert indicating an outdated or incompatible store module.

Resolution Steps

  1. Confirm Module Version

First, let's check the version of your WooCommerce store module. This needs to be done within your WooCommerce admin panel, not Webgility Desktop.

  1. Log in to your WooCommerce admin panel.
  2. Go to Plugins > Installed Plugins.
  3. Locate the Webgility WooCommerce Integration module.
  4. Check the version number. Ensure it is the latest version.
  1. Update Application and Integration Module

Outdated software is a frequent cause of integration issues.

  • To update your Webgility Desktop application:

    1. If you're already logged in: Click Help > Check for Updates > Update within Webgility Desktop.
    2. If you're unable to log in: Download and install the latest version from portal.webgility.com.
  • To update your Webgility WooCommerce Connector plugin:

    1. Download the latest Webgility/WooCommerce integration plugin. The latest version is available from your Webgility account portal. Log in to portal.webgility.com and navigate to the Downloads section to find the WooCommerce plugin file.
    2. Log in to your WooCommerce admin panel.
    3. Go to Plugins > Add New > Upload Plugin and select the update package you downloaded.
    4. Click Install Now, and then Activate the updated module.
    5. Confirm the successful update under your Plugins list. If the plugin isn't currently installed, follow these steps to install the latest Webgility connector plugin from portal.webgility.com.
  1. Verify Integration and Reconnect

After updating, you'll need to reconnect your store in Webgility Desktop to refresh the connection.

  1. In Webgility Desktop, go to Connections > Sales Channels > Manage Sales Channel > Edit Connection.
  2. Enter the required authentication or API credentials if prompted.
  3. Click Test Connection.
  4. Confirm that the connection status is Success.
  1. Download Orders

Once the connection is successful, try downloading your orders again.

  1. In Webgility Desktop, go to Orders > Download Orders.
  2. Check for any missing orders; verify that all your recent orders now appear.
  1. Post Orders into QuickBooks

Finally, confirm that orders can be posted to QuickBooks without issues.

  1. Select one or more downloaded orders in Webgility Desktop.
  2. Click Post to QuickBooks.
  3. Confirm successful posting without any errors.

Other Common Connection Issues & Troubleshooting

Sometimes, issues aren't just about outdated modules. Here are other common problems and how to fix them:

Blocked Webgility Extension Access

Your WooCommerce store's security settings might be blocking Webgility.

  • Solution: Whitelist Webgility IPs Please whitelist the following IP addresses in your WooCommerce hosting environment. This allows Webgility to communicate with your store securely:
    • 183.182.84.170
    • 111.118.255.21
    • 54.69.99.71

Incorrect Webgility Extension URL

Using the wrong URL during the connection process can cause failures.

Incorrect WooCommerce Admin Credentials

Ensure you are entering your correct WooCommerce admin username and password when connecting your store in Webgility.

Troubleshooting Error Messages

When you test your store connection in Webgility Desktop (Go to Connections > Sales Channels > Manage Sales Channel > Edit Connection > Test Store Connection), you might see messages like:

  • "We are facing an issue while processing your request. Please try again later."
  • "The remote server returned an error. (501) Service Temporarily Unavailable."
  • "Not able to connect to WooCommerce."

🛠 How to Fix These Errors

Step 1: Test Extension URL in Browser Paste your Webgility Extension URL into your browser. If it returns an error such as:

  • 403 Forbidden
  • Page Not Found
  • Access Denied

Continue with the checklist below.

Step 2: Checklist to Resolve Access Errors

  • Ensure the following IPs are whitelisted: 183.182.84.170, 111.118.255.21, 54.69.99.71
  • Confirm that your Webgility files on your hosting server have Read/Write/Modify permissions.
  • Make sure you're using the latest version of Webgility Desktop. (Help > Check for Updates > Update)
  • Upgrade to the latest Webgility Extension for WooCommerce if needed (download from portal.webgility.com).

Verifying Webgility Extension Version Paste the Webgility Extension URL into your browser. The version number will be visible at the top of the page. Ensure it matches the latest release available from portal.webgility.com.

Connection Tips

If you're still having trouble connecting:

  • Try modifying the URL format:
    • Add or remove www
    • Switch from http to https or vice versa

Additional Notes

  • Regularly update your WooCommerce and WordPress core alongside your store modules.
  • Always ensure you're using compatible versions of plugins and Webgility Desktop based on the requirements matrix.