[No QA] Add QuickBooks Online troubleshooting docs (Expensify Classic) #84817
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,62 @@ | ||||||
| --- | ||||||
| title: ONL193 Sync Error in QuickBooks Online Integration | ||||||
| description: Learn what the ONL193 sync error means in QuickBooks Online and how to reconnect using updated admin credentials. | ||||||
| keywords: ONL193, QuickBooks Online sync error, couldn’t connect to QuickBooks Online, reconnect QuickBooks Online, reenter admin credentials, Expensify QuickBooks Online integration, Workspace Admin | ||||||
| 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. | ||||||
| --- | ||||||
|
|
||||||
| # ONL193 Sync Error in QuickBooks Online Integration | ||||||
|
|
||||||
| If you see the error: | ||||||
|
|
||||||
| ONL193: Couldn’t connect to QuickBooks Online. | ||||||
|
Contributor
There was a problem hiding this comment. Readability: The error message text should be formatted as a blockquote or code block to visually distinguish it from the surrounding explanatory text. This improves scannability and helps readers quickly identify the exact error string. For example:
Suggested change
This pattern should be applied consistently across all error articles in this PR. |
||||||
|
|
||||||
| This means the QuickBooks Online credentials used to establish the connection are no longer valid, preventing syncing and exports from completing. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## Why the ONL193 Sync Error Happens in QuickBooks Online | ||||||
|
|
||||||
| The ONL193 error typically indicates: | ||||||
|
|
||||||
| - The QuickBooks Online admin password was changed. | ||||||
| - The QuickBooks Online admin user was removed or updated. | ||||||
| - The authentication token expired. | ||||||
| - A different admin account replaced the original connection account. | ||||||
|
|
||||||
| When this happens, Expensify can no longer authenticate with QuickBooks Online and requires reconnection. | ||||||
|
|
||||||
| This is a QuickBooks Online credential issue, not a Workspace configuration issue. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## How to Fix the ONL193 Sync Error | ||||||
|
|
||||||
| This issue must be resolved by reconnecting QuickBooks Online. | ||||||
|
|
||||||
| 1. Go to **Settings > Workspaces**. | ||||||
| 2. Select your Workspace. | ||||||
| 3. Click **Accounting**. | ||||||
| 4. Click **Sync Now**. | ||||||
| 5. Select **Reconnect**. | ||||||
| 6. Enter your QuickBooks Online admin credentials. | ||||||
|
|
||||||
| If reconnecting with new credentials, you may need to reconfigure export settings, accounts, categories, or tags. | ||||||
|
|
||||||
| After reconnecting, run **Sync Now** again and confirm the sync completes successfully. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| # FAQ | ||||||
|
|
||||||
| ## Can I Retry the Sync? | ||||||
|
|
||||||
| Yes. After reconnecting with valid admin credentials, retry the sync. If the error persists, confirm you are using an active QuickBooks Online Admin account. | ||||||
|
|
||||||
| ## Does ONL193 Mean My Reports Were Deleted? | ||||||
|
|
||||||
| No. Your reports remain in Expensify. The sync failed due to invalid or expired QuickBooks Online credentials. | ||||||
|
|
||||||
| ## Do I Need to Disconnect First? | ||||||
|
|
||||||
| No. Selecting **Reconnect** from the Sync window is typically sufficient. | ||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,87 @@ | ||
| --- | ||
|
Contributor
There was a problem hiding this comment. Readability / structural concern: This file is nearly identical to |
||
| title: ONL046 Sync Error in QuickBooks Online Integration | ||
| 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. | ||
| keywords: ONL046, QuickBooks Online subscription error, feature not included QuickBooks, upgrade QuickBooks Online plan, QuickBooks Simple Start limitations, Expensify QuickBooks Online integration, Workspace Admin | ||
| 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. | ||
| --- | ||
|
|
||
| # ONL046 Sync Error in QuickBooks Online Integration | ||
|
|
||
| If you see the error: | ||
|
|
||
| ONL046: Feature not included in QuickBooks Online subscription. | ||
|
|
||
| This means your QuickBooks Online subscription does not support one or more features selected in your export settings, preventing the sync from completing. | ||
|
|
||
| --- | ||
|
|
||
| ## Why the ONL046 Sync Error Happens in QuickBooks Online | ||
|
|
||
| The ONL046 error typically indicates: | ||
|
|
||
| - Your QuickBooks Online plan does not include a required feature. | ||
| - Your Workspace is configured to use a feature unsupported by your subscription. | ||
| - QuickBooks Online blocked the sync due to subscription limitations. | ||
|
|
||
| Each QuickBooks Online plan supports different accounting features. If a selected feature is unavailable in your plan, the sync fails. | ||
|
|
||
| Note: QuickBooks Self-Employed is not supported with Expensify. | ||
|
|
||
| --- | ||
|
|
||
| ## How to Fix the ONL046 Sync Error | ||
|
|
||
| You can resolve this by upgrading your subscription or adjusting your export settings. | ||
|
|
||
| 1. Log in to QuickBooks Online. | ||
| 2. Confirm your current subscription plan. | ||
| 3. Review which features are supported by your plan. | ||
| 4. Either: | ||
| - Upgrade your QuickBooks Online subscription, or | ||
| - Adjust your export settings to remove unsupported features. | ||
|
|
||
| Then: | ||
|
|
||
| 1. Go to **Settings > Workspaces**. | ||
| 2. Select your Workspace. | ||
| 3. Click **Accounting**. | ||
| 4. Click **Sync Now**. | ||
|
|
||
| Confirm the sync completes successfully. | ||
|
|
||
| --- | ||
|
|
||
| ## QuickBooks Online Feature Support by Plan | ||
|
|
||
| | Feature | Simple Start | Essentials | Plus | | ||
| |--------------------------|--------------|------------|------| | ||
| | GL Accounts as Categories| Yes | Yes | Yes | | ||
| | Classes | No | No | Yes | | ||
| | Locations | No | No | Yes | | ||
| | Customers | No | No | Yes | | ||
| | Projects | No | No | Yes | | ||
| | Vendor Bills | No | Yes | Yes | | ||
| | Expense Reports | Yes | Yes | Yes | | ||
| | Journal Entries | Yes | Yes | Yes | | ||
| | Credit Card Transactions | Yes | Yes | Yes | | ||
| | Debit Card Transactions | Yes | Yes | Yes | | ||
| | Tax | Yes | Yes | Yes | | ||
| | Billable | No | No | Yes | | ||
|
|
||
| If you are using features such as Classes, Locations, Projects, or Billable, you must be on the QuickBooks Online Plus plan. | ||
|
|
||
| --- | ||
|
|
||
| # FAQ | ||
|
|
||
| ## Can I Retry the Sync? | ||
|
|
||
| Yes. After upgrading your subscription or adjusting export settings, select **Sync Now** and retry the sync. | ||
|
|
||
| ## Does ONL046 Mean the Connection Is Broken? | ||
|
|
||
| No. The connection is active, but your subscription does not support a selected feature. | ||
|
|
||
| ## Do I Need to Reconnect QuickBooks Online? | ||
|
|
||
| No. You only need to upgrade your QuickBooks Online subscription or adjust your export settings to use supported features. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,64 @@ | ||
| --- | ||
|
Contributor
There was a problem hiding this comment. Readability / structural concern: This file is nearly identical to |
||
| title: ONL224 Sync Error in QuickBooks Online Integration | ||
| description: Learn what the ONL224 sync error means in QuickBooks Online and how to ensure admin access before reconnecting the integration. | ||
| keywords: ONL224, QuickBooks Online admin required, not listed as admin QuickBooks, connect QuickBooks Online Expensify, QuickBooks Online permissions error, Workspace Admin | ||
| 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. | ||
| --- | ||
|
|
||
| # ONL224 Sync Error in QuickBooks Online Integration | ||
|
|
||
| If you see the error: | ||
|
|
||
| ONL224: You’re not listed as an admin for this company. | ||
|
|
||
| This means the QuickBooks Online user attempting to connect the integration does not have Admin access, preventing the connection from completing. | ||
|
|
||
| --- | ||
|
|
||
| ## Why the ONL224 Sync Error Happens in QuickBooks Online | ||
|
|
||
| The ONL224 error typically indicates: | ||
|
|
||
| - The user attempting to connect is not a QuickBooks Online Company Admin. | ||
| - QuickBooks Online restricts third-party integrations to Admin users. | ||
| - The connection attempt failed due to insufficient permissions. | ||
|
|
||
| Only QuickBooks Online Admin users can connect a QuickBooks account to a Workspace. | ||
|
|
||
| This is a QuickBooks Online permission issue, not a Workspace configuration issue. | ||
|
|
||
| --- | ||
|
|
||
| ## How to Fix the ONL224 Sync Error | ||
|
|
||
| This issue must be resolved in QuickBooks Online. | ||
|
|
||
| 1. Log in to QuickBooks Online. | ||
| 2. Go to the user management section. | ||
| 3. Confirm whether your account is listed as a **Company Admin**. | ||
| 4. If not, request Admin access from an existing Company Admin, or | ||
| 5. Ask a Company Admin to connect QuickBooks Online to the Workspace. | ||
|
|
||
| After confirming Admin access: | ||
|
|
||
| 1. Go to **Settings > Workspaces**. | ||
| 2. Select your Workspace. | ||
| 3. Click **Accounting**. | ||
| 4. Reconnect QuickBooks Online. | ||
| 5. Click **Sync Now** to confirm the integration works properly. | ||
|
|
||
| --- | ||
|
|
||
| # FAQ | ||
|
|
||
| ## Can a Standard QuickBooks User Connect the Integration? | ||
|
|
||
| No. Only QuickBooks Online Company Admin users can connect QuickBooks Online to a Workspace. | ||
|
|
||
| ## Does ONL224 Mean the Connection Is Broken? | ||
|
|
||
| Not necessarily. It means the current user does not have sufficient QuickBooks permissions to establish or reconnect the integration. | ||
|
|
||
| ## Do I Need to Disconnect First? | ||
|
|
||
| No. You can reconnect directly using a QuickBooks Online Admin account. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,77 @@ | ||||||
| --- | ||||||
| title: ONL022 Export Error in QuickBooks Online Integration | ||||||
| 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. | ||||||
| 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 | ||||||
| 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. | ||||||
| --- | ||||||
|
|
||||||
| # ONL022 Export Error in QuickBooks Online Integration | ||||||
|
|
||||||
| If you see the error: | ||||||
|
|
||||||
| ONL022: Account must be marked as billable in QuickBooks Online. | ||||||
|
|
||||||
| This means the account category applied to an expense is not configured to support billable expenses in QuickBooks Online, preventing the export from completing. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## Why the ONL022 Export Error Happens in QuickBooks Online | ||||||
|
|
||||||
| The ONL022 error typically indicates: | ||||||
|
|
||||||
| - Billable functionality is not enabled in QuickBooks Online. | ||||||
| - The selected account in the Chart of Accounts does not support billable expenses. | ||||||
| - QuickBooks Online validation failed due to incorrect billable configuration. | ||||||
|
|
||||||
| When exporting billable expenses, QuickBooks Online requires both company-level billable settings and account-level configuration to be enabled. | ||||||
|
|
||||||
| This is a QuickBooks Online configuration issue, not a Workspace configuration issue. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## How to Fix the ONL022 Export Error | ||||||
|
|
||||||
| This issue must be resolved in QuickBooks Online. | ||||||
|
|
||||||
| ### Enable Billable Expenses | ||||||
|
Contributor
There was a problem hiding this comment. Heading level violation: Use
Suggested change
|
||||||
|
|
||||||
| 1. Log in to QuickBooks Online. | ||||||
| 2. Select the **Gear icon**. | ||||||
| 3. Go to **Account and Settings**. | ||||||
| 4. Select the **Expenses** tab. | ||||||
| 5. Enable **Make expenses and items billable**. | ||||||
| 6. Save your changes. | ||||||
|
Contributor
There was a problem hiding this comment. Button label violation: Per Expensify style, use "Confirm" instead of "Save" at the end of flows. This applies to line 43 ( |
||||||
|
|
||||||
| ### Update the Account in the Chart of Accounts | ||||||
|
Contributor
There was a problem hiding this comment. Heading level violation: Use
Suggested change
|
||||||
|
|
||||||
| 1. Go to the **Chart of Accounts**. | ||||||
| 2. Locate the account used for the expense category. | ||||||
| 3. Select **Edit**. | ||||||
| 4. Ensure the account supports billable expenses. | ||||||
| 5. Select the appropriate **Income account** if required. | ||||||
| 6. Save your changes. | ||||||
|
|
||||||
| After updating QuickBooks Online: | ||||||
|
|
||||||
| 1. Go to **Settings > Workspaces**. | ||||||
| 2. Select your Workspace. | ||||||
| 3. Click **Accounting**. | ||||||
| 4. Click **Sync Now**. | ||||||
|
|
||||||
| Then retry exporting the report. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| # FAQ | ||||||
|
|
||||||
| ## Can I Retry the Export? | ||||||
|
|
||||||
| Yes. After enabling billable functionality and selecting **Sync Now**, retry the export. If the error persists, confirm the correct account is configured. | ||||||
|
|
||||||
| ## Does ONL022 Mean My Plan Does Not Support Billable? | ||||||
|
|
||||||
| Not necessarily. It usually means billable settings are not enabled or the account is not configured correctly. | ||||||
|
|
||||||
| ## Is ONL022 Caused by Workspace Settings? | ||||||
|
|
||||||
| No. ONL022 is triggered by billable configuration settings in QuickBooks Online. Workspace accounting settings are not the cause. | ||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,62 @@ | ||||||
| --- | ||||||
| title: ONL038 Export Error in QuickBooks Online Integration | ||||||
| description: Learn what the ONL038 export error means in QuickBooks Online and how to change the export type to resolve tax rounding issues. | ||||||
| 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 | ||||||
| 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. | ||||||
| --- | ||||||
|
|
||||||
| # ONL038 Export Error in QuickBooks Online Integration | ||||||
|
|
||||||
| If you see the error: | ||||||
|
|
||||||
| ONL038: Tax calculation error. | ||||||
|
|
||||||
| This means QuickBooks Online encountered rounding differences when tax was exported as a Journal Entry, preventing the export from completing. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## Why the ONL038 Export Error Happens in QuickBooks Online | ||||||
|
|
||||||
| The ONL038 error typically indicates: | ||||||
|
|
||||||
| - Tax amounts are being exported as a Journal Entry. | ||||||
| - QuickBooks Online applies different tax rounding rules. | ||||||
| - Rounding differences caused validation to fail. | ||||||
|
|
||||||
| When exporting tax as a Journal Entry, QuickBooks may calculate tax differently than Expensify. These rounding differences can trigger export errors. | ||||||
|
|
||||||
| Exporting as a Vendor Bill allows QuickBooks Online to handle tax calculations internally, reducing rounding conflicts. | ||||||
|
|
||||||
| This is a QuickBooks Online tax handling limitation, not a Workspace calculation issue. | ||||||
|
Contributor
There was a problem hiding this comment. Button label violation: Per Expensify style, use "Confirm" instead of "Save" at the end of flows. This step concludes a settings change flow.
Suggested change
|
||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## How to Fix the ONL038 Export Error | ||||||
|
|
||||||
| This issue can be resolved by changing the export type. | ||||||
|
|
||||||
| 1. Go to **Settings > Workspaces**. | ||||||
| 2. Select your Workspace. | ||||||
| 3. Click **Accounting**. | ||||||
| 4. Click **Configure**. | ||||||
| 5. Open the **Export** tab. | ||||||
| 6. Under **Reimbursable expenses**, select **Vendor Bill**. | ||||||
| 7. Click **Save**. | ||||||
|
|
||||||
| After updating the export type, retry exporting the report. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| # FAQ | ||||||
|
|
||||||
| ## Can I Retry the Export? | ||||||
|
|
||||||
| Yes. After changing the export type to **Vendor Bill**, retry the export. If the error persists, confirm the updated setting was saved. | ||||||
|
|
||||||
| ## Does ONL038 Mean Tax Is Calculated Incorrectly? | ||||||
|
|
||||||
| No. The issue relates to how QuickBooks Online applies tax rounding when exporting as a Journal Entry. | ||||||
|
|
||||||
| ## Do I Need to Reconnect QuickBooks Online? | ||||||
|
|
||||||
| No. Updating the export type and retrying the export is typically sufficient. | ||||||
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Readability / structural concern: This file is nearly identical to
Sync-Errors/ONL193-Sync-Error.md. Consider consolidating into a single article to avoid duplicate content and reduce maintenance burden.