Skip to content

Commit 526dd4f

Browse files
stephanieelliottstephanieelliott
committed
Add QuickBooks Online troubleshooting docs (New Expensify)
- Root: Configure, Connect, Troubleshooting. - Troubleshooting: Auth, Connection, Export, Sync errors, FAQ. - Hub pages already exist on main. Part of Integration Errors Revamp (splitting PR #83106).
1 parent 26ccc41 commit 526dd4f

35 files changed

Lines changed: 3050 additions & 0 deletions

‎docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Authentication-and-Login-errors/ONL193-Sync-Error.md‎

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
title: ONL193 Sync Error in QuickBooks Online
3+
description: Learn how to fix the ONL193 sync error in QuickBooks Online by reconnecting your admin credentials and refreshing your Workspace connection.
4+
keywords: ONL193, QuickBooks Online sync error, couldn’t connect to QuickBooks Online, reenter admin credentials, reconnect QuickBooks Online, Sync now, Expensify QuickBooks Online connection error, Workspace Admin, accounting sync error
5+
internalScope: Audience is Workspace Admins using QuickBooks Online integration. Covers fixing the ONL193 sync error caused by expired or changed admin credentials. Does not cover other sync or export error codes.
6+
---
7+
8+
# ONL193 Sync Error in QuickBooks Online
9+
10+
If you see the error:
11+
12+
ONL193: Couldn’t connect to QuickBooks Online. Please reenter your admin login credentials.
13+
14+
This means the QuickBooks Online credentials used to establish the connection have changed or expired.
15+
16+
---
17+
18+
## Why the ONL193 Sync Error Happens in QuickBooks Online
19+
20+
The ONL193 error occurs when:
21+
22+
- The QuickBooks Online admin password was changed.
23+
- The admin user was removed or modified in QuickBooks Online.
24+
- The connection authorization expired.
25+
- Multi-factor authentication or security settings were updated.
26+
27+
When credentials change, Expensify can no longer sync until the connection is reauthorized.
28+
29+
---
30+
31+
## How to Reconnect QuickBooks Online in Expensify
32+
33+
### On Web
34+
35+
1. Go to the **Workspaces** navigation tab on the left.
36+
2. Select your Workspace.
37+
3. Click **Accounting**.
38+
4. Click the **three-dot icon** next to the QuickBooks Online connection.
39+
5. Select **Sync now**.
40+
6. In the pop-up window, click **Reconnect**.
41+
7. Enter the QuickBooks Online admin credentials.
42+
8. Complete the authorization process.
43+
44+
### On Mobile
45+
46+
1. Tap the **Workspaces** navigation tab on the bottom.
47+
2. Select your Workspace.
48+
3. Tap **Accounting**.
49+
4. Tap the **three-dot icon** next to the QuickBooks Online connection.
50+
5. Tap **Sync now**.
51+
6. Tap **Reconnect**.
52+
7. Enter the QuickBooks Online admin credentials.
53+
8. Complete the authorization process.
54+
55+
If you are using new credentials, you may need to reconfigure your accounting settings and reselect categories or tags.
56+
57+
Tip: Before reconnecting, consider taking a screenshot of your current accounting configuration so you can easily restore settings if needed.
58+
59+
---
60+
61+
# FAQ
62+
63+
## Do I Need to Disconnect the Integration First?
64+
65+
No. Using **Reconnect** during the sync process reauthorizes the connection without fully disconnecting the integration.
66+
67+
## Will Reconnecting Remove My Settings?
68+
69+
In some cases, you may need to reconfigure export settings or reselect categories and tags after reconnecting. Taking note of your current configuration beforehand can help streamline the process.

‎docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Connection-errors/ONL046-Sync-Error.md‎

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
title: ONL046 Sync Error in QuickBooks Online
3+
description: Learn how to fix the ONL046 sync error in QuickBooks Online when your subscription plan does not support certain features.
4+
keywords: ONL046, QuickBooks Online subscription error, feature not included QuickBooks plan, upgrade QuickBooks version, QuickBooks Online plan comparison, Expensify QuickBooks Online sync error, Workspace Admin, accounting sync error
5+
internalScope: Audience is Workspace Admins using QuickBooks Online integration. Covers fixing the ONL046 sync error caused by unsupported QuickBooks Online subscription features. Does not cover other sync or export error codes.
6+
---
7+
8+
# ONL046 Sync Error in QuickBooks Online
9+
10+
If you see the error:
11+
12+
ONL046: Feature not included in QuickBooks Online subscription. Please upgrade QuickBooks version.
13+
14+
This means your QuickBooks Online subscription plan does not support a feature currently being used in Expensify.
15+
16+
---
17+
18+
## Why the ONL046 Sync Error Happens in QuickBooks Online
19+
20+
The ONL046 error occurs when:
21+
22+
- A feature enabled in Expensify is not supported by your QuickBooks Online subscription plan.
23+
- Your QuickBooks Online version does not include functionality such as Classes, Locations, Projects, or Vendor Bills.
24+
25+
Note: QuickBooks Self-Employed is not supported.
26+
27+
---
28+
29+
## How to Fix the ONL046 Sync Error
30+
31+
1. Log in to QuickBooks Online.
32+
2. Confirm your current subscription plan.
33+
3. Review which features are supported by your plan.
34+
4. Upgrade your QuickBooks Online subscription if needed to support the feature you are using in Expensify.
35+
36+
Refer to the table below for supported features by plan.
37+
38+
---
39+
40+
## QuickBooks Online Feature Support by Plan
41+
42+
| Feature | Simple Start | Essentials | Essentials Plus |
43+
|------------------------------|--------------|------------|------------------|
44+
| GL Accounts as Categories | Yes | Yes | Yes |
45+
| Classes | No | No | Yes |
46+
| Locations | No | No | Yes |
47+
| Customers | No | No | Yes |
48+
| Projects | No | No | Yes |
49+
| Vendor Bills | No | Yes | Yes |
50+
| Expense Reports | Yes | Yes | Yes |
51+
| Journal Entries | Yes | Yes | Yes |
52+
| Credit Card Transactions | Yes | Yes | Yes |
53+
| Debit Card Transactions | Yes | Yes | Yes |
54+
| Tax | Yes | Yes | Yes |
55+
| Billable | No | No | Yes |
56+
57+
If you are attempting to use a feature marked “No” under your plan, you must upgrade your QuickBooks Online subscription to resolve the sync error.
58+
59+
---
60+
61+
# FAQ
62+
63+
## Is QuickBooks Self-Employed Supported?
64+
65+
No. QuickBooks Self-Employed is not supported with the Expensify QuickBooks Online integration.
66+
67+
## Do I Need to Reconnect After Upgrading My Plan?
68+
69+
After upgrading your QuickBooks Online subscription, run **Sync now** in Expensify to refresh available features and retry your export or sync.

‎docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Connection-errors/ONL224-Sync-Error.md‎

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: ONL224 Sync Error in QuickBooks Online
3+
description: Learn how to fix the ONL224 sync error in QuickBooks Online when the user is not listed as an admin for the company.
4+
keywords: ONL224, QuickBooks Online admin error, not listed as admin QuickBooks, connect Expensify workspace to QuickBooks, QuickBooks Online admin access required, Expensify QuickBooks Online sync error, Workspace Admin, accounting sync error
5+
internalScope: Audience is Workspace Admins connecting QuickBooks Online to Expensify. Covers fixing the ONL224 sync error caused by insufficient admin permissions. Does not cover other sync or export error codes.
6+
---
7+
8+
# ONL224 Sync Error in QuickBooks Online
9+
10+
If you see the error:
11+
12+
ONL224: You’re not listed as an admin for this company. To connect an Expensify workspace to QuickBooks Online, please log in as a QuickBooks admin.
13+
14+
This means the QuickBooks Online user attempting to connect the integration does not have admin permissions.
15+
16+
---
17+
18+
## Why the ONL224 Sync Error Happens in QuickBooks Online
19+
20+
The ONL224 error occurs because:
21+
22+
- Only QuickBooks Online admins can authorize and connect an integration.
23+
- The user attempting to connect QuickBooks Online to Expensify is not listed as a company admin.
24+
- The QuickBooks Online account does not have sufficient permissions to grant third-party access.
25+
26+
Without admin access, the connection cannot be completed.
27+
28+
---
29+
30+
## How to Confirm Admin Access in QuickBooks Online
31+
32+
1. Log in to QuickBooks Online.
33+
2. Go to **Settings**.
34+
3. Select **Manage users** or **User preferences**.
35+
4. Confirm whether the user is listed as an **Admin**.
36+
37+
If the user is not listed as an admin, the integration cannot be authorized.
38+
39+
---
40+
41+
## How to Fix the ONL224 Sync Error
42+
43+
You have two options:
44+
45+
### Option One: Request Admin Access
46+
47+
- Ask a current QuickBooks Online company admin to grant you admin permissions.
48+
- Once admin access is granted, reconnect the integration in Expensify.
49+
50+
### Option Two: Have a QuickBooks Admin Connect the Integration
51+
52+
- Ask an existing QuickBooks Online admin to log in.
53+
- Have them connect QuickBooks Online to the Expensify Workspace.
54+
55+
### How to Reconnect QuickBooks Online in Expensify
56+
57+
#### On Web
58+
59+
1. Go to the **Workspaces** navigation tab on the left.
60+
2. Select your Workspace.
61+
3. Click **Accounting**.
62+
4. Click **Connect to QuickBooks Online** or reconnect the existing connection.
63+
5. Log in using a QuickBooks Online admin account.
64+
65+
#### On Mobile
66+
67+
1. Tap the **Workspaces** navigation tab on the bottom.
68+
2. Select your Workspace.
69+
3. Tap **Accounting**.
70+
4. Tap **Connect to QuickBooks Online** or reconnect the existing connection.
71+
5. Log in using a QuickBooks Online admin account.
72+
73+
Once connected by a QuickBooks Online admin, the integration should complete successfully.
74+
75+
---
76+
77+
# FAQ
78+
79+
## Can a Standard User Connect QuickBooks Online to Expensify?
80+
81+
No. Only a QuickBooks Online company admin can authorize and connect the integration.
82+
83+
## Do I Need to Be a Workspace Admin in Expensify?
84+
85+
Yes. You must also have the appropriate permissions in Expensify (typically Workspace Admin) to manage accounting connections.

‎docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL022-Export-Error.md‎

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
---
2+
title: ONL022 Export Error in QuickBooks Online
3+
description: Learn how to fix the ONL022 export error in QuickBooks Online by marking the correct account as billable and syncing your Workspace in Expensify.
4+
keywords: ONL022, QuickBooks Online error, export billable expenses, mark account as billable, QuickBooks Online billable setting, Expensify QuickBooks Online sync, Sync now, Workspace Admin, accounting export error
5+
internalScope: Audience is Workspace Admins using QuickBooks Online integration. Covers fixing the ONL022 export error caused by non-billable accounts. Does not cover other export error codes.
6+
---
7+
8+
# ONL022 Export Error in QuickBooks Online
9+
10+
If you see the error:
11+
12+
ONL022: To export billable expenses, ensure the account in QuickBooks Online is marked as billable.
13+
14+
This means the account category used on an expense in Expensify is not marked as billable in QuickBooks Online.
15+
16+
---
17+
18+
## Why the ONL022 Export Error Happens in QuickBooks Online
19+
20+
The ONL022 error appears when:
21+
22+
- An expense in Expensify is coded to an account.
23+
- That account in QuickBooks Online is not enabled for billable expenses.
24+
- You attempt to export the report to QuickBooks Online.
25+
26+
QuickBooks Online requires accounts tied to billable expenses to be marked as billable and linked to an income account.
27+
28+
---
29+
30+
## How to Enable Billable Expenses in QuickBooks Online
31+
32+
First, confirm that billable expenses are enabled in QuickBooks Online.
33+
34+
1. In QuickBooks Online, click the Gear icon in the upper-right corner.
35+
2. Select Account and Settings.
36+
3. Click Expenses.
37+
4. Turn on Make expenses and items billable.
38+
5. Click Save, then Done.
39+
40+
If this setting is already enabled, move to the next section.
41+
42+
---
43+
44+
## How to Mark an Account as Billable in QuickBooks Online
45+
46+
After enabling billable expenses, make sure the specific account used in Expensify is set up correctly.
47+
48+
1. In QuickBooks Online, go to Chart of Accounts.
49+
2. Find the account used on the expense.
50+
3. Click Edit.
51+
4. Ensure the account supports billable expenses.
52+
5. Select the appropriate Income account for billable tracking.
53+
6. Click Save.
54+
55+
Once updated, return to Expensify to resync.
56+
57+
---
58+
59+
## How to Sync QuickBooks Online in Expensify
60+
61+
After updating settings in QuickBooks Online, resync your connection in Expensify.
62+
63+
### On Web
64+
65+
1. Go to the Workspaces navigation tab on the left.
66+
2. Select your Workspace.
67+
3. Click Accounting.
68+
4. Click the three-dot icon next to the QuickBooks Online connection.
69+
5. Select Sync now.
70+
71+
### On Mobile
72+
73+
1. Tap the Workspaces navigation tab on the bottom.
74+
2. Select your Workspace.
75+
3. Tap Accounting.
76+
4. Tap the three-dot icon next to the QuickBooks Online connection.
77+
5. Tap Sync now.
78+
79+
After the sync completes, try exporting the report again.
80+
81+
---
82+
83+
## How to Re-Export a Report to QuickBooks Online After Fixing ONL022
84+
85+
1. Open the report that previously failed.
86+
2. Click Export to QuickBooks Online.
87+
3. Confirm the export.
88+
89+
If the account is now correctly marked as billable in QuickBooks Online, the export should succeed.
90+
91+
---
92+
93+
# FAQ
94+
95+
## Does the ONL022 Export Error Affect All Expenses?
96+
97+
No. The ONL022 error only affects expenses coded to accounts that are not enabled for billable expenses in QuickBooks Online.
98+
99+
## Do I Need to Reconnect QuickBooks Online to Fix ONL022?
100+
101+
No. In most cases, you only need to:
102+
103+
- Update the account settings in QuickBooks Online.
104+
- Run Sync now in Expensify.
105+
106+
You do not need to disconnect and reconnect the integration.

0 commit comments

Comments
 (0)