Skip to content

Commit b6ffef7

Browse files
stephanieelliottstephanieelliott
authored
Merge pull request #84817 from Expensify/helpsite-quickbooks-online-expensify-classic
[No QA] Add QuickBooks Online troubleshooting docs (Expensify Classic)
2 parents e6870ff + 7837b35 commit b6ffef7

35 files changed

Lines changed: 2800 additions & 0 deletions

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

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: ONL193 Sync Error in QuickBooks Online Integration
3+
description: Learn what the ONL193 sync error means in QuickBooks Online and how to reconnect using updated admin credentials.
4+
keywords: ONL193, QuickBooks Online sync error, couldn’t connect to QuickBooks Online, reconnect QuickBooks Online, reenter admin credentials, Expensify QuickBooks Online integration, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL193 sync error caused by invalid or expired QuickBooks Online credentials. Does not cover other QuickBooks Online error codes.
6+
---
7+
8+
# ONL193 Sync Error in QuickBooks Online Integration
9+
10+
If you see the error:
11+
12+
ONL193: Couldn’t connect to QuickBooks Online.
13+
14+
This means the QuickBooks Online credentials used to establish the connection are no longer valid, preventing syncing and exports from completing.
15+
16+
---
17+
18+
## Why the ONL193 Sync Error Happens in QuickBooks Online
19+
20+
The ONL193 error typically indicates:
21+
22+
- The QuickBooks Online admin password was changed.
23+
- The QuickBooks Online admin user was removed or updated.
24+
- The authentication token expired.
25+
- A different admin account replaced the original connection account.
26+
27+
When this happens, Expensify can no longer authenticate with QuickBooks Online and requires reconnection.
28+
29+
This is a QuickBooks Online credential issue, not a Workspace configuration issue.
30+
31+
---
32+
33+
## How to Fix the ONL193 Sync Error
34+
35+
This issue must be resolved by reconnecting QuickBooks Online.
36+
37+
1. Go to **Settings > Workspaces**.
38+
2. Select your Workspace.
39+
3. Click **Accounting**.
40+
4. Click **Sync Now**.
41+
5. Select **Reconnect**.
42+
6. Enter your QuickBooks Online admin credentials.
43+
44+
If reconnecting with new credentials, you may need to reconfigure export settings, accounts, categories, or tags.
45+
46+
After reconnecting, run **Sync Now** again and confirm the sync completes successfully.
47+
48+
---
49+
50+
# FAQ
51+
52+
## Can I Retry the Sync?
53+
54+
Yes. After reconnecting with valid admin credentials, retry the sync. If the error persists, confirm you are using an active QuickBooks Online Admin account.
55+
56+
## Does ONL193 Mean My Reports Were Deleted?
57+
58+
No. Your reports remain in Expensify. The sync failed due to invalid or expired QuickBooks Online credentials.
59+
60+
## Do I Need to Disconnect First?
61+
62+
No. Selecting **Reconnect** from the Sync window is typically sufficient.

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

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
title: ONL046 Sync Error in QuickBooks Online Integration
3+
description: Learn what the ONL046 sync error means in QuickBooks Online and how to upgrade your subscription or adjust export settings to restore successful syncing.
4+
keywords: ONL046, QuickBooks Online subscription error, feature not included QuickBooks, upgrade QuickBooks Online plan, QuickBooks Simple Start limitations, Expensify QuickBooks Online integration, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL046 sync error caused by QuickBooks Online subscription limitations. Does not cover QuickBooks Desktop or other QuickBooks error codes.
6+
---
7+
8+
# ONL046 Sync Error in QuickBooks Online Integration
9+
10+
If you see the error:
11+
12+
ONL046: Feature not included in QuickBooks Online subscription.
13+
14+
This means your QuickBooks Online subscription does not support one or more features selected in your export settings, preventing the sync from completing.
15+
16+
---
17+
18+
## Why the ONL046 Sync Error Happens in QuickBooks Online
19+
20+
The ONL046 error typically indicates:
21+
22+
- Your QuickBooks Online plan does not include a required feature.
23+
- Your Workspace is configured to use a feature unsupported by your subscription.
24+
- QuickBooks Online blocked the sync due to subscription limitations.
25+
26+
Each QuickBooks Online plan supports different accounting features. If a selected feature is unavailable in your plan, the sync fails.
27+
28+
Note: QuickBooks Self-Employed is not supported with Expensify.
29+
30+
---
31+
32+
## How to Fix the ONL046 Sync Error
33+
34+
You can resolve this by upgrading your subscription or adjusting your export settings.
35+
36+
1. Log in to QuickBooks Online.
37+
2. Confirm your current subscription plan.
38+
3. Review which features are supported by your plan.
39+
4. Either:
40+
- Upgrade your QuickBooks Online subscription, or
41+
- Adjust your export settings to remove unsupported features.
42+
43+
Then:
44+
45+
1. Go to **Settings > Workspaces**.
46+
2. Select your Workspace.
47+
3. Click **Accounting**.
48+
4. Click **Sync Now**.
49+
50+
Confirm the sync completes successfully.
51+
52+
---
53+
54+
## QuickBooks Online Feature Support by Plan
55+
56+
| Feature | Simple Start | Essentials | Plus |
57+
|--------------------------|--------------|------------|------|
58+
| GL Accounts as Categories| Yes | Yes | Yes |
59+
| Classes | No | No | Yes |
60+
| Locations | No | No | Yes |
61+
| Customers | No | No | Yes |
62+
| Projects | No | No | Yes |
63+
| Vendor Bills | No | Yes | Yes |
64+
| Expense Reports | Yes | Yes | Yes |
65+
| Journal Entries | Yes | Yes | Yes |
66+
| Credit Card Transactions | Yes | Yes | Yes |
67+
| Debit Card Transactions | Yes | Yes | Yes |
68+
| Tax | Yes | Yes | Yes |
69+
| Billable | No | No | Yes |
70+
71+
If you are using features such as Classes, Locations, Projects, or Billable, you must be on the QuickBooks Online Plus plan.
72+
73+
---
74+
75+
# FAQ
76+
77+
## Can I Retry the Sync?
78+
79+
Yes. After upgrading your subscription or adjusting export settings, select **Sync Now** and retry the sync.
80+
81+
## Does ONL046 Mean the Connection Is Broken?
82+
83+
No. The connection is active, but your subscription does not support a selected feature.
84+
85+
## Do I Need to Reconnect QuickBooks Online?
86+
87+
No. You only need to upgrade your QuickBooks Online subscription or adjust your export settings to use supported features.

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

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
title: ONL224 Sync Error in QuickBooks Online Integration
3+
description: Learn what the ONL224 sync error means in QuickBooks Online and how to ensure admin access before reconnecting the integration.
4+
keywords: ONL224, QuickBooks Online admin required, not listed as admin QuickBooks, connect QuickBooks Online Expensify, QuickBooks Online permissions error, Workspace Admin
5+
internalScope: Audience is Workspace Admins connecting QuickBooks Online to Expensify. Covers resolving the ONL224 sync error caused by missing QuickBooks Online admin access. Does not cover other QuickBooks Online error codes.
6+
---
7+
8+
# ONL224 Sync Error in QuickBooks Online Integration
9+
10+
If you see the error:
11+
12+
ONL224: You’re not listed as an admin for this company.
13+
14+
This means the QuickBooks Online user attempting to connect the integration does not have Admin access, preventing the connection from completing.
15+
16+
---
17+
18+
## Why the ONL224 Sync Error Happens in QuickBooks Online
19+
20+
The ONL224 error typically indicates:
21+
22+
- The user attempting to connect is not a QuickBooks Online Company Admin.
23+
- QuickBooks Online restricts third-party integrations to Admin users.
24+
- The connection attempt failed due to insufficient permissions.
25+
26+
Only QuickBooks Online Admin users can connect a QuickBooks account to a Workspace.
27+
28+
This is a QuickBooks Online permission issue, not a Workspace configuration issue.
29+
30+
---
31+
32+
## How to Fix the ONL224 Sync Error
33+
34+
This issue must be resolved in QuickBooks Online.
35+
36+
1. Log in to QuickBooks Online.
37+
2. Go to the user management section.
38+
3. Confirm whether your account is listed as a **Company Admin**.
39+
4. If not, request Admin access from an existing Company Admin, or
40+
5. Ask a Company Admin to connect QuickBooks Online to the Workspace.
41+
42+
After confirming Admin access:
43+
44+
1. Go to **Settings > Workspaces**.
45+
2. Select your Workspace.
46+
3. Click **Accounting**.
47+
4. Reconnect QuickBooks Online.
48+
5. Click **Sync Now** to confirm the integration works properly.
49+
50+
---
51+
52+
# FAQ
53+
54+
## Can a Standard QuickBooks User Connect the Integration?
55+
56+
No. Only QuickBooks Online Company Admin users can connect QuickBooks Online to a Workspace.
57+
58+
## Does ONL224 Mean the Connection Is Broken?
59+
60+
Not necessarily. It means the current user does not have sufficient QuickBooks permissions to establish or reconnect the integration.
61+
62+
## Do I Need to Disconnect First?
63+
64+
No. You can reconnect directly using a QuickBooks Online Admin account.

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

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
---
2+
title: ONL022 Export Error in QuickBooks Online Integration
3+
description: Learn what the ONL022 export error means in QuickBooks Online and how to enable billable settings for the selected account to restore successful exports.
4+
keywords: ONL022, QuickBooks Online export error, account must be marked as billable, enable billable QuickBooks Online, billable expense export error, Expensify QuickBooks Online integration, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL022 export error caused by billable account configuration settings. Does not cover other QuickBooks Online error codes.
6+
---
7+
8+
# ONL022 Export Error in QuickBooks Online Integration
9+
10+
If you see the error:
11+
12+
ONL022: Account must be marked as billable in QuickBooks Online.
13+
14+
This means the account category applied to an expense is not configured to support billable expenses in QuickBooks Online, preventing the export from completing.
15+
16+
---
17+
18+
## Why the ONL022 Export Error Happens in QuickBooks Online
19+
20+
The ONL022 error typically indicates:
21+
22+
- Billable functionality is not enabled in QuickBooks Online.
23+
- The selected account in the Chart of Accounts does not support billable expenses.
24+
- QuickBooks Online validation failed due to incorrect billable configuration.
25+
26+
When exporting billable expenses, QuickBooks Online requires both company-level billable settings and account-level configuration to be enabled.
27+
28+
This is a QuickBooks Online configuration issue, not a Workspace configuration issue.
29+
30+
---
31+
32+
## How to Fix the ONL022 Export Error
33+
34+
This issue must be resolved in QuickBooks Online.
35+
36+
### Enable Billable Expenses
37+
38+
1. Log in to QuickBooks Online.
39+
2. Select the **Gear icon**.
40+
3. Go to **Account and Settings**.
41+
4. Select the **Expenses** tab.
42+
5. Enable **Make expenses and items billable**.
43+
6. Save your changes.
44+
45+
### Update the Account in the Chart of Accounts
46+
47+
1. Go to the **Chart of Accounts**.
48+
2. Locate the account used for the expense category.
49+
3. Select **Edit**.
50+
4. Ensure the account supports billable expenses.
51+
5. Select the appropriate **Income account** if required.
52+
6. Save your changes.
53+
54+
After updating QuickBooks Online:
55+
56+
1. Go to **Settings > Workspaces**.
57+
2. Select your Workspace.
58+
3. Click **Accounting**.
59+
4. Click **Sync Now**.
60+
61+
Then retry exporting the report.
62+
63+
---
64+
65+
# FAQ
66+
67+
## Can I Retry the Export?
68+
69+
Yes. After enabling billable functionality and selecting **Sync Now**, retry the export. If the error persists, confirm the correct account is configured.
70+
71+
## Does ONL022 Mean My Plan Does Not Support Billable?
72+
73+
Not necessarily. It usually means billable settings are not enabled or the account is not configured correctly.
74+
75+
## Is ONL022 Caused by Workspace Settings?
76+
77+
No. ONL022 is triggered by billable configuration settings in QuickBooks Online. Workspace accounting settings are not the cause.

‎docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL038-Export-Error.md‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: ONL038 Export Error in QuickBooks Online Integration
3+
description: Learn what the ONL038 export error means in QuickBooks Online and how to change the export type to resolve tax rounding issues.
4+
keywords: ONL038, QuickBooks Online export error, tax calculation error QuickBooks, export as vendor bill QuickBooks, rounding issues tax QuickBooks Online, Expensify QuickBooks Online integration, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL038 export error caused by tax rounding issues when exporting as a Journal Entry. Does not cover other QuickBooks Online error codes.
6+
---
7+
8+
# ONL038 Export Error in QuickBooks Online Integration
9+
10+
If you see the error:
11+
12+
ONL038: Tax calculation error.
13+
14+
This means QuickBooks Online encountered rounding differences when tax was exported as a Journal Entry, preventing the export from completing.
15+
16+
---
17+
18+
## Why the ONL038 Export Error Happens in QuickBooks Online
19+
20+
The ONL038 error typically indicates:
21+
22+
- Tax amounts are being exported as a Journal Entry.
23+
- QuickBooks Online applies different tax rounding rules.
24+
- Rounding differences caused validation to fail.
25+
26+
When exporting tax as a Journal Entry, QuickBooks may calculate tax differently than Expensify. These rounding differences can trigger export errors.
27+
28+
Exporting as a Vendor Bill allows QuickBooks Online to handle tax calculations internally, reducing rounding conflicts.
29+
30+
This is a QuickBooks Online tax handling limitation, not a Workspace calculation issue.
31+
32+
---
33+
34+
## How to Fix the ONL038 Export Error
35+
36+
This issue can be resolved by changing the export type.
37+
38+
1. Go to **Settings > Workspaces**.
39+
2. Select your Workspace.
40+
3. Click **Accounting**.
41+
4. Click **Configure**.
42+
5. Open the **Export** tab.
43+
6. Under **Reimbursable expenses**, select **Vendor Bill**.
44+
7. Click **Save**.
45+
46+
After updating the export type, retry exporting the report.
47+
48+
---
49+
50+
# FAQ
51+
52+
## Can I Retry the Export?
53+
54+
Yes. After changing the export type to **Vendor Bill**, retry the export. If the error persists, confirm the updated setting was saved.
55+
56+
## Does ONL038 Mean Tax Is Calculated Incorrectly?
57+
58+
No. The issue relates to how QuickBooks Online applies tax rounding when exporting as a Journal Entry.
59+
60+
## Do I Need to Reconnect QuickBooks Online?
61+
62+
No. Updating the export type and retrying the export is typically sufficient.

0 commit comments

Comments
 (0)