QuickBooks Online Integration Setup

🧾 QuickBooks Online (QBO) Integration Setup

Wheelhouse integrates directly with QuickBooks Online (QBO) to streamline your accounting workflows by syncing customers, vendors, items, purchases, invoices, and inventory adjustments. This guide walks you through how to connect your QBO account to Wheelhouse and verify the integration is working properly.

If your Wheelhouse login domain does not end in wheelhousemfg.com, please contact support@wheelhousemfg.com to enable access.
🔍 For a complete list of everything that syncs between Wheelhouse and QBO, see: QBO Integration Overview

🔧 Step 1: Prepare Data

  1. For the Account Terms you use in QuickBooks, create the same Account Terms in Wheelhouse
  2. If you already have Customers or Suppliers in Wheelhouse, ensure the names match those in QBO.

🔧 Step 2: Wheelhouse QBO Settings

Review these key settings in Wheelhouse before switching on the integration.

  1. QuickBooks Debug Mode: Set to false for standard operation.
  2. QuickBooks Environment: Set to production in most situations.
  3. Line Item Settings: Set according to your company's policy.

🔧 Step 3: Connect to QuickBooks

  1. Sign in to QuickBooks Online with an Administrator Account
  2. Navigate to Gear → QuickBooks → QuickBooks Connect.
  3. Click the “Connect to QuickBooks” button.
  4. You’ll be redirected to Intuit’s secure login page. Sign in with your QuickBooks Online credentials and authorize Wheelhouse to connect.
  5. Once approved, you’ll be redirected back to Wheelhouse.

💡 Wheelhouse uses a secure integration token to maintain the connection with QBO — no need to reauthorize unless the token expires or is manually revoked.

✅ Step 4: Confirm the Connection

After completing the login and authorization, you’ll see a “Connected” message at the top of the QuickBooks Integration page in Wheelhouse. This confirms that your account is successfully linked.

You’re now ready to begin syncing data!

Pull terms, customers, suppliers, and items from QBO:

  1. Navigate to the Data Administration list for the specific type in Wheelhouse
  2. Run the "Import from QBO" action from the lightning menu in the upper right-hand corner of the screen.
  3. Review imported planned actions on the records and inspect for any issues.
  4. Rerun the import with the 'view actions' option deselected.

🔧 Step 6: Cleanup Data in Wheelhouse

You may need to adjust some of the imported records.

  • Customers with Parent Organizations in QBO may not sync perfectly. You may need to change the name of the imported parent organization in Wheelhouse. Parent Organizations selected in Wheelhouse will be sent to QBO.
  • The Credit Status of imported customers may need to be set to a default value. To accomplish this, you can use the "Bulk Update Customer Info" action from the lightning menu.
  • Update Territories on Customers.
  • Assign Account Numbers if needed.
If you get a customer save error, it is likely from QBO. A project or unlinked customer with the same name may exist in QBO and Wheelhouse.

🔄 Step 7: Enable Automatic Sync

Set the QuickBooks Events Enabled setting to True to enable automatic synchronization after linking the initial customer, supplier, terms, and item records.

The following data types are synced between Wheelhouse and QBO (see the overview for full details):

  • Customers (edit in Wheelhouse; will update in QBO)
  • Vendors/Suppliers (edit in Wheelhouse; will update in QBO)
  • Items (Inventory & Non-Inventory)
  • Payment Terms
  • Purchase Orders
  • Invoices (with payment status sync)
  • Inventory Adjustments (via journal entries)

🛠 Troubleshooting & Tips

  • If syncing fails, check that:
    • You are still signed into QuickBooks Online.
    • The item, customer, or vendor is properly linked in Wheelhouse.
  • If your token expires or becomes invalid, click “Reconnect to QuickBooks” and follow the sign-in steps again.

Need help? Reach out to support@wheelhousemfg.com.


How did we do?


Powered by HelpDocs (opens in a new tab)