If you're seeing QBWC1039 or any other Web Connector error while connecting Fyle to QuickBooks Desktop through Web Connector, you're not alone. This error crops up due to issues like file mismatches, permission settings, or outdated software. In this guide, you'll find a breakdown of all known errors, what causes them, and exactly how to fix each one.
Best Practices to Avoid QBWC1039 (one of the most common errors)
Before we dive into fixes, follow these up-front best practices to minimize the risk of QBWC1039 and ensure smooth integration with third-party applications:
Keep all installed QuickBooks versions updated to their latest releases—even if unused. QuickBooks Desktop installations are dependent on the latest version installed on your machine.
Keep the QuickBooks company file and Web Connector in the same location to avoid path mismatch issues.
Avoid renaming or relocating the company file without updating app integrations.
Run QuickBooks as Admin and use Single-user Mode when configuring integrations.
Ensure that permissions are properly granted to third-party apps via Preferences > Integrated Applications.
Add the QWC file only once per application and company file to prevent duplicate OwnerID/FileID issues.
Set up a backup routine and store a local copy of your company file.
QBWC1039 Error Types and Fixes (Source)
Error: “QBWC1039: Error connecting to QuickBooks. Error message received from QuickBooks was…”
Cause: Web Connector and the company file are located in different directories.
Fix:
Locate your QuickBooks company file (press F2 or Ctrl + 1 inside QuickBooks to view location).
Make sure Web Connector is running from the same directory as the company file.
Error: “If the QuickBooks company data file is not open… BeginSession must include name of data file”
Cause:
Company file was renamed or moved.
Web Connector isn’t set to run when QuickBooks is closed.
Fix:
If the file was renamed or moved:
Restore the original name and/or move it back to its original location.
Reopen the file in QuickBooks.
If using a third-party app, notify the vendor to update their file reference.
If Web Connector isn’t configured to run in background:
Sign in to QuickBooks as Admin.
Go to File → Switch to Single-user Mode.
Navigate to Edit → Preferences → Integrated Applications → Company Preferences tab.
Select the app → click Properties.
Check Allow this application to log in automatically.
In the authorization window, select YES, choose the user, and click OK.
Error: “There was a problem adding the application. Check QBWCLog.txt for details”
Cause:
Company file was renamed or moved.
Your system has older QuickBooks versions that are not updated.
Fix:
Move the file back to its original name/location.
If renaming/moving is needed:
Remove the app from Web Connector.
Rename/move the file.
Reconnect via QWC.
Ensure all versions of QuickBooks Desktop installed on your system are updated.
Example: If you downgraded from QB 2021 to QB 2020, you still need to install and update QB 2021 to the latest release—even if not used.
Error: “This application does not have permission to access the QuickBooks company data file…”
Cause: The QuickBooks Admin hasn’t granted the necessary access permissions.
Fix:
Sign in to QuickBooks as Admin.
Go to File → Switch to Single-user Mode.
Navigate to Edit → Preferences → Integrated Applications → Company Preferences tab.
Uncheck the box labeled “Don’t allow any applications to access this company file.”
In the SDK App Authorization popup, click Yes.
Verify that your third-party app is selected and access is allowed, then click OK.
Error: “This application has not accessed this QuickBooks company data file before”
Cause: QWC file was added without signing in as Admin.
Fix:
Open QuickBooks.
Sign in as Admin in Single-user Mode.
Launch Web Connector.
Click Add an Application, then choose your QWC file.
Error: “Unable to add FileID to company file for this Application”
Cause: The app was added too many times to the same file. This error indicates excessive duplication of the FileID record.
Fix:
You’ll need to contact QuickBooks support for a deeper resolution to remove hidden IDs.
Error: “Unique OwnerID/FileID pair value required”
Cause: The app was already added before, and you're trying to add it again without clearing its record.
Fix:
Download and open the CP3 Tool.
In the tool, click Open, then select your
.QWCfile.Enter the QBC file location if needed.
Click Remove Stamp.
Confirm all popups:
Click Yes on the QuickBooks Application Certificate window.
Click Continue → Done → OK.
Close the CP3 tool, reopen QuickBooks and Web Connector, and re-add your app.
Need More Help?
If you've tried all the above steps and are still running into errors, don't worry—we're here to help. Reach out to us at [email protected] and our team will assist you.