Skip to main content

How Do I Connect QuickBooks Desktop to Nickel?

Set up and troubleshoot the QuickBooks Desktop integration using the Web Connector, including sync behavior, common issues, and what data flows between QBD and Nickel.

Note: The QuickBooks Desktop integration is currently in beta but is now available to all Nickel users, not just Nickel Plus.
​
If you run into any issues, please reach out to our support team — we're actively improving this integration and want to make sure you're up and running.

Video Guide

Overview

Nickel connects to QuickBooks Desktop through the QuickBooks Web Connector (QBWC). Unlike QuickBooks Online, which syncs in real time, the Desktop integration syncs when the Web Connector is running and connected.

What syncs between QBD and Nickel:

  • From QBD → Nickel: Invoices, bills, customers, and vendors are pulled into Nickel

  • From Nickel → QBD: Payments made on invoices or bills sync back to QuickBooks Desktop

Important: Creating invoices from within Nickel is not currently supported for QuickBooks Desktop. Invoices should be created in QBD and then synced to Nickel.

Setting Up the Connection:

  1. Log in to your Nickel account and go to Settings > Integrations

  2. Click Connect to QuickBooks Desktop — a popup will appear with step-by-step instructions

  3. Follow the on-screen flow to download the .qwc file (check your Downloads folder if you don't see it)

  4. During the setup flow, you'll be shown a password — copy this, you'll need it for the Web Connector

  5. Open the QuickBooks Web Connector on your computer (it should already be installed with QuickBooks Desktop)

  6. In the Web Connector, add the .qwc file you downloaded

  7. When prompted, paste the password from the setup flow and press enter. Make sure to save the password.

  8. Click Test Connection to verify everything is working

Tip: If you have a popup blocker enabled, the setup window may not open automatically. Use the direct connection link provided by our support team if this happens.

How Syncing Works

Syncing invoices

When you click Sync in Nickel (or the Web Connector runs its scheduled sync), your invoices from QBD will appear in Nickel. You can then:

  • Send payment requests to your customers through Nickel

  • Pick and choose which invoices to email out — it's not automatic

  • When a customer pays through Nickel, the payment syncs back to QBD

Invoice PDFs

Nickel generates its own PDF version of your invoices based on the line items, sales tax, and customer details pulled from QBD. These PDFs won't be an exact 1:1 copy of your QBD invoice template, but they include all the essential details your customers need.

To generate PDFs, click Sync Invoice on an individual invoice, or click Sync on the table to generate them for all invoices at once. The PDF automatically refreshes anytime a sync happens.

Multiple Company Files

If you manage multiple companies in QuickBooks Desktop:

  • Each company file needs its own connection in the Web Connector

  • Only the company file that is currently logged in and open will have an active sync

  • You may need a multi-organization account in Nickel — each QBD company file connects to its own Nickel organization

Switching from QuickBooks Online to Desktop

If you're currently connected to QuickBooks Online and want to switch to Desktop:

  • You'll need a fresh Nickel organization to avoid duplicate invoices, bills, customers, and vendors from your QBO connection

  • Our team can set up a multi-organization account and archive your QBO organization

  • Contact support and we'll walk you through the migration

Common Issues & Troubleshooting

"No live connection" or sync not working

  • Make sure the QuickBooks Web Connector is running

  • Make sure your company file is open in QuickBooks Desktop

  • Close any popups or dialog boxes in QuickBooks Desktop — these block syncs

  • Check that there are no other instances of the Web Connector running

Password issues during setup

The password is shown during the connection flow in your browser — it's not your Nickel login password. Look for a password displayed on-screen during setup (it will look something like a random alphanumeric string). Paste it into the Web Connector's password field and press Enter.

QBWC1039 error ("Unique OwnerID/FileID pair required")

This happens when a connection was deleted prematurely. You'll need to clean up the Web Connector registry entries. Our support team can provide the specific steps, or you can reference the Conductor troubleshooting guide.

Restoring a backup company file

If you restored a backup company file:

  • If it's the same company file (just an older version), the existing connection should still work — try re-establishing the Web Connector sync

  • If it's a completely new company file, you may need to set up a new Nickel organization. The invoices, customers, and vendors in the new file will have different internal IDs, which can't be reconciled with the old data

  • Contact support — we can help you determine the best path forward

Invoices not updating / paid invoices still showing unpaid

  • This is usually a sync timing issue — click Sync in Nickel to pull the latest data

  • Make sure the Web Connector has an active connection (company file open, no popups)

  • If you paid an invoice outside of Nickel, the payment status in Nickel updates on the next sync

Setting Up Notifications

Notifications in Nickel are assigned by role, not by maintaining a list of email addresses. Putting someone in a role opts them into everything that role receives.

  1. Go to Settings → Notifications.

  2. On the Team Notifications tab, tick the notifications you want each role to receive. The columns are Admin, Manager, Member and Customer.

  3. o change only what you receive, use the Your Notifications tab.

For the full walkthrough, including external users and custom roles, see How to Manage Your Team, Roles, Permissions, and Notifications.

Where Customer Replies Go

If a customer replies to a payment request email, the reply goes to the address you have set for that email, not to a generic Nickel address.

  1. Go to Settings → Notifications.

  2. Select Settings in the top right.

  3. Scroll to Customer replies.

  4. Set the reply-to address for each customer-facing email, such as the payment receipt or a failed payment notice.

Tip: To CC a single address on everything that goes to customers, turn on Default Invoice Contact for Customers in the same panel. That address is CC'd in addition to your role-based settings, not instead of them.

What's Coming Next

We're actively improving the QuickBooks Desktop integration. Upcoming improvements include:

  • Better sync status indicators so you can easily see if your connection is live

  • More granular sync options (so you don't have to wait for a full sync)

  • "Last synced" timestamps on invoices

  • Manual sync for individual transactions

Need Help?

If you have questions, please chat with our team via the Help Center when you login to the platform.

Did this answer your question?