diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Authentication-and-Login-errors/ONL193-Sync-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Authentication-and-Login-errors/ONL193-Sync-Error.md new file mode 100644 index 000000000000..8f839fbb6830 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Authentication-and-Login-errors/ONL193-Sync-Error.md @@ -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. + +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. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Connection-errors/ONL046-Sync-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Connection-errors/ONL046-Sync-Error.md new file mode 100644 index 000000000000..8ce194c9e37d --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Connection-errors/ONL046-Sync-Error.md @@ -0,0 +1,87 @@ +--- +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. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Connection-errors/ONL224-Sync-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Connection-errors/ONL224-Sync-Error.md new file mode 100644 index 000000000000..8ce1a01f0c66 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Connection-errors/ONL224-Sync-Error.md @@ -0,0 +1,64 @@ +--- +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. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL022-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL022-Export-Error.md new file mode 100644 index 000000000000..661880d7a6ca --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL022-Export-Error.md @@ -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 + +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. + +### Update the Account in the Chart of Accounts + +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. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL038-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL038-Export-Error.md new file mode 100644 index 000000000000..3f13e042f868 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL038-Export-Error.md @@ -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. + +--- + +## 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. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL056-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL056-Export-Error.md new file mode 100644 index 000000000000..9bd5445859ae --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL056-Export-Error.md @@ -0,0 +1,70 @@ +--- +title: ONL056 Export Error in QuickBooks Online Integration +description: Learn what the ONL056 export error means in QuickBooks Online and how to recategorize expenses to restore successful exports. +keywords: ONL056, QuickBooks Online export error, expenses must be categorized QuickBooks, missing QuickBooks Online category, invalid category mapping QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL056 export error caused by missing or invalid category mappings. Does not cover other QuickBooks Online error codes. +--- + +# ONL056 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL056: Expenses must be categorized to a QuickBooks Online account. + +This means one or more expenses on the report are not mapped to a valid QuickBooks Online account, preventing the export from completing. + +--- + +## Why the ONL056 Export Error Happens in QuickBooks Online + +The ONL056 error typically indicates: + +- An expense is missing a category. +- The selected category is no longer synced from QuickBooks Online. +- The category belongs to a different Workspace. +- The category does not exist in the current QuickBooks Online Chart of Accounts. + +QuickBooks Online requires all exported expenses to be mapped to valid accounts. + +This is a category mapping issue, not a connection issue. + +--- + +## How to Fix the ONL056 Export Error + +This issue can be resolved by syncing categories and updating invalid expenses. + +### Sync QuickBooks Online Categories + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Sync Now**. + +This refreshes the Chart of Accounts from QuickBooks Online. + +### Recategorize Invalid Expenses + +1. Open the affected report. +2. Look for categories highlighted in red. +3. Edit those expenses. +4. Select a valid QuickBooks Online category. +5. Save your changes. + +After updating the categories, retry exporting the report. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After syncing and updating invalid categories, retry the export. If the error persists, confirm all categories are valid and properly synced. + +## Does ONL056 Mean My QuickBooks Connection Is Broken? + +No. The connection is active. The export failed because one or more expenses were not mapped to a valid account. + +## Do I Need to Reconnect QuickBooks Online? + +No. Running **Sync Now** and recategorizing expenses is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL077-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL077-Export-Error.md new file mode 100644 index 000000000000..d439489d1150 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL077-Export-Error.md @@ -0,0 +1,67 @@ +--- +title: ONL077 Export Error in QuickBooks Online Integration +description: Learn what the ONL077 export error means in QuickBooks Online and how to adjust duplicate document number settings to restore successful exports. +keywords: ONL077, QuickBooks Online export error, duplicate document number flagged, duplicate bill number warning QuickBooks, disable duplicate bill number warning, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL077 export error caused by duplicate document number warnings. Does not cover other QuickBooks Online error codes. +--- + +# ONL077 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL077: Duplicate Document Number flagged. + +This means QuickBooks Online has duplicate document number warnings enabled, and the document number being exported already exists in QuickBooks, preventing the export from completing. + +--- + +## Why the ONL077 Export Error Happens in QuickBooks Online + +The ONL077 error typically indicates: + +- Duplicate bill number warnings are enabled in QuickBooks Online. +- The exported report uses a document number that already exists. +- QuickBooks Online blocked the transaction due to duplicate validation rules. + +QuickBooks Online includes a preference that warns users when duplicate document numbers are used. If this setting is enabled, exports may fail when a duplicate number is detected. + +This is a QuickBooks Online preference setting, not a Workspace configuration issue. + +--- + +## How to Fix the ONL077 Export Error + +This issue must be resolved in QuickBooks Online. + +1. Log in to QuickBooks Online. +2. Select the **Gear icon**. +3. Go to **Account and Settings**. +4. Click the **Advanced** tab. +5. Under **Other preferences**, locate **Warn if duplicate bill number is used**. +6. Turn this setting **Off**. +7. 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 disabling the duplicate warning and selecting **Sync Now**, retry the export. + +## Does ONL077 Mean My Report Already Exists? + +It may. The document number being exported matches an existing document number in QuickBooks Online. + +## Do I Need to Reconnect QuickBooks Online? + +No. Updating the duplicate document number setting and running **Sync Now** is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL088-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL088-Export-Error.md new file mode 100644 index 000000000000..db8d45a437e3 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL088-Export-Error.md @@ -0,0 +1,92 @@ +--- +title: ONL088 Export Error in QuickBooks Online Integration +description: Learn what the ONL088 export error means in QuickBooks Online and how to resolve employee and vendor record conflicts. +keywords: ONL088, QuickBooks Online export error, error creating vendor QuickBooks, employee already exists QuickBooks, duplicate employee vendor conflict, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL088 export error caused by employee and vendor name conflicts. Does not cover other QuickBooks Online error codes. +--- + +# ONL088 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL088: Error creating vendor. Employee already exists in QuickBooks Online. + +This means the report creator already exists as an **Employee** in QuickBooks Online, and Expensify is attempting to create a **Vendor** record with the same name, preventing the export from completing. + +QuickBooks Online does not allow an Employee and Vendor to share the same display name. + +--- + +## Why the ONL088 Export Error Happens in QuickBooks Online + +The ONL088 error typically indicates: + +- Reimbursable expenses are exporting as Vendor Bills. +- Expensify is attempting to automatically create a Vendor record. +- The report creator already exists as an Employee in QuickBooks Online. +- QuickBooks blocks duplicate name records across Employees and Vendors. + +This is a QuickBooks Online record conflict issue, not a Workspace configuration issue. + +--- + +## How to Fix the ONL088 Export Error + +You can resolve this by updating record names or manually managing Vendor records. + +### Option 1: Edit the Employee Name in QuickBooks Online + +1. Log in to QuickBooks Online. +2. Go to **Employees**. +3. Locate the employee record with the same name as the report creator. +4. Edit the employee’s display name so it differs from the Vendor name. +5. 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. + +--- + +### Option 2: Manually Create Vendor Records and Disable Automatic Entity Creation + +If you prefer to control Vendor creation manually: + +1. Log in to QuickBooks Online. +2. Go to **Vendors**. +3. Manually create Vendor records with email addresses that exactly match the emails used in Expensify. +4. Save your changes. + +Then in Expensify: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Advanced** tab. +6. Disable **Automatically Create Entities**. +7. Click **Save**. +8. Click **Sync Now**. + +Retry exporting the report. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After resolving the name conflict and selecting **Sync Now**, retry the export. + +## Does ONL088 Mean My QuickBooks Connection Is Broken? + +No. The connection is active. QuickBooks is blocking the creation of a duplicate Vendor record. + +## Should Employees Be Vendors or Employees in QuickBooks? + +This depends on your accounting workflow. If exporting as Vendor Bills, Vendor records must exist and cannot conflict with Employee records. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL097-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL097-Export-Error.md new file mode 100644 index 000000000000..2edded686b25 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL097-Export-Error.md @@ -0,0 +1,102 @@ +--- +title: ONL097 Export Error in QuickBooks Online Integration +description: Learn what the ONL097 export error means in QuickBooks Online and how to configure vendor settings when exporting reimbursable expenses as journal entries. +keywords: ONL097, QuickBooks Online export error, vendor required in name field, journal entry Accounts Payable QuickBooks, reimbursable expense export error, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL097 export error caused by vendor requirements when exporting reimbursable expenses as Journal Entries to Accounts Payable. Does not cover other QuickBooks Online error codes. +--- + +# ONL097 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL097: Please select a vendor in the Name field. + +This means reimbursable expenses are being exported as Journal Entries to an Accounts Payable account, and QuickBooks Online requires a Vendor in the Name field, preventing the export from completing. + +--- + +## Why the ONL097 Export Error Happens in QuickBooks Online + +The ONL097 error typically indicates: + +- Reimbursable expenses are exported as **Journal Entries**. +- The export account is **Accounts Payable (A/P)**. +- A Vendor record does not exist or is not selected. +- Employee records are enabled in QuickBooks Online. + +When posting Journal Entries to Accounts Payable, QuickBooks Online requires a Vendor in the Name field. + +This is a QuickBooks Online export configuration issue, not a Workspace configuration issue. + +--- + +## How to Fix the ONL097 Export Error + +You can resolve this by adjusting export settings or creating Vendor records. + +### Option 1: Change the Export Type to Check + +If you do not want to use Vendor records: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Export** tab. +6. Change the export type for **Reimbursable expenses** to **Check**. +7. Click **Save**. + +Retry exporting the report. + +--- + +### Option 2: Enable Automatically Create Entities + +If you want Expensify to automatically create Vendor records: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Advanced** tab. +6. Enable **Automatically Create Entities**. +7. Click **Save**. + +Then click **Sync Now** and retry exporting the report. + +--- + +### Option 3: Manually Create a Vendor Record + +If you prefer manual control: + +1. Log in to QuickBooks Online. +2. Go to **Vendors**. +3. Create a Vendor record for the report creator or submitter. +4. Ensure the email address exactly matches the email used in Expensify. +5. Save the record. + +After creating the Vendor: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Sync Now**. + +Retry exporting the report. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After adjusting export settings or creating a Vendor record, retry the export. + +## Does ONL097 Mean Employee Records Are Configured Incorrectly? + +No. It means QuickBooks requires a Vendor record when posting Journal Entries to Accounts Payable. + +## Do I Need to Reconnect QuickBooks Online? + +No. Updating export settings or Vendor records and running **Sync Now** is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL099-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL099-Export-Error.md new file mode 100644 index 000000000000..e44ea1378fa6 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL099-Export-Error.md @@ -0,0 +1,68 @@ +--- +title: ONL099 Export Error in QuickBooks Online Integration +description: Learn what the ONL099 export error means in QuickBooks Online and how to enable sales information for Items used in billable expense exports. +keywords: ONL099, QuickBooks Online export error, enable sales info QuickBooks, billable item sales information missing, QuickBooks item configuration error, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL099 export error caused by missing sales information on billable Items. Does not cover other QuickBooks Online error codes. +--- + +# ONL099 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL099: Enable sales info for billable Items in QuickBooks. + +This means the Item (category) used on the expense does not have sales information enabled in QuickBooks Online, preventing the export from completing. + +--- + +## Why the ONL099 Export Error Happens in QuickBooks Online + +The ONL099 error typically indicates: + +- The expense is marked as billable. +- The selected Item in QuickBooks Online does not have **Sales** enabled. +- The Item is not linked to an Income account. +- QuickBooks Online validation failed due to incomplete Item configuration. + +QuickBooks requires billable Items to include sales information and an associated Income account. + +This is a QuickBooks Online Item configuration issue, not a Workspace configuration issue. + +--- + +## How to Fix the ONL099 Export Error + +This issue must be resolved in QuickBooks Online. + +1. Log in to QuickBooks Online. +2. Go to the **Products and Services** (Items) list. +3. Locate the Item used on the report. +4. Select **Edit**. +5. Enable **Sales** for the Item. +6. Assign an appropriate **Income account**. +7. Save your changes. + +After updating the Item: + +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 sales information and selecting **Sync Now**, retry the export. If the error persists, confirm the correct Item was updated. + +## Does ONL099 Mean Billable Is Disabled in QuickBooks? + +Not necessarily. It usually means the specific Item used on the expense does not have Sales enabled. + +## Do I Need to Reconnect QuickBooks Online? + +No. Updating the Item settings and running **Sync Now** is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL118-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL118-Export-Error.md new file mode 100644 index 000000000000..81895fad171d --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL118-Export-Error.md @@ -0,0 +1,74 @@ +--- +title: ONL118 Export Error in QuickBooks Online Integration +description: Learn what the ONL118 export error means in QuickBooks Online and how to associate billable transactions with an active customer or project. +keywords: ONL118, QuickBooks Online export error, associate customer project QuickBooks, billable customer required QuickBooks, inactive customer project QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL118 export error caused by missing or inactive customer or project associations. Does not cover other QuickBooks Online error codes. +--- + +# ONL118 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL118: Associate a customer or project on all billable transactions. + +This means one or more billable expenses are not linked to a valid QuickBooks Online customer or project, preventing the export from completing. + +--- + +## Why the ONL118 Export Error Happens in QuickBooks Online + +The ONL118 error typically indicates: + +- A billable expense does not have a customer or project selected. +- The selected customer or project is inactive or deleted in QuickBooks Online. +- A manually created tag is being used instead of a synced QuickBooks customer or project. + +QuickBooks Online requires every billable transaction to be linked to an active customer or project. + +This is a customer or project mapping issue, not a connection issue. + +--- + +## How to Fix the ONL118 Export Error + +This issue can be resolved by verifying customer and project selections. + +### Confirm All Billable Expenses Have a Customer or Project + +1. Open the affected report. +2. Review all billable expenses. +3. Confirm each billable expense has a valid customer or project selected. +4. Save any updates. + +### Confirm the Customer or Project Is Active in QuickBooks Online + +1. Log in to QuickBooks Online. +2. Verify the customer or project exists. +3. Confirm it is active and not deleted or archived. + +If the customer or project is inactive, reactivate it or select a different active customer or project in the report. + +### Sync QuickBooks Online + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Sync Now**. + +After syncing, retry exporting the report. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After updating customer or project selections and selecting **Sync Now**, retry the export. + +## Does ONL118 Mean Billable Is Disabled? + +No. It means billable transactions are not properly linked to an active customer or project. + +## Do I Need to Reconnect QuickBooks Online? + +No. Running **Sync Now** and correcting customer or project selections is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL297-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL297-Export-Error.md new file mode 100644 index 000000000000..6d844e4a416a --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL297-Export-Error.md @@ -0,0 +1,80 @@ +--- +title: ONL297 Export Error in QuickBooks Online Integration +description: Learn what the ONL297 export error means in QuickBooks Online and how to resync and correct invalid customer, project, or location tags. +keywords: ONL297, QuickBooks Online export error, customer not found QuickBooks, invalid customer tag QuickBooks, location tag error QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL297 export error caused by invalid or unsynced customer, project, or location tags. Does not cover other QuickBooks Online error codes. +--- + +# ONL297 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL297: Customer not found on workspace. + +This means one or more customer, project, or location tags on the report are no longer valid in the Workspace, preventing the export from completing. + +--- + +## Why the ONL297 Export Error Happens in QuickBooks Online + +The ONL297 error typically indicates: + +- A customer, project, or location was removed or renamed in QuickBooks Online. +- The tag is no longer synced to the Workspace. +- The selected tag contains unsupported characters. +- A manually created tag is being used instead of a synced QuickBooks option. + +When tags fall out of sync, Expensify cannot correctly map them to QuickBooks Online. + +This is a sync and tag mapping issue, not a connection failure. + +--- + +## How to Fix the ONL297 Export Error + +This issue can be resolved by syncing and updating invalid tags. + +### Sync the QuickBooks Online Connection + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Sync Now**. + +This refreshes the list of customers, projects, and locations available in the Workspace. + +### Update Invalid Tags on the Report + +1. Open the affected report. +2. Look for customer, project, or location fields highlighted in red. +3. Reselect the correct customer, project, or location from the updated list. +4. Save your changes. + +All tags must match active options in QuickBooks Online. + +### Check for Unsupported Characters + +If the error continues: + +1. Log in to QuickBooks Online. +2. Review the customer, project, or location name. +3. Remove unsupported characters such as forward slashes (/). +4. Save the changes. + +Then return to Expensify, select **Sync Now**, update the tag on the report, and retry exporting. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After syncing and correcting invalid tags, retry the export. + +## Does ONL297 Mean My QuickBooks Connection Is Broken? + +No. The connection is active. The selected customer, project, or location tag is no longer valid in the Workspace. + +## Do I Need to Reconnect QuickBooks Online? + +No. Running **Sync Now** and updating invalid tags is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL298-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL298-Export-Error.md new file mode 100644 index 000000000000..dbcc1a9ad40c --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL298-Export-Error.md @@ -0,0 +1,80 @@ +--- +title: ONL298 Export Error in QuickBooks Online Integration +description: Learn what the ONL298 export error means in QuickBooks Online and how to resync and correct invalid location tags. +keywords: ONL298, QuickBooks Online export error, locations not found QuickBooks, invalid location tag QuickBooks, QuickBooks location sync error, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL298 export error caused by invalid or unsynced location tags. Does not cover other QuickBooks Online error codes. +--- + +# ONL298 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL298: Locations not found on workspace. + +This means one or more location tags on the report are no longer valid in the Workspace, preventing the export from completing. + +--- + +## Why the ONL298 Export Error Happens in QuickBooks Online + +The ONL298 error typically indicates: + +- A location was removed or renamed in QuickBooks Online. +- The location tag is no longer synced to the Workspace. +- The selected location contains unsupported characters. +- A manually created location tag is being used instead of a synced QuickBooks option. + +When location tags fall out of sync, Expensify cannot correctly map them to QuickBooks Online. + +This is a sync and tag mapping issue, not a connection failure. + +--- + +## How to Fix the ONL298 Export Error + +This issue can be resolved by syncing and updating invalid location tags. + +### Sync the QuickBooks Online Connection + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Sync Now**. + +This refreshes the list of available QuickBooks locations in the Workspace. + +### Update Invalid Location Tags on the Report + +1. Open the affected report. +2. Look for location fields highlighted in red. +3. Reselect the correct location from the updated list. +4. Save your changes. + +All location tags must match active options in QuickBooks Online. + +### Check for Unsupported Characters + +If the error continues: + +1. Log in to QuickBooks Online. +2. Review the location name. +3. Remove unsupported characters such as forward slashes (/). +4. Save the changes. + +Then return to Expensify, select **Sync Now**, update the location on the report, and retry exporting. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After syncing and correcting invalid location tags, retry the export. + +## Does ONL298 Mean My QuickBooks Connection Is Broken? + +No. The connection is active. The selected location tag is no longer valid in the Workspace. + +## Do I Need to Reconnect QuickBooks Online? + +No. Running **Sync Now** and updating invalid location tags is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL329-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL329-Export-Error.md new file mode 100644 index 000000000000..13e23e94ce89 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL329-Export-Error.md @@ -0,0 +1,66 @@ +--- +title: ONL329 Export Error in QuickBooks Online Integration +description: Learn what the ONL329 export error means in QuickBooks Online and what happens when receipt attachments exceed file size limits. +keywords: ONL329, QuickBooks Online export error, receipt image exceeded size limit, QuickBooks attachment too large, PDF not exported QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers understanding the ONL329 export error caused by QuickBooks Online attachment size limits. Does not cover other QuickBooks Online error codes. +--- + +# ONL329 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL329: Receipt image exceeded accounting system size limit. + +This means a receipt PDF attached to the report exceeded QuickBooks Online’s file size limit, preventing the attachment from uploading during export. + +The report itself exports successfully, but the oversized PDF attachment is not included. + +--- + +## Why the ONL329 Export Error Happens in QuickBooks Online + +The ONL329 error typically indicates: + +- A receipt PDF exceeds QuickBooks Online’s attachment size limit. +- QuickBooks blocked the file upload during export. +- The report exported without the oversized attachment. + +QuickBooks Online enforces file size limits for attachments. When a file exceeds that limit, the system rejects the attachment but still allows the report to export. + +This is a QuickBooks Online file size limitation, not a Workspace configuration issue. + +--- + +## What Happens When ONL329 Occurs + +- The report exports successfully to QuickBooks Online. +- The PDF attachment is not included. +- The full report and receipt images remain available in Expensify. + +You can reference the report in Expensify at any time to review the complete receipt details. + +--- + +## How to Review Receipts After ONL329 + +1. Open the report in Expensify. +2. Select the individual expense. +3. View or download the receipt attachment directly from Expensify. + +If your accounting team requires smaller attachments in QuickBooks Online, reduce the file size of the receipt before attempting another export. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. However, if the attachment still exceeds QuickBooks Online’s size limit, the same error will occur unless the file size is reduced. + +## Does ONL329 Mean the Export Failed? + +No. The report exported successfully. Only the attachment failed to upload. + +## Were My Receipts Deleted? + +No. All receipts remain securely stored in Expensify. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL363-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL363-Export-Error.md new file mode 100644 index 000000000000..c24cee4a946c --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL363-Export-Error.md @@ -0,0 +1,104 @@ +--- +title: ONL363 Export Error in QuickBooks Online Integration +description: Learn what the ONL363 export error means in QuickBooks Online and how to resolve currency mismatches between accounts and vendors. +keywords: ONL363, QuickBooks Online export error, currency mismatch QuickBooks, account and vendor currencies don’t match, multi-currency QuickBooks error, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL363 export error caused by currency mismatches in multi-currency environments. Does not cover other QuickBooks Online error codes. +--- + +# ONL363 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL363: Account and customer or supplier currencies don’t match. + +This means the QuickBooks Online export account currency does not match the currency assigned to the vendor (supplier) or employee record, preventing the export from completing. + +--- + +## Why the ONL363 Export Error Happens in QuickBooks Online + +The ONL363 error typically indicates: + +- Multi-currency is enabled in QuickBooks Online. +- The vendor or employee record has a different currency than the selected export account. +- QuickBooks validation failed due to currency mismatch. + +QuickBooks requires the vendor (supplier) currency to match the currency assigned to the export account. + +Exports may fail when: + +- Reimbursable or non-reimbursable expenses are exported as **Journal Entries**. +- Credit Card Transactions are exported. +- Debit Card Transactions are exported. + +This is a QuickBooks Online multi-currency configuration issue, not a Workspace configuration issue. + +--- + +## How to Fix the ONL363 Export Error + +This issue can be resolved by adjusting export settings and verifying currencies. + +### Export as Vendor Bills in Multi-Currency Environments + +If multi-currency is enabled: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Export** tab. +6. Set **Reimbursable expenses** to **Vendor Bill**. +7. Save your changes. + +Vendor Bills handle currency correctly in multi-currency environments. + +### Confirm Account and Vendor Currency Match + +In QuickBooks Online: + +1. Go to the **Chart of Accounts**. +2. Confirm the currency assigned to the export account. +3. Open the **Vendor** (or Employee) record. +4. Confirm the vendor currency matches the export account currency. + +The vendor currency and export account currency must align. + +### Check for Duplicate Vendor or Employee Records + +ONL363 may also occur if: + +- Duplicate vendor or employee records exist. +- The duplicate records use the same email address. +- The duplicate records have different currencies assigned. + +To correct this: + +1. Locate duplicate records in QuickBooks Online. +2. Remove the email address from one duplicate. +3. Ensure only one active record remains with the correct currency. + +After making updates: + +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 updating export settings and confirming currency alignment, retry the export. + +## Does ONL363 Mean Multi-Currency Is Misconfigured? + +Not necessarily. It means the vendor and export account currencies do not match. + +## Do I Need to Reconnect QuickBooks Online? + +No. Updating export settings, correcting vendor currencies, and selecting **Sync Now** is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL417-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL417-Export-Error.md new file mode 100644 index 000000000000..00720cb2796a --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL417-Export-Error.md @@ -0,0 +1,69 @@ +--- +title: ONL417 Export Error in QuickBooks Online Integration +description: Learn what the ONL417 export error means in QuickBooks Online and how to align Accounts Receivable and Accounts Payable currencies to restore successful exports. +keywords: ONL417, QuickBooks Online export error, accounts receivable currency mismatch, accounts payable currency mismatch, AR AP currency QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL417 export error caused by currency mismatches between Accounts Receivable and Accounts Payable accounts. Does not cover other QuickBooks Online error codes. +--- + +# ONL417 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL417: All Accounts Receivable and Accounts Payable accounts must be in the same currency. + +This means the currency assigned to your **Accounts Receivable (AR)** or **Accounts Payable (AP)** account in QuickBooks Online does not match the report or Workspace currency, preventing the export from completing. + +--- + +## Why the ONL417 Export Error Happens in QuickBooks Online + +The ONL417 error typically indicates: + +- The report currency in Expensify differs from the currency assigned to AR or AP accounts in QuickBooks Online. +- Multi-currency settings created mismatched account configurations. +- QuickBooks validation failed due to inconsistent account currencies. + +QuickBooks requires all AR and AP accounts involved in the export to share the same currency. + +This is a QuickBooks Online Chart of Accounts configuration issue, not a Workspace configuration issue. + +--- + +## How to Fix the ONL417 Export Error + +This issue must be resolved in QuickBooks Online. + +1. Log in to QuickBooks Online. +2. Go to the **Chart of Accounts**. +3. Locate your **Accounts Receivable (AR)** account. +4. Confirm the currency assigned to the account. +5. Repeat the process for your **Accounts Payable (AP)** account. +6. Ensure both AR and AP accounts: + - Use the same currency, and + - Match the Workspace currency used for export. +7. Save your changes. + +After updating account currencies: + +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 aligning AR and AP currencies and selecting **Sync Now**, retry the export. + +## Does ONL417 Mean Multi-Currency Is Not Supported? + +No. Multi-currency is supported, but AR and AP accounts used in the export must share the same currency. + +## Do I Need to Reconnect QuickBooks Online? + +No. Updating the account currencies and running **Sync Now** is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL442-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL442-Export-Error.md new file mode 100644 index 000000000000..e03162669371 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL442-Export-Error.md @@ -0,0 +1,83 @@ +--- +title: ONL442 Export Error in QuickBooks Online Integration +description: Learn what the ONL442 export error means in QuickBooks Online and how to remove partial transactions before re-exporting. +keywords: ONL442, QuickBooks Online export error, partial export QuickBooks, delete partial transaction QuickBooks, QuickBooks outage export failure, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL442 export error caused by partial transactions due to QuickBooks Online outages or interruptions. Does not cover other QuickBooks Online error codes. +--- + +# ONL442 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL442: Partial export — QuickBooks Online returned an error. + +This means QuickBooks Online encountered an issue during export, and only part of the report was successfully created. + +Until the partial transactions are removed, re-exporting may fail or create duplicates. + +--- + +## Why the ONL442 Export Error Happens in QuickBooks Online + +The ONL442 error typically indicates: + +- QuickBooks Online was experiencing an outage or maintenance period. +- The connection was interrupted during export. +- QuickBooks processed part of the report but failed before completion. + +When this occurs, some transactions may be created in QuickBooks Online while others are not, resulting in a partial export. + +This is generally a QuickBooks Online system issue, not a Workspace configuration issue. + +--- + +## How to Fix the ONL442 Export Error + +This issue can be resolved by removing partial transactions and retrying the export. + +### Check QuickBooks Online Status + +1. Visit the QuickBooks Online status page. +2. Confirm whether there is an outage or maintenance period. +3. Wait until the issue is resolved before retrying the export. + +### Delete Partial Transactions in QuickBooks Online + +After confirming QuickBooks Online is operating normally: + +1. Log in to QuickBooks Online. +2. Locate the transactions created during the failed export. +3. Delete the partial transactions associated with the affected report. +4. Save your changes. + +Removing partial transactions prevents duplicates when re-exporting. + +### Re-export the Report + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Open the affected report. +5. Retry exporting the report. + +Confirm the export completes successfully. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After deleting partial transactions and confirming QuickBooks Online is functioning normally, retry the export. + +## Does ONL442 Mean My Report Failed Completely? + +Not necessarily. Some transactions may have been created before the error occurred. + +## Will Re-exporting Create Duplicates? + +It can if partial transactions are not deleted first. Always remove partial exports before retrying. + +## Do I Need to Reconnect QuickBooks Online? + +No. Once QuickBooks Online is functioning normally and partial transactions are deleted, you can retry the export. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL531-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL531-Export-Error.md new file mode 100644 index 000000000000..bd77c4c77ad4 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL531-Export-Error.md @@ -0,0 +1,85 @@ +--- +title: ONL531 Export Error in QuickBooks Online Integration +description: Learn what the ONL531 export error means in QuickBooks Online and how to resolve deleted or inactive account and mapping issues. +keywords: ONL531, QuickBooks Online export error, account has been deleted QuickBooks, inactive account mapping QuickBooks, deleted category QuickBooks error, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL531 export error caused by deleted or inactive account mappings. Does not cover other QuickBooks Online error codes. +--- + +# ONL531 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL531: Account has been deleted. + +This means one or more mapped accounts or tags used in the report are no longer active in QuickBooks Online, preventing the export from completing. + +--- + +## Why the ONL531 Export Error Happens in QuickBooks Online + +The ONL531 error typically indicates that one of the following was deleted or set to inactive in QuickBooks Online: + +- Account (category or export account) +- Customer +- Item +- Vendor (including report submitter or Credit Card Misc. vendor) +- Class + +If any mapped value no longer exists or is inactive in the QuickBooks Online Chart of Accounts or lists, the export fails. + +This is a QuickBooks Online mapping issue, not a connection issue. + +--- + +## How to Fix the ONL531 Export Error + +This issue can be resolved by refreshing mappings and confirming active accounts. + +### Refresh the Export Configuration + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Export** tab. +6. Temporarily select a different export option under **Export Reimbursable/Non-reimbursable Expenses As**. +7. Click **Save**. +8. Reopen **Configure**. +9. Re-select the correct export type. +10. Click **Save**. + +This refreshes the mapping between Expensify and QuickBooks Online. + +### Confirm All Mapped Values Are Active + +In QuickBooks Online: + +1. Review the **Chart of Accounts**. +2. Confirm the export account and categories are active. +3. Review Customers, Vendors, Items, and Classes used in the report. +4. Reactivate or replace any deleted or inactive entries. + +After confirming active mappings: + +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 refreshing export settings and confirming all mapped values are active, retry the export. + +## Does ONL531 Mean My QuickBooks Connection Is Broken? + +No. It means a mapped account or tag used in the export was deleted or set to inactive in QuickBooks Online. + +## Do I Need to Reconnect QuickBooks Online? + +No. Refreshing the export configuration and running **Sync Now** is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL562-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL562-Export-Error.md new file mode 100644 index 000000000000..215c07c0bd4b --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL562-Export-Error.md @@ -0,0 +1,80 @@ +--- +title: ONL562 Export Error in QuickBooks Online Integration +description: Learn what the ONL562 export error means in QuickBooks Online and how to resolve currency mismatches between vendor records and Accounts Payable or Accounts Receivable accounts. +keywords: ONL562, QuickBooks Online export error, transaction must use same currency, vendor AP currency mismatch QuickBooks, accounts receivable currency error QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL562 export error caused by currency mismatches between vendor records and A/P or A/R accounts. Does not cover other QuickBooks Online error codes. +--- + +# ONL562 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL562: The transaction must use the same currency as the Accounts Receivable or Accounts Payable account. + +This means the currency assigned to the vendor record does not match the currency assigned to the Accounts Payable (A/P) or Accounts Receivable (A/R) account, preventing the export from completing. + +--- + +## Why the ONL562 Export Error Happens in QuickBooks Online + +The ONL562 error typically indicates: + +- The vendor associated with the report creator or submitter has a different currency than the selected A/P or A/R account. +- Duplicate vendor records exist with different currencies assigned. +- QuickBooks validation failed due to currency mismatch. + +QuickBooks requires the transaction currency to match the currency of the A/P or A/R account used for export. + +This is a QuickBooks Online currency configuration issue, not a Workspace configuration issue. + +--- + +## How to Fix the ONL562 Export Error + +This issue can be resolved by verifying vendor and account currencies. + +### Confirm Vendor Currency + +1. Log in to QuickBooks Online. +2. Open the vendor record associated with the report creator or submitter. +3. Confirm the vendor’s currency. +4. Ensure it matches the currency assigned to the relevant A/P or A/R account. +5. Save any changes. + +If duplicate vendor records exist with the same email address but different currencies: + +- Remove the email address from the incorrect record. +- Ensure only one active vendor record remains with the correct currency. + +### Confirm A/P or A/R Account Currency + +1. In QuickBooks Online, go to the **Chart of Accounts**. +2. Locate the A/P or A/R account used for export. +3. Confirm the account currency matches the vendor currency. + +The vendor currency and the A/P or A/R account currency must match exactly. + +After correcting currencies: + +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 aligning vendor and account currencies and selecting **Sync Now**, retry the export. + +## Does ONL562 Mean Multi-Currency Is Unsupported? + +No. Multi-currency is supported, but vendor and A/P or A/R account currencies must match. + +## Do I Need to Reconnect QuickBooks Online? + +No. Updating vendor and account currency settings and running **Sync Now** is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL580-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL580-Export-Error.md new file mode 100644 index 000000000000..1ba367d64450 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL580-Export-Error.md @@ -0,0 +1,97 @@ +--- +title: ONL580 Export Error in QuickBooks Online Integration +description: Learn what the ONL580 export error means in QuickBooks Online and how to resolve foreign currency mismatches between reports and export accounts. +keywords: ONL580, QuickBooks Online export error, transactions can use only one foreign currency, report currency mismatch QuickBooks, posting account currency error, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL580 export error caused by currency mismatches between report currency and export account currency. Does not cover other QuickBooks Online error codes. +--- + +# ONL580 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL580: Transactions can use only one foreign currency. + +This means the currency of the report does not match the currency of the export account configured in your Workspace, preventing the export from completing. + +--- + +## Why the ONL580 Export Error Happens in QuickBooks Online + +The ONL580 error typically indicates: + +- The report currency in Expensify differs from the export account currency in QuickBooks Online. +- The employee or vendor currency does not align with the export account currency. +- QuickBooks validation failed due to a foreign currency mismatch. + +QuickBooks requires the transaction currency to match the posting account currency. + +This is a QuickBooks Online currency configuration issue, not a Workspace configuration issue. + +--- + +## How to Fix the ONL580 Export Error + +This issue can be resolved by aligning report, vendor, and export account currencies. + +### Select a Different Export Account + +If the export account currency does not match the report currency: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Export** tab. +6. Select an export account that matches the report currency. +7. Click **Save**. + +Retry exporting the report. + +--- + +### Confirm Currency Matches Across Report, Vendor, and Export Account + +1. Confirm the report currency in Expensify. +2. Log in to QuickBooks Online. +3. Open the vendor or employee record associated with the report. +4. Confirm the vendor or employee currency matches the report currency. +5. Go to the **Chart of Accounts**. +6. Confirm the export account currency matches both the vendor currency and report currency. + +All three currencies must align. + +After making updates: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Sync Now**. + +Then retry exporting the report. + +--- + +### Confirm the Report Currency Is Correct + +If the report currency is incorrect: + +- If the report status is **Paid: Confirmed**, the currency cannot be changed and a new report must be created. +- If the report status is **Approved**, **Done**, or **Paid**, a Workspace Admin can unapprove the report to allow edits. + +After correcting the report currency, retry exporting. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After aligning currencies and selecting **Sync Now**, retry the export. + +## Does ONL580 Mean Multi-Currency Is Not Supported? + +No. Multi-currency is supported, but the report currency must match the posting account currency. + +## Do I Need to Reconnect QuickBooks Online? + +No. Updating export settings or correcting currency configurations and retrying the export is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md new file mode 100644 index 000000000000..093cc78f3deb --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md @@ -0,0 +1,91 @@ +--- +title: ONL583 Export Error in QuickBooks Online Integration +description: Learn what the ONL583 export error means in QuickBooks Online and how to resolve vendor record matching conflicts. +keywords: ONL583, QuickBooks Online export error, vendor already exists QuickBooks, vendor could not be matched QuickBooks, duplicate vendor record QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL583 export error caused by duplicate or mismatched vendor records. Does not cover other QuickBooks Online error codes. +--- + +# ONL583 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL583: A vendor with this name already exists but could not be matched. + +This means Expensify attempted to create or match a Vendor record for the report submitter, but QuickBooks Online could not confidently match it to an existing vendor, preventing the export from completing. + +--- + +## Why the ONL583 Export Error Happens in QuickBooks Online + +The ONL583 error typically indicates: + +- A Vendor record already exists in QuickBooks Online. +- The email address on the Vendor record does not exactly match the email address used in Expensify. +- The same email address appears on multiple records (such as both an Employee and a Vendor). +- QuickBooks cannot determine which record to use. + +QuickBooks requires a clear one-to-one match between the report submitter and a single Vendor record. + +This is a QuickBooks Online vendor matching issue, not a Workspace configuration issue. + +--- + +## How to Fix the ONL583 Export Error + +This issue can be resolved by reviewing and correcting Vendor records in QuickBooks Online. + +### Confirm the Vendor Email Matches Expensify + +1. Log in to QuickBooks Online. +2. Open the Vendor record for the report creator or submitter. +3. Confirm the email address exactly matches the email listed in Expensify. +4. Save any changes. + +The email must match exactly for Expensify to link the records correctly. + +--- + +### Check for Duplicate Records + +1. Use the QuickBooks Online search function. +2. Search for the report submitter’s email address. +3. Confirm the email is not listed on multiple records (such as both an Employee and Vendor). + +If duplicates exist: + +- Remove the email from the incorrect record, or +- Deactivate duplicate records if appropriate. + +Only one active Vendor record should contain the matching email. + +--- + +### Disable Automatic Entity Creation (If Needed) + +If matching issues continue: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Advanced** tab. +6. Disable **Automatically Create Employees/Vendors**. +7. Click **Save**. + +Then retry exporting the report. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After correcting Vendor records and selecting **Sync Now**, retry the export. + +## Does ONL583 Mean the Vendor Does Not Exist? + +Not necessarily. It usually means the Vendor exists but could not be matched due to email differences or duplicate records. + +## Do I Need to Reconnect QuickBooks Online? + +No. Correcting Vendor records and retrying the export is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL691-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL691-Export-Error.md new file mode 100644 index 000000000000..b37a7ec133ab --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL691-Export-Error.md @@ -0,0 +1,81 @@ +--- +title: ONL691 Export Error in QuickBooks Online Integration +description: Learn what the ONL691 export error means in QuickBooks Online and how to resolve negative or zero-dollar reimbursable check exports. +keywords: ONL691, QuickBooks Online export error, negative check QuickBooks, zero dollar check QuickBooks, reimbursable $0 expense QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL691 export error caused by exporting negative or $0.00 totals as checks. Does not cover other QuickBooks Online error codes. +--- + +# ONL691 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL691: Checks cannot be exported with a negative or $0.00 total amount. + +This means the report total is negative or $0.00 and the export type is set to **Check**, preventing the export from completing. + +QuickBooks Online does not allow checks with negative or zero totals. + +--- + +## Why the ONL691 Export Error Happens in QuickBooks Online + +The ONL691 error typically indicates: + +- The report total is negative. +- The report total is $0.00. +- One or more reimbursable expenses are $0.00 and the export type is **Check**. + +QuickBooks Online does not support negative or zero-dollar checks. When reimbursable expenses are exported as checks, QuickBooks validates the total and blocks unsupported amounts. + +This is a QuickBooks Online export limitation, not a Workspace configuration issue. + +--- + +## How to Fix the ONL691 Export Error + +This issue can be resolved by updating the report or adjusting export settings. + +### Change $0.00 Expenses to Non-Reimbursable + +If the issue is caused by $0.00 reimbursable expenses: + +1. Open the affected report. +2. Edit the $0.00 expenses. +3. Change them from **Reimbursable** to **Non-reimbursable**. +4. Save your changes. + +Retry exporting the report. + +--- + +### Change the Export Type from Check + +If the report total is negative or zero: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Export** tab. +6. Change the export type for **Reimbursable expenses** from **Check** to: + - **Journal Entry**, or + - **Vendor Bill**. +7. Click **Save**. + +Then retry exporting the report. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After updating the report or changing the export type, retry the export. + +## Does ONL691 Mean the Report Is Invalid? + +No. The report is valid, but QuickBooks Online does not allow negative or zero-dollar checks. + +## Do I Need to Reconnect QuickBooks Online? + +No. Updating the report or export settings and retrying the export is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL715-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL715-Export-Error.md new file mode 100644 index 000000000000..e35aae8812b4 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL715-Export-Error.md @@ -0,0 +1,85 @@ +--- +title: ONL715 Export Error in QuickBooks Online Integration +description: Learn what the ONL715 export error means in QuickBooks Online and how to resolve inactive or deleted account, vendor, customer, or class mappings. +keywords: ONL715, QuickBooks Online export error, invalid reference ID QuickBooks, inactive account QuickBooks, deleted vendor QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL715 export error caused by inactive or deleted QuickBooks mappings. Does not cover other QuickBooks Online error codes. +--- + +# ONL715 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL715: Invalid Reference ID. + +This means one or more mapped accounts, vendors, customers, items, or classes used in the report no longer exist or are inactive in QuickBooks Online, preventing the export from completing. + +--- + +## Why the ONL715 Export Error Happens in QuickBooks Online + +The ONL715 error typically indicates that one of the following was deleted or set to inactive in QuickBooks Online: + +- Account (category or posting account) +- Customer +- Item +- Vendor (report creator, submitter, or Credit Card Misc. vendor) +- Class + +If any referenced value is inactive or deleted, QuickBooks cannot validate the transaction and blocks the export. + +This is a QuickBooks Online mapping issue, not a connection issue. + +--- + +## How to Fix the ONL715 Export Error + +This issue can be resolved by refreshing mappings and confirming active records. + +### Refresh the Export Configuration + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Export** tab. +6. Temporarily select a different export option under **Export Reimbursable/Non-reimbursable Expenses As**. +7. Click **Save**. +8. Reopen **Configure**. +9. Re-select the correct export option. +10. Click **Save**. + +This refreshes the reference IDs used during export. + +### Confirm All Mapped Values Are Active + +In QuickBooks Online: + +1. Review the **Chart of Accounts**. +2. Confirm the export account and categories are active. +3. Review Vendors, Customers, Items, and Classes used in the report. +4. Reactivate or replace any deleted or inactive entries. + +After confirming active mappings: + +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 refreshing export settings and confirming all mapped values are active, retry the export. + +## Does ONL715 Mean My QuickBooks Connection Is Broken? + +No. It means a referenced account, vendor, customer, item, or class is inactive or deleted in QuickBooks Online. + +## Do I Need to Reconnect QuickBooks Online? + +No. Refreshing export settings and running **Sync Now** is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL793-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL793-Export-Error.md new file mode 100644 index 000000000000..c7b518a0d989 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL793-Export-Error.md @@ -0,0 +1,89 @@ +--- +title: ONL793 Export Error in QuickBooks Online Integration +description: Learn what the ONL793 export error means in QuickBooks Online and how to correct account type mappings for billable expenses. +keywords: ONL793, QuickBooks Online export error, billable expenses account type error, QuickBooks account type requirement billable, unsupported account type QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL793 export error caused by unsupported account types for billable expenses. Does not cover other QuickBooks Online error codes. +--- + +# ONL793 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL793: Billable expenses not coded with appropriate account type. + +This means one or more billable expenses are categorized to an account type that QuickBooks Online does not support for billable transactions, preventing the export from completing. + +--- + +## Why the ONL793 Export Error Happens in QuickBooks Online + +The ONL793 error typically indicates: + +- An expense is marked as **Billable**. +- The selected category maps to an unsupported account type in QuickBooks Online. +- QuickBooks validation failed due to account type restrictions. + +QuickBooks Online supports billable transactions only for specific account types, including: + +- Expense +- Other Expense +- Other Current Liabilities +- Other Current Assets +- Other Assets +- Fixed Assets +- Cost of Goods Sold + +If a billable expense is mapped to a different account type, the export fails. + +This is a QuickBooks Online account type restriction, not a Workspace configuration issue. + +--- + +## How to Fix the ONL793 Export Error + +This issue can be resolved by reviewing billable expenses and updating categories. + +### Confirm Billable Expenses on the Report + +1. Open the affected report. +2. Review all expenses. +3. Confirm which expenses are marked as **Billable**. + +If no expenses are marked as billable, the error may be temporary. + +### Confirm the Account Type Is Supported + +For each billable expense: + +1. Review the selected category. +2. Confirm the QuickBooks Online account type for that category is one of the supported account types listed above. +3. If the account type is not supported, recategorize the expense to a valid account. +4. Save your changes. + +After updating categories, retry exporting the report. + +--- + +## If the Error Persists + +If all billable expenses are categorized correctly, the issue may be related to a temporary QuickBooks Online outage. + +1. Check the QuickBooks Online status page. +2. Wait until the system is fully operational. +3. Retry exporting the report. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After correcting account types or confirming QuickBooks is fully operational, retry the export. + +## Does ONL793 Mean Billable Is Disabled? + +No. It means the selected account type is not supported for billable transactions. + +## Do I Need to Reconnect QuickBooks Online? + +No. Updating the category account type or retrying after a temporary issue is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL888-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL888-Export-Error.md new file mode 100644 index 000000000000..02a3f0419fd2 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL888-Export-Error.md @@ -0,0 +1,93 @@ +--- +title: ONL888 Export Error in QuickBooks Online Integration +description: Learn what the ONL888 export error means in QuickBooks Online and how to reopen a closed reporting period or adjust the export date to restore successful exports. +keywords: ONL888, QuickBooks Online export error, reporting period closed QuickBooks, reopen accounting period QuickBooks, change export date QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL888 export error caused by closed reporting periods in QuickBooks Online. Does not cover other QuickBooks Online error codes. +--- + +# ONL888 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL888: Reporting period is closed in QuickBooks Online. + +This means the report is attempting to post to a closed accounting period in QuickBooks Online, preventing the export from completing. + +--- + +## Why the ONL888 Export Error Happens in QuickBooks Online + +The ONL888 error typically indicates: + +- The export date falls within a closed reporting period. +- The posting date corresponds to a locked accounting period. +- QuickBooks validation failed because transactions cannot post to closed periods. + +QuickBooks Online does not allow transactions to post to closed accounting periods. + +This is an accounting period restriction, not a Workspace configuration issue. + +--- + +## How to Fix the ONL888 Export Error + +You can resolve this by reopening the period or adjusting the export date. + +### Reopen the Closed Reporting Period + +1. Log in to QuickBooks Online. +2. Navigate to your accounting period settings. +3. Reopen the closed reporting period. +4. Save your changes. + +After reopening the period: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Sync Now**. + +Then retry exporting the report. + +--- + +### Change the Export Date in Expensify + +If you prefer not to reopen the period: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Export** tab. +6. Select a different export date option: + - **Date of Last Expense** + - **Submitted Date** + - **Exported Date** +7. Click **Save**. + +Then retry exporting the report. + +--- + +## Important: Credit Card Transactions + +If exporting non-reimbursable expenses as **Credit Card Transactions**, the reporting period must be reopened. + +Credit card transactions export using the bank posting date, which cannot be overridden by changing export date settings. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After reopening the period or updating the export date and selecting **Sync Now**, retry the export. + +## Does ONL888 Mean My QuickBooks Connection Is Broken? + +No. The connection is active. The transaction attempted to post to a closed reporting period. + +## Do I Need to Reconnect QuickBooks Online? + +No. Reopening the reporting period or adjusting export date settings is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL912-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL912-Export-Error.md new file mode 100644 index 000000000000..47d5ebda074c --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL912-Export-Error.md @@ -0,0 +1,84 @@ +--- +title: ONL912 Export Error in QuickBooks Online Integration +description: Learn what the ONL912 export error means in QuickBooks Online and how to resolve deleted or inactive account and mapping issues. +keywords: ONL912, QuickBooks Online export error, account not found QuickBooks, inactive category QuickBooks, deleted export account QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL912 export error caused by inactive or deleted QuickBooks mappings. Does not cover other QuickBooks Online error codes. +--- + +# ONL912 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL912: Account not found. + +This means the category or export account used on the report is no longer active or available in QuickBooks Online, preventing the export from completing. + +--- + +## Why the ONL912 Export Error Happens in QuickBooks Online + +The ONL912 error typically indicates: + +- The selected category was deleted in QuickBooks Online. +- The export account was marked as inactive in the Chart of Accounts. +- A related mapping (Vendor, Customer, Item, or Class) was deleted or inactivated. + +If any referenced value no longer exists or is inactive, QuickBooks cannot validate the transaction and blocks the export. + +This is a QuickBooks Online mapping issue, not a connection issue. + +--- + +## How to Fix the ONL912 Export Error + +This issue can be resolved by confirming active mappings and refreshing the Workspace. + +### Confirm Accounts Are Active + +1. Log in to QuickBooks Online. +2. Go to the **Chart of Accounts**. +3. Locate the category or export account used in the report. +4. Confirm the account is active. + +If the account is inactive, reactivate it. + +--- + +### Confirm Related Records Are Active + +If the account is active, review other related mappings: + +- Confirm the report submitter’s **Vendor or Employee** record is active. +- Confirm **Customers**, **Items**, and **Classes** used on the report are active. +- Ensure none of the referenced values have been deleted. + +If any value is inactive or deleted, either reactivate it in QuickBooks Online or update the report in Expensify to use an active value. + +--- + +### Sync the Workspace + +After reactivating or updating records: + +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 confirming all mapped accounts and related records are active and selecting **Sync Now**, retry the export. + +## Does ONL912 Mean My QuickBooks Connection Is Broken? + +No. It means a referenced account or related record is inactive or deleted in QuickBooks Online. + +## Do I Need to Reconnect QuickBooks Online? + +No. Reactivating the correct account or selecting a different active mapping and running **Sync Now** is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL913-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL913-Export-Error.md new file mode 100644 index 000000000000..2e4ee285d6bd --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL913-Export-Error.md @@ -0,0 +1,101 @@ +--- +title: ONL913 Export Error in QuickBooks Online Integration +description: Learn what the ONL913 export error means in QuickBooks Online and how to select a supported account type to restore successful exports. +keywords: ONL913, QuickBooks Online export error, invalid account type QuickBooks, unsupported account type QuickBooks, chart of accounts mapping error, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL913 export error caused by unsupported QuickBooks account types. Does not cover other QuickBooks Online error codes. +--- + +# ONL913 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL913: Invalid account type. + +This means the category or export account selected in Expensify is not a supported account type in QuickBooks Online, preventing the export from completing. + +--- + +## Why the ONL913 Export Error Happens in QuickBooks Online + +The ONL913 error typically indicates: + +- The selected category is mapped to an unsupported QuickBooks account type. +- The export account in Workspace settings is not compatible with the chosen export method. +- QuickBooks validation failed due to account type restrictions. + +QuickBooks Online only allows certain account types to be used for specific export options. + +This is a Chart of Accounts configuration issue, not a connection issue. + +--- + +## How to Fix the ONL913 Export Error + +This issue can be resolved by selecting a supported account type. + +### Confirm the Account Is Active + +1. Log in to QuickBooks Online. +2. Open the **Chart of Accounts**. +3. Locate the category or export account used in the report. +4. Confirm the account is active. + +If the account is inactive, reactivate it or choose a different active account. + +--- + +### Confirm the Account Type Is Supported + +Below are supported QuickBooks Online account types for expense exports: + +**Supported Account Types** + +- Other Current Assets +- Bank +- Fixed Assets +- Accounts Receivable +- Accounts Payable +- Credit Card +- Other Current Liabilities +- Other Expense (excluding Exchange Gain or Loss) + +**Unsupported Account Types** + +- Other Assets +- Long-Term Liabilities +- Accumulated Adjustment +- Equity +- Income +- Other Income + +If the selected category or export account falls under an unsupported account type, choose a different account in QuickBooks Online. + +--- + +### Update Export Settings in Expensify + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Export** tab. +6. Select a valid export account from the supported account types. +7. Click **Save**. + +Then retry exporting the report. + +--- + +# FAQ + +## Can I Retry the Export? + +Yes. After selecting a supported account type and selecting **Sync Now**, retry the export. + +## Does ONL913 Mean My QuickBooks Connection Is Broken? + +No. It means the selected account type is not supported for the chosen export option. + +## Can I Use Income or Equity Accounts for Expense Exports? + +No. Income, Equity, and several other account types are not supported for expense exports. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL939-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL939-Export-Error.md new file mode 100644 index 000000000000..a5e0d14d74f0 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL939-Export-Error.md @@ -0,0 +1,63 @@ +--- +title: ONL939 Export Error in QuickBooks Online Integration +description: Learn what the ONL939 export error means in QuickBooks Online and how to switch from Journal Entries to Vendor Bills to resolve debit and credit imbalance issues. +keywords: ONL939, QuickBooks Online export error, error affecting debits and credits, journal entry tax error QuickBooks, change export type to vendor bill, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL939 export error caused by debit and credit imbalances when exporting as Journal Entries. Does not cover other QuickBooks Online error codes. +--- + +# ONL939 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL939: Error affecting debits and credits. + +This means QuickBooks Online detected a debit and credit imbalance when exporting the report as a Journal Entry, preventing the export from completing. + +--- + +## Why the ONL939 Export Error Happens in QuickBooks Online + +The ONL939 error typically indicates: + +- The export type is set to **Journal Entry**. +- A tax rate on the report was changed or adjusted. +- QuickBooks calculates debits and credits differently than Expensify when exporting as Journal Entries. +- Rounding or balancing differences caused validation to fail. + +When tax calculations are modified, QuickBooks may apply rounding rules that create a debit and credit mismatch during Journal Entry exports. + +Exporting as a Vendor Bill avoids this issue because Vendor Bills handle tax calculations differently within QuickBooks Online. + +This is a QuickBooks Online export limitation, not a Workspace configuration issue. + +--- + +## How to Fix the ONL939 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. Change the export type for **Reimbursable expenses** from **Journal Entry** to **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. + +## Does ONL939 Mean the Report Totals Are Incorrect? + +No. The issue relates to how QuickBooks processes tax and balancing when exporting as Journal Entries. + +## Do I Need to Reconnect QuickBooks Online? + +No. Changing the export type and retrying the export is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL945-Export-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL945-Export-Error.md new file mode 100644 index 000000000000..f9d31ab0992a --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL945-Export-Error.md @@ -0,0 +1,75 @@ +--- +title: ONL945 Export Error in QuickBooks Online Integration +description: Learn what the ONL945 export error means in QuickBooks Online and how to resolve vendor record conflicts caused by duplicate or mismatched email associations. +keywords: ONL945, QuickBooks Online export error, vendor not found QuickBooks, supplier not found QuickBooks, duplicate email vendor conflict QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL945 export error caused by duplicate or conflicting vendor email records. Does not cover other QuickBooks Online error codes. +--- + +# ONL945 Export Error in QuickBooks Online Integration + +If you see the error: + +ONL945: Vendor or supplier not found. + +This means Expensify could not match the report submitter to a valid Vendor record in QuickBooks Online, preventing the export from completing. + +--- + +## Why the ONL945 Export Error Happens in QuickBooks Online + +The ONL945 error typically indicates: + +- The vendor email used in Expensify is already associated with another record in QuickBooks Online. +- Multiple records (such as an Employee and a Vendor) share the same email address. +- QuickBooks cannot determine which record to use for the export. + +QuickBooks requires a clear one-to-one match between the report submitter and a single Vendor record. + +This is a QuickBooks Online vendor record conflict, not a Workspace configuration issue. + +--- + +## How to Fix the ONL945 Export Error + +This issue can be resolved by reviewing and correcting Vendor records in QuickBooks Online. + +### Search for the Submitter’s Email + +1. Log in to QuickBooks Online. +2. Use the global search function. +3. Search for the report submitter’s email address. +4. Review all matching records. + +### Remove or Correct Duplicate Records + +If multiple records are associated with the same email: + +- Remove the email address from duplicate or incorrect records, or +- Deactivate duplicate records as appropriate. + +Only one active Vendor record should contain the email address used in Expensify. + +After correcting records: + +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 correcting duplicate records and selecting **Sync Now**, retry the export. + +## Does ONL945 Mean the Vendor Does Not Exist? + +Not necessarily. It usually means there is a conflict due to duplicate or mismatched email associations. + +## Do I Need to Reconnect QuickBooks Online? + +No. Correcting duplicate records and running **Sync Now** is typically sufficient. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/QuickBooks-Online-FAQ.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/QuickBooks-Online-FAQ.md new file mode 100644 index 000000000000..968c2244dddc --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/QuickBooks-Online-FAQ.md @@ -0,0 +1,97 @@ +--- +title: QuickBooks Online Integration FAQ and Export Troubleshooting +description: Learn why reports may not export to QuickBooks Online, how to manually export, fix company card mapping issues, disconnect the integration, and handle negative expenses. +keywords: QuickBooks export not working, automatic export failed QuickBooks, manual export QuickBooks Online, company card wrong account QuickBooks, preferred exporter domain admin, disconnect QuickBooks Online, negative expense export QuickBooks, Workspace Admin +internalScope: Audience is Workspace Admins and Domain Admins using the QuickBooks Online integration. Covers common export failures, manual export restrictions, company card mapping issues, disconnecting the integration, and negative expense exports. Does not cover specific QuickBooks error codes. +--- + +# QuickBooks Online FAQ + +## Why is my report not automatically exporting to QuickBooks Online? + +An error is preventing the report from exporting automatically. + +You can find the error in several ways: + +- The **preferred exporter** (as configured in Expensify) receives an email with error details. +- The error appears in the report’s comments section. +- Automatic exports will continue to fail until the error is resolved. + +### How to resolve automatic export failures + +1. Open the affected report in Expensify. +2. Review the error message in the comments section. +3. Make the required corrections. +4. Have a Workspace Admin manually export the report. + +--- + +## Why am I unable to manually export a report to QuickBooks Online? + +Only reports in **Approved**, **Done**, or **Paid** status can be exported. + +If the report is in **Draft** status, selecting export may result in an empty screen. + +### How to resolve manual export issues + +1. Submit the report if it is in Draft status. +2. Have an approver approve the report if it is Outstanding. +3. Once the report is Approved, Done, or Paid, a Workspace Admin can manually export it. + +--- + +## Why are company card expenses exporting to the wrong account? + +Company card expenses may export to the wrong account if the card export mapping is incorrect or if the exporter does not have proper permissions. + +### How to verify company card export mapping + +1. Go to the navigation tabs on the left. +2. Click **Settings**. +3. Click **Domains**. +4. Select **Company Cards**. +5. Click **Edit Export** for the affected card. +6. Confirm the correct export account is selected. + +Also confirm: + +- The expenses display the **Card + Lock icon**, which ensures they are mapped correctly. +- The preferred exporter is a **Domain Admin**. + +If the preferred exporter is not a Domain Admin, exports will default to the fallback company card account set in the Workspace configuration. + +### How to check the preferred exporter + +1. Go to the navigation tabs on the left. +2. Click **Workspaces**. +3. Select your Workspace. +4. Click **Accounting**. +5. Click **Configure**. +6. Open the **Export** tab. +7. Review the preferred exporter settings. + +--- + +## How do I disconnect the QuickBooks Online connection? + +Disconnecting removes the active integration and clears imported options. + +### How to disconnect QuickBooks Online + +1. Go to the navigation tabs on the left. +2. Click **Settings**. +3. Click **Workspaces**. +4. Select your Workspace. +5. Click **Accounting**. +6. Click the gray **Disconnect** button under the QuickBooks Online connection. +7. Confirm to disconnect. + +Note: Disconnecting clears all imported options from Expensify. + +--- + +## Can I export negative expenses to QuickBooks Online? + +Yes. + +QuickBooks Online accepts negative expenses across all export types. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL046-Sync-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL046-Sync-Error.md new file mode 100644 index 000000000000..c92133c6b4df --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL046-Sync-Error.md @@ -0,0 +1,87 @@ +--- +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 sync error, feature not included QuickBooks subscription, 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 other QuickBooks Online 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. + +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 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. + +After making changes: + +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. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL193-Sync-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL193-Sync-Error.md new file mode 100644 index 000000000000..2ae9031e5416 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL193-Sync-Error.md @@ -0,0 +1,66 @@ +--- +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. + +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: + +1. Click **Sync Now** again. +2. Confirm the sync completes without errors. +3. Retry exporting any previously failed reports. + +--- + +# 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. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL224-Sync-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL224-Sync-Error.md new file mode 100644 index 000000000000..f169be413ffd --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL224-Sync-Error.md @@ -0,0 +1,64 @@ +--- +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 sync error, not listed as admin QuickBooks, QuickBooks Online admin required, connect QuickBooks Online Expensify, 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 Company 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 Company 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 is working 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 Company Admin account. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL320-Sync-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL320-Sync-Error.md new file mode 100644 index 000000000000..e67abf7d853f --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL320-Sync-Error.md @@ -0,0 +1,58 @@ +--- +title: ONL320 Sync Error in QuickBooks Online Integration +description: Learn what the ONL320 sync error means in QuickBooks Online and how to resolve preferred exporter configuration issues. +keywords: ONL320, QuickBooks Online sync error, unable to set preferred exporter, QuickBooks preferred exporter error, workspace exporter configuration issue, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL320 sync error related to preferred exporter configuration. Does not cover other QuickBooks Online error codes. +--- + +# ONL320 Sync Error in QuickBooks Online Integration + +If you see the error: + +ONL320: Unable to set preferred exporter for Workspace. + +This means there is an issue preventing the preferred exporter from being updated within the QuickBooks Online connection settings. + +--- + +## Why the ONL320 Sync Error Happens in QuickBooks Online + +The ONL320 error typically indicates: + +- Permission restrictions affecting the selected user. +- A connection state issue with QuickBooks Online. +- Backend configuration inconsistencies within the integration. + +Because the preferred exporter is tied to the QuickBooks Online integration configuration, certain issues cannot be resolved directly within Workspace export settings. + +This is not typically caused by general export configuration options. + +--- + +## How to Fix the ONL320 Sync Error + +This issue requires review by Concierge. + +Please reach out to **Concierge** and include: + +- The Workspace name. +- The email address of the user you are trying to set as the preferred exporter. +- A screenshot of the error message. + +Concierge will review the QuickBooks Online connection configuration and resolve the issue. + +--- + +# FAQ + +## Can I Fix ONL320 by Reconnecting QuickBooks Online? + +Not typically. This error usually requires configuration review rather than a simple reconnection. + +## Does ONL320 Affect Report Exports? + +It may prevent changes to the preferred exporter, but existing export functionality may continue to work depending on current settings. + +## Is ONL320 Caused by Subscription Limitations? + +No. ONL320 is generally related to configuration or permission issues within the integration settings. diff --git a/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL493-Sync-Error.md b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL493-Sync-Error.md new file mode 100644 index 000000000000..ed2f1feacda9 --- /dev/null +++ b/docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Sync-Errors/ONL493-Sync-Error.md @@ -0,0 +1,97 @@ +--- +title: ONL493 Sync Error in QuickBooks Online Integration +description: Learn what the ONL493 sync error means in QuickBooks Online and how to create the correct account type or update export settings to restore successful syncing. +keywords: ONL493, QuickBooks Online sync error, no export account selected QuickBooks, QuickBooks Chart of Accounts configuration error, vendor bill export account QuickBooks, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers resolving the ONL493 sync error caused by missing or incompatible QuickBooks account types. Does not cover other QuickBooks Online error codes. +--- + +# ONL493 Sync Error in QuickBooks Online Integration + +If you see the error: + +ONL493: No export account selected in QuickBooks Online settings. + +This means the selected export type in Expensify does not have a compatible account type available in your QuickBooks Online Chart of Accounts, preventing syncing or exporting from completing. + +--- + +## Why the ONL493 Sync Error Happens in QuickBooks Online + +The ONL493 error typically indicates: + +- The required account type for the selected export option does not exist. +- The Chart of Accounts does not contain a compatible account. +- QuickBooks validation failed due to missing account configuration. + +Each export type in Expensify requires a specific account type in QuickBooks Online. If the required account type is missing, the export fails. + +This is a QuickBooks Online Chart of Accounts configuration issue, not a Workspace configuration issue. + +--- + +## How to Fix the ONL493 Sync Error + +You can resolve this by creating the correct account type in QuickBooks Online or changing the export type. + +--- + +### Create the Required Account Type in QuickBooks Online + +Log in to QuickBooks Online and create the required account type in the **Chart of Accounts**, based on your selected export option: + +- **Vendor Bills** → Requires an **Accounts Payable** account +- **Journal Entries** → Requires: + - Accounts Payable + - Other Current Assets, or + - Other Current Liabilities + - Note: You can only export to **Other Current Liabilities** if the report creator is set up as an **Employee**, not a Vendor +- **Checks** → Requires a **Bank** account +- **Invoices** → Requires an **Accounts Receivable** account +- **Debit Card Transactions** → Requires a **Bank** account +- **Credit Card Transactions** → Requires a **Credit Card** account + +After creating the appropriate account: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Sync Now**. + +--- + +### Change the Export Type in Expensify + +If you prefer not to create a new account: + +1. Go to **Settings > Workspaces**. +2. Select your Workspace. +3. Click **Accounting**. +4. Click **Configure**. +5. Open the **Export** tab. +6. Select a different export option that matches an existing QuickBooks account type. +7. Click **Save**. +8. Click **Sync Now**. + +--- + +## How to Confirm ONL493 Is Resolved + +1. Run **Sync Now**. +2. Retry exporting the affected report. +3. Confirm the export completes successfully. + +--- + +# FAQ + +## Can I Retry the Sync? + +Yes. After creating the correct account type or updating the export settings, retry the sync or export. + +## Does ONL493 Mean My QuickBooks Connection Is Broken? + +No. The connection is active, but the required account type does not exist in the Chart of Accounts. + +## Do I Need to Reconnect QuickBooks Online? + +No. Creating the correct account type or adjusting export settings and running **Sync Now** is typically sufficient.