Upgrade the Web Connector
The connection needs the classic QuickBooks Web Connector, version 2.2.0.34 or newer. Older builds cannot make the secure TLS 1.2 connection our server requires. With an old build, the Web Connector usually fails with QBWC1012 and a line about an SSL/TLS secure channel. See QBWC1012: Authentication failed.
The Web Connector comes with QuickBooks Desktop, so most computers already have a recent version. Older computers and computers upgraded over many years are the ones that fall behind.
Find your version
Section titled “Find your version”- Exit the Web Connector if it is running.
- Open File Explorer and go to
C:\Program Files (x86)\Common Files\Intuit\QuickBooks\QBWebConnector. - Right-click
QBWebConnector.exeand choose Properties. - Open the Details tab and read File version or Product version.
If the version is 2.2.0.34 or higher, you do not need to upgrade.
Install a newer version
Section titled “Install a newer version”You need a Windows account that can install programs. Ask your IT person if you do not have one.
- In QuickBooks Desktop, choose File › Exit so QuickBooks is closed.
- Exit the Web Connector. If it keeps running in the background, open Task Manager with Ctrl+Shift+Esc, find QuickBooks Web Connector or
QBWebConnector.exe, and click End task. - Download the installer from Intuit’s QuickBooks Web Connector page on the Intuit developer website. Only download it from Intuit.
- Run the installer and follow its steps.
- Restart the computer.
- Open QuickBooks Desktop, open the company file, and choose File › App Management › Update Web Services to start the Web Connector.
If the installer refuses because a version is already installed, uninstall QuickBooks Web Connector from Settings › Apps (or Control Panel › Programs and Features) first, then run the installer again.
After the upgrade
Section titled “After the upgrade”- In the Web Connector, look for the app’s row.
- If the row is there, check that its box is checked and Auto-Run is on. If the Web Connector reports a password error for the row, ask the app for a new setup link. The old password is never shown again. See Web Connector password problems.
- If the row is gone, ask the app for a new setup link and run it. See Connect QuickBooks Desktop.
Check that it worked
Section titled “Check that it worked”Within a minute, the app’s row in the Web Connector shows a recent update time, and actions in the app that need QuickBooks succeed.
If TLS errors continue
Section titled “If TLS errors continue”A current Web Connector also needs Windows to support TLS 1.2. Windows versions that the current QuickBooks release supports do. If you still see an SSL/TLS error, install pending Windows updates and see QBWC1012: Authentication failed.
When to contact the app’s support team
Section titled “When to contact the app’s support team”Contact them if the upgrade does not clear the error. Send the Web Connector version, the Windows version, the time and the exact message, and a screenshot of the Web Connector.