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

How to Fix the “Object Reference Not Set to an Instance of an Object” Error When Downloading Square POS Orders in Webgility Desktop

This article helps Webgility Desktop users resolve the “Object reference not set to an instance of an object” error encountered when downloading orders from a Square POS sales channel in Webgility Desktop. This issue commonly occurs due to using an outdated version of the application that is incompatible with recent Square POS updates. The guide provides step-by-step instructions to update Webgility Desktop and fix the error.

Causes of the Issue

  • Outdated Webgility Desktop build: Older versions may not be compatible with the latest Square POS API changes.

  • Corrupted or missing integration settings: Improper Square POS connection settings could lead to failed downloads.

Step-by-Step Instructions

1. Confirm the Error Source

  • Open Webgility Desktop.

  • Attempt to download orders from your Square POS sales channel.

  • If the error message appears, confirm it’s:

    Object reference not set to an instance of an object

2. Check Your Current Application Version

  • Navigate to Help > Term and Privacy > About Webgility in Webgility Desktop.

  • Verify your current Webgility desktop version.

3. Update to the Latest Webgility Desktop Version

  1. Log in to Webgility Desktop.

  2. Navigate to Help > Check for Updates.

  3. In the update window, click Update if a new version is available.

  4. Ensure the "Take Webgility database backup before proceeding" option is selected.

  5. Choose a backup location when prompted.

  6. The installer will launch and begin the update automatically.

  7. After the update, log back into Webgility Desktop.

  8. The database will update automatically upon login.

  9. Confirm the update via Help > Terms and Privacy.

✅ Done! Your Webgility Desktop is now updated.


4. Reconnect to Square POS and Test

  • Go to Connections > Sales Channel > Manage Sales Channel.

  • Select Square POS and ensure it’s connected.

  • Attempt to download orders again to confirm the error is resolved.

5. Additional Troubleshooting (If Needed)

  • Recheck your internet connection and firewall settings.

  • Review and verify your Square POS login credentials in the Webgility connection panel.

  • Ensure Webgility has appropriate permissions within Square to access order data.

Best Practices

  • Stay Updated: Regularly check for Webgility Desktop updates, especially after your POS platform receives an update.

  • Backup Frequently: Maintain regular backups of your Webgility configuration and order data.

Note

If this error continues after following the steps above, you may need to reset your Square POS connection or review the integration logs for more details.