What we do
Tools
Industries
Department
How we workLet's talk →
Home/QuickBooks Web Connector Setup and QBWC Errors
QuickBooks Desktop & Enterprise

QuickBooks Web Connector Setup, and What Each QBWC Error Code Is Telling You

The QuickBooks Web Connector (QBWC) is a small, free Intuit program for Windows. It's the go-between when a web-based app, a store, a time tracker or a CRM, needs to read from or write to a QuickBooks Desktop company file. The app hands you a .qwc file and a password. You add both, and from then on the Web Connector calls the app on a schedule. When a run fails it leaves a QBWC code, and nearly every code points at one of four things: QuickBooks itself, the password, the .qwc file, or the app's own server.

The Web Connector in four lines

What it does: on each run it asks the app's web service for work, receives qbXML requests, runs them against your company file through QuickBooks, and passes QuickBooks' answers back to the app.

What it needs: QuickBooks Desktop Pro, Premier or Enterprise on Windows, the app's .qwc file saved on that same computer, and the password the app gave you. QuickBooks Online doesn't use it.

Where it lives: once installed, it's in the Windows Start menu as QuickBooks Web Connector, and it runs from the system tray while syncs are scheduled.

Apps listed in Intuit's web apps can be set up from Manage Web Apps instead: select Set up, sign in on the app's site, choose Connect to QuickBooks, then Done on the Access Confirmation screen.

File App Management Manage Web Apps

QBWC error codes, grouped by what they point at

Messages and fixes follow Intuit's own list of common Web Connector errors.

QBWC1007, 1008, 1009 and 1022 to 1024: "An error occurred when connecting to QuickBooks"

How you'll know: QuickBooks isn't running, no company file is open, or a window inside QuickBooks is in the way.

Fix: Restart QuickBooks, sign in to the company file, close any other QuickBooks windows, and run the update again. If the file is shared, our multi-user mode guide covers why it may be locked by someone else.

QBWC1053: a modal dialog box is open in the company file

How you'll know: Someone left a window such as the Employee Center or Company Settings open.

Fix: Close those windows. If the error stays, end every QuickBooks process in Task Manager, reopen QuickBooks, and sync again.

QBWC1030, 1038, 1040 and 1041: the password

How you'll know: "Password is not available for application", "did not provide a valid username and/or password", or the odd one, "Garbage data".

Fix: Type the password into the app's Password column again. Forgotten it? The app's support resets it, then you enter the new one. Still refused after that? Download a fresh .qwc from the app and replace the old one.

QBWC1012: "Authentication failed… Server was unable to process request"

How you'll know: QuickBooks and the password are fine; the app's server choked on the sign-in call.

Fix: Intuit can't clear this one. It belongs to whoever runs the app's web service. If that's your own in-house sync, its authenticate method is throwing an error, and its server log shows why.

QBWC1035, 1048 and 1088: the .qwc file itself

How you'll know: A localhost lookup failure, a server certificate that can't be verified, or "Company file do not match" after the file was updated.

Fix: Remove the app from the Web Connector, download the current .qwc from the app provider, and add it again. For 1088, choose Yes when asked to replace it.

QBWC1006, 1033 and 1085: the log file

How you'll know: The Web Connector can't find, create or write to its log, QWCLog.txt.

Fix: Close QuickBooks and the Web Connector, rename QWCLOG.TXT to QWCLOGOLD.TXT in the log folder under C:\ProgramData\Intuit\QBWebConnector, reopen the Web Connector and restart the computer. 1033 can also mean a full disk or missing Windows permissions.

"QuickBooks found an error when parsing the provided XML text stream"

How you'll know: No code, but one record keeps failing. The app sent a character QuickBooks won't take, or a field longer than QuickBooks allows.

Fix: Report it to the app provider with the record that failed. Shortening a long name in the source system is often a quick workaround.

Adding an app to the Web Connector, install to first sync

  1. 1

    Install it on the computer that runs QuickBooks

    Close QuickBooks. Download the latest Web Connector from the Intuit Developer site, extract the zip, and run QBWebConnectorInstaller.exe as an administrator. Keep the app's .qwc file on this same machine.

  2. 2

    Open QuickBooks as the admin, with the company file open

    The first time an app asks for access, QuickBooks needs an admin signed in to approve it.

  3. 3

    Add the .qwc file

    In the Web Connector, select Add an application and browse to the .qwc file. QuickBooks then asks whether this app may read and change the company file.

    Watch for: the option to allow access even when QuickBooks isn't running. Scheduled syncs at night depend on it.

  4. 4

    Enter the password

    Type the password the app gave you in its Password column, and save it when the Web Connector asks.

  5. 5

    Run it once by hand

    Tick the app's box and select Update Selected. Watch the status column, then check the app's side to confirm the records arrived.

  6. 6

    Schedule it

    Tick Auto-Run and set how often it runs in the Every_Min column. The Web Connector keeps running in the background to do this.

    Watch for: QBWC1020 when you exit with jobs scheduled. If the Web Connector is closed or the PC is asleep, nothing runs.

Jobs the Web Connector suits, and jobs it strains at

What has to move Web Connector? What to weigh
Orders, time entries or customers into Desktop every hour or overnight Yes. Polling on a schedule is exactly what it was built for. A Windows PC that stays on, with the Web Connector running and the company file reachable.
A sale posted to QuickBooks the moment it happens Not really. It only acts when a run comes round or someone clicks Update Selected. A short interval narrows the gap. An SDK app on the same network, covered on the Desktop API page, closes it.
Reports in Excel or Power BI, read-only Usually not the simplest tool for it. An ODBC driver reads the file with plain SQL. Compare it on our QODBC guide.
Books on QuickBooks Online No. Online apps connect through Intuit's REST API instead. Nothing to install on a PC at all.
A Desktop file you expect to retire soon Fine for now. Keep the mapping of fields separate from the qbXML, so the QuickBooks end can be swapped. Timelines are on Desktop going away.
What this looks like in practice

Shopify retailer

Shopify to QuickBooks sync

A retailer's Shopify sales synced into QuickBooks as one number a day, and every month someone spent half a day working out why a payout didn't match. We rebuilt the sync to itemize by product category, use real product costs, and match each payout to the orders, fees and refunds behind it. The half-day reconciliation became a five-minute check.

Web Connector questions from the person at the QuickBooks PC

Why do I get a "create failed" error in the Web Connector?

QuickBooks refused the record the app sent. Common reasons are a name that's already in use, a required field left empty, or a reference to an item, customer or account that doesn't exist in your company file. The QuickBooks status message for that request names the problem; look for it in QWCLog.txt or the app's own log. The fix is either in QuickBooks (add the missing item) or in the app's field mapping.

Can the Web Connector sync in real time?

No. It runs when its Auto-Run interval comes round or when someone selects Update Selected. Between runs, nothing moves. Anything that has to land within seconds needs an SDK program on the same network rather than the Web Connector.

Does QuickBooks have to stay open for the Web Connector to sync?

The computer and the Web Connector do. QuickBooks itself can be closed only if the app was given access even when QuickBooks isn't running. Without that, expect the 1007 to 1009 connection errors overnight.

Does this work with QuickBooks Enterprise too?

Yes. Enterprise uses the same Web Connector and qbXML as Pro and Premier on Windows. Whether an app can fill Enterprise-only fields, such as Advanced Inventory sites, depends on that app.

Is the quote for Web Connector work really free, with no obligation?

Yes. n-frames reads your .qwc, the Web Connector log and what the sync is meant to move, then quotes the rewrite, the repair or the move to QuickBooks Online. You owe nothing for the quote itself.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.