Skip to content

Commit 5be029a

Browse files
maddylewismaddylewis
authored
Update QuickBooks-Desktop-Troubleshooting.md
1 parent 60d242d commit 5be029a

1 file changed

Lines changed: 67 additions & 73 deletions

File tree

‎docs/articles/new-expensify/connections/quickbooks-desktop/QuickBooks-Desktop-Troubleshooting.md‎

Lines changed: 67 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -1,125 +1,119 @@
11
---
2-
title: QuickBooks Desktop troubleshooting
2+
title: QuickBooks Desktop Troubleshooting
33
description: Resolve common QuickBooks Desktop integration issues with Expensify, including Web Connector, authentication, import, and export errors.
4+
keywords: [New Expensify, QuickBooks Desktop, Web Connector, export error, sync issues, import missing categories, authentication issues]
45
order: 3
56
---
67

7-
This article provides step-by-step solutions for common QuickBooks Desktop issues encountered when syncing with Expensify. Follow these troubleshooting steps to quickly address and resolve connectivity, authentication, import, and export problems.
8+
<div id="expensify-classic" markdown="1">
89

9-
---
10-
11-
# The Web Connector cannot be reached
12-
13-
These errors usually indicate a connection issue between Expensify and QuickBooks.
10+
This guide provides step-by-step solutions for the most common issues, including Web Connector errors, authentication problems, and data import/export failures.
1411

15-
## How to resolve
16-
17-
1. Ensure QuickBooks Desktop and the Web Connector are running.
18-
2. Install the Web Connector in the same location as QuickBooks (local desktop or remote server).
12+
---
1913

20-
If the error persists:
14+
# Web Connector cannot be reached
2115

22-
1. Completely close the Web Connector (use Task Manager if needed).
23-
2. Right-click the Web Connector icon and select **Run as administrator**.
24-
3. Sync your Expensify workspace again.
16+
If you're seeing connection errors, it's likely due to an issue between QuickBooks and the Web Connector.
2517

26-
If issues continue:
18+
## Steps to Fix
2719

28-
1. Quit and reopen QuickBooks Desktop.
29-
2. In Expensify, go to **Settings > Workspaces**.
30-
3. Select your workspace connected to QuickBooks Desktop.
31-
4. Click **Accounting**.
32-
5. Click the three vertical dots next to **QuickBooks Desktop**.
33-
6. Click **Sync now**.
34-
7. If unresolved, reinstall the Web Connector using the provided link.
20+
1. Make sure both QuickBooks Desktop and the Web Connector are running.
21+
2. Confirm that the Web Connector is installed in the same environment as QuickBooks (either local desktop or remote server).
22+
3. If the error persists:
23+
- Close the Web Connector completely (use Task Manager if necessary).
24+
- Right-click the Web Connector and choose **Run as administrator**.
25+
- Try syncing your Expensify workspace again.
26+
4. Still not working?
27+
- Quit and reopen QuickBooks Desktop.
28+
- From the left-hand menu, go to **Workspaces > [Workspace Name] > Accounting**.
29+
- Click the three dots next to **QuickBooks Desktop**, then select **Sync now**.
30+
- If none of the above works, reinstall the Web Connector using the official link from QuickBooks.
3531

3632
---
3733

3834
# Connection or authentication issues
3935

40-
These errors usually indicate a credential issue.
36+
These typically occur when QuickBooks can't authenticate the Web Connector or Expensify.
4137

42-
## How to resolve
38+
## Steps to Fix
4339

44-
1. Ensure QuickBooks Desktop is open with the correct company file.
45-
2. Ensure the QuickBooks Web Connector is open and online.
46-
3. Close any open dialogue boxes in QuickBooks Desktop and retry syncing or exporting.
47-
4. Check permissions: log in to QuickBooks Desktop as Admin (single-user mode).
40+
1. Open QuickBooks Desktop with the correct company file.
41+
2. Make sure the QuickBooks Web Connector is online.
42+
3. Close any open dialog boxes in QuickBooks and try syncing again.
43+
4. Log in as Admin in single-user mode.
4844
5. Go to **Edit > Preferences > Integrated Applications > Company Preferences**.
49-
50-
![Company Preferences](https://help.expensify.com/assets/images/quickbooks-desktop-company-preferences.png){:width="100%"}
51-
52-
6. Select the Web Connector and click **Properties**.
53-
54-
![Web Connector Properties](https://help.expensify.com/assets/images/quickbooks-desktop-access-rights.png){:width="100%"}
55-
56-
7. Check **Allow this application to login automatically** and click **OK**.
45+
6. Select **Web Connector**, then click **Properties**.
46+
7. Enable **Allow this application to login automatically**, then click **OK**.
5747
8. Close all QuickBooks windows.
5848

59-
If unresolved, contact Concierge with:
60-
61-
- QuickBooks Desktop version.
62-
- Location of QuickBooks and company file (local or remote).
63-
- Location of Web Connector (local or remote).
64-
- Provider of remote environment (if applicable, e.g., RightNetworks).
49+
**If issues persist, contact Concierge with the following details:**
50+
- QuickBooks Desktop version
51+
- Location of QuickBooks and company file (local or remote)
52+
- Location of Web Connector
53+
- Name of hosting provider (if remote, e.g., RightNetworks)
6554

6655
---
6756

68-
# Import issues or missing categories/tags
57+
# Import issues or missing categories, or tags
6958

70-
These issues indicate the integration needs updating or QuickBooks version incompatibility.
59+
These issues usually signal that the integration is outdated or not fully compatible.
7160

72-
## How to resolve
61+
## Steps to Fix
7362

74-
1. Re-sync the connection from **Workspace Accounting** settings.
75-
2. Verify configuration in QuickBooks. Expensify imports chart of accounts as categories or export account options, and imports projects, customers, and tags as tags.
63+
1. Re-sync from **Workspaces > [Workspace Name] > Accounting**.
64+
2. Check your QuickBooks configuration:
65+
- Chart of accounts = categories/export accounts
66+
- Projects, customers, and classes = tags in Expensify
7667

77-
If unresolved, contact Concierge with details and QuickBooks screenshots.
68+
If issues persist, contact Concierge support with screenshots of your QuickBooks setup and error details.
7869

7970
---
8071

81-
# Export or "can't find category/class/location/account" issues
72+
# Export errors or missing categories, classes, or accounts
8273

83-
These errors usually generate a system message in Expense Chat indicating the issue.
74+
These errors often show up in Expense Chat during report export.
8475

85-
## How to resolve
76+
## Steps to Fix
8677

87-
1. Re-sync the connection from **Workspace Accounting** settings.
88-
2. Re-apply coding to expenses and re-export reports.
89-
3. Verify your QuickBooks Desktop version supports the selected export option ([check compatibility](https://quickbooks.intuit.com/desktop/)).
78+
1. Re-sync from **Workspaces > [Workspace Name] > Accounting > QuickBooks Desktop**.
79+
2. Re-apply the coding on your expenses and re-export the report.
80+
3. Make sure your QuickBooks Desktop version supports the export feature you’re using ([check compatibility](https://quickbooks.intuit.com/desktop/)).
9081

91-
If unresolved, contact Concierge with Report ID, context, and Expensify error screenshot.
82+
**If issues persist, contact Concierge support with the following details:**
83+
- The Report ID
84+
- Screenshot of the error in Expensify
85+
- Details about the export issue
9286

9387
---
9488

95-
# “Oops!” error when syncing or exporting
89+
# Error: “Oops!” error when syncing or exporting
9690

97-
These errors can often be temporary or false alarms.
91+
This message may appear even if the sync or export worked.
9892

99-
## How to resolve
93+
## Steps to Fix
10094

101-
1. Check if the sync/export was successful.
102-
2. Retry syncing or exporting if unsuccessful.
95+
1. Check whether the action actually succeeded.
96+
2. Retry syncing or exporting if needed.
10397

104-
If persistent, download QuickBooks Desktop logs via Web Connector (**View Logs**) and contact Concierge.
98+
If the error keeps showing:
99+
- Open the Web Connector
100+
- Click **View Log** to download the QuickBooks Desktop logs
101+
- Contact Concierge and share the logs
105102

106-
{% include info.html %}
107-
If using a remote server (e.g., RightNetworks), contact their support for logs.
108-
{% include end-info.html %}
103+
**Note:** If you're using a remote server (e.g., RightNetworks), contact their support for help retrieving logs.
109104

110105
---
111106

112107
# Reports not exporting to QuickBooks Desktop
113108

114-
Usually caused by the Web Connector or QuickBooks company file being closed during export.
115-
116-
## How to resolve
109+
This usually means QuickBooks or the Web Connector was closed during the export attempt.
117110

118-
1. Ensure the Web Connector and QuickBooks Desktop company file are open.
119-
2. In Web Connector, verify **Last Status** is "Ok".
111+
## Steps to Fix
120112

121-
![Web Connector Status](https://help.expensify.com/assets/images/quickbooks-desktop-web-connector.png){:width="100%"}
113+
1. Ensure QuickBooks Desktop and the Web Connector are both open.
114+
2. In Web Connector, confirm the **Last Status** reads “Ok”.
115+
3. Check the associated Expense Chat in Expensify to verify if the export was successful.
122116

123-
3. Check Expense Chat in Expensify to confirm successful export.
117+
Still not exporting? Share the Report ID and a screenshot of your Web Connector with Concierge.
124118

125-
If unresolved, contact Concierge with Expensify Report ID and Web Connector screenshot.
119+
</div>

0 commit comments

Comments
 (0)