Connecting to QuickBooks Desktop

How Connection Works

PrimeConnect uses the QBFC (QuickBooks Foundation Classes) SDK to communicate with QuickBooks Desktop. This is the same official SDK that Intuit provides for third-party integrations. The connection is entirely local — PrimeConnect talks directly to the QuickBooks process running on your machine through COM (Component Object Model) interop.

This means:

• No internet required — the connection between PrimeConnect and QuickBooks happens entirely on your computer. Your financial data never leaves your machine during operations.
• No cloud sync — PrimeConnect does not upload your data to any server. The only internet usage is for license verification and automatic updates.
• Real-time communication — when you import, export, or delete records, PrimeConnect sends requests to QuickBooks and receives responses in real time. There is no batch queue or delayed processing.

Prerequisites

Before PrimeConnect can connect to QuickBooks, the following conditions must be met:

1. QuickBooks Desktop must be installed — PrimeConnect supports QuickBooks Desktop Pro, Premier, and Enterprise editions. It does not support QuickBooks Online, QuickBooks for Mac, or QuickBooks Simple Start.
2. QuickBooks must be running — the application must be open and fully loaded. PrimeConnect cannot start QuickBooks for you.
3. A company file must be open — you must have a company file (.QBW) loaded in QuickBooks. PrimeConnect cannot connect to QuickBooks if it is sitting on the "No Company Open" screen.
4. You must be logged in — log in to QuickBooks as a user with appropriate permissions. For full PrimeConnect functionality (import, export, delete), the Admin user is recommended.
5. QuickBooks must not be in a modal dialog — if QuickBooks is showing a dialog box (e.g., a preferences window, a print dialog, or an error message), it cannot process SDK requests. Close any open dialogs first.

Connecting Step by Step

Connecting PrimeConnect to QuickBooks is straightforward. Follow these steps in order:

1. Open QuickBooks Desktop. Launch QuickBooks from your Start menu or desktop shortcut. Wait for it to fully load.
2. Open your company file. If QuickBooks does not automatically open your last company file, use File > Open or Restore Company to select the .QBW file you want to work with. Log in with your credentials.
3. Launch PrimeConnect. Open PrimeConnect from your Start menu or desktop shortcut. PrimeConnect will automatically scan for a running QuickBooks instance.
4. Check the status bar. Look at the bottom of the PrimeConnect window. You should see a green indicator dot followed by the name of your company file (e.g., "Connected — Acme Corp"). This confirms a successful connection.

If the first connection attempt prompts an authorization dialog inside QuickBooks, see the Authorizing the Connection section for instructions on granting persistent access.

Multi-User Mode

PrimeConnect works in both single-user mode and multi-user mode. If your office uses multi-user networking to share a company file across multiple computers, here is what you need to know:

• Multi-user mode is fully supported. PrimeConnect can connect to a company file that other users are also accessing simultaneously.
• Avoid "Switch to Single-user Mode" while PrimeConnect is operating. If someone switches the company file to single-user mode during an import, it can interrupt the operation.
• Exclusive mode will block connections. If QuickBooks is in exclusive (single-user) mode for a maintenance task like condensing data or rebuilding the file, PrimeConnect will not be able to connect until the task completes and QuickBooks returns to normal mode.

Connection Status Indicators

The status bar at the bottom of PrimeConnect shows the current connection state at a glance. Here is what each indicator means:

PrimeConnect checks the connection continuously. If QuickBooks closes or the company file changes, the indicator updates automatically within a few seconds.

Switching Company Files

You can switch between QuickBooks company files without restarting PrimeConnect. Here is the process:

1. In QuickBooks, go to File > Close Company/Logoff to close the current company file.
2. Open the new company file using File > Open or Restore Company.
3. PrimeConnect will automatically detect the file change. The status bar will briefly show "Not connected" and then update to show the new company file name with a green indicator.

There is no need to close and reopen PrimeConnect. The reconnection typically takes 2-5 seconds. If the new company file has not previously authorized PrimeConnect, QuickBooks will show the authorization dialog again.

Re-Authorizing Access

If PrimeConnect was previously denied access or if you need to re-authorize it, you can manage integrated application permissions directly in QuickBooks:

1. In QuickBooks, go to Edit > Preferences > Integrated Applications.
2. Click the Company Preferences tab.
3. Find PrimeConnect in the list of applications.
4. If PrimeConnect is listed with "Don't allow access," select it and click Remove to clear the denial.
5. Close the Preferences window.
6. Restart PrimeConnect. QuickBooks will show the authorization dialog again — this time, select "Yes, always; allow access even if QuickBooks is not running".

Common Connection Issues

If PrimeConnect cannot connect to QuickBooks, refer to the table below for common causes and solutions:

If none of these solutions resolve your issue, see the full Troubleshooting article or contact our support team for assistance.