From 516c9b1b10b7d4326f9777e7068bf205cd90cd80 Mon Sep 17 00:00:00 2001 From: Francois Laithier Date: Thu, 1 Oct 2026 16:28:29 -0700 Subject: [PATCH 1/3] docs(qbo): align ONL583 help with name-conflict errors Update the New Expensify and Classic articles to match the revised ONL583 error. Explain customer and employee name conflicts and the rename-or-create fixes so admins can resolve blocked exports. --- .../Export-Errors/ONL583-Export-Error.md | 87 ++++++------------ .../Export-Errors/ONL583-Export-Error.md | 92 ++++++------------- 2 files changed, 53 insertions(+), 126 deletions(-) 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 index 093cc78f3deb..f1dd583a19c6 100644 --- 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 @@ -1,78 +1,41 @@ --- -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. +title: How to Fix the ONL583 Export Error in QuickBooks Online Integration +description: Learn how to fix the ONL583 export error when a vendor, supplier, customer, or employee name in QuickBooks Online prevents Expensify from creating a vendor for the report submitter. +keywords: ONL583, QuickBooks Online duplicate name, vendor already exists, supplier name conflict, customer or employee name conflict, submitter email mismatch, Expensify QuickBooks Online integration, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers fixing the ONL583 export error caused by a name conflict when automatically creating a vendor for the report submitter. Does not cover other QuickBooks Online error codes. --- -# ONL583 Export Error in QuickBooks Online Integration +# How to Fix the ONL583 Export Error in QuickBooks Online Integration -If you see the error: +The ONL583 error identifies the submitter's email and the conflicting record name. For example: -ONL583: A vendor with this name already exists but could not be matched. +> ONL583 Export Error: We could not find a vendor/supplier in QuickBooks Online for jane@acme.com. A record named 'Jane Doe' already exists in QuickBooks Online under a different email, or as another record type such as a customer or employee. Please rename that record, or create a vendor/supplier for jane@acme.com under a different name. -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. +This means Expensify cannot find a matching vendor/supplier by email, and QuickBooks Online rejects creating one because its name is already in use. --- ## Why the ONL583 Export Error Happens in QuickBooks Online -The ONL583 error typically indicates: +The ONL583 error occurs when: -- 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. +- Expensify cannot find a vendor/supplier matching the report submitter's email address. +- Expensify attempts to create a vendor for the submitter. +- The name is already used by a vendor/supplier with a different email, or by a customer or employee record. -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. +Expensify matches vendors by email address. QuickBooks Online requires unique names across vendors/suppliers, customers, and employees. --- -## 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 +## How to Fix the Name Conflict in QuickBooks Online 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. +2. Search for the **record name shown in the error**, not just the submitter's email. Check vendor/supplier, customer, and employee records. +3. If the record is the correct vendor/supplier for the submitter, update its email to exactly match the submitter's email in Expensify and save your changes. +4. If the record belongs to someone else or is a customer or employee, choose one of these fixes: + - Rename the conflicting record so Expensify can automatically create the vendor/supplier under the original name. + - Create a vendor/supplier with a different, unique name and the submitter's exact email address. +5. Sync the QuickBooks Online connection in Expensify, then retry exporting the report. --- @@ -80,12 +43,16 @@ Then retry exporting the report. ## Can I Retry the Export? -Yes. After correcting Vendor records and selecting **Sync Now**, retry the export. +Yes. After correcting the records in QuickBooks Online, sync the connection in Expensify and retry exporting the report. ## 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. +Not necessarily. A vendor/supplier may exist under a different email, or the name may belong to a customer or employee. Expensify cannot find a vendor/supplier matching the submitter's email and cannot create one with the conflicting name. + +## Can I Fix This by Disabling Automatic Vendor Creation? + +Disabling automatic creation does not resolve the name conflict or create a matching vendor/supplier. If you manage vendors manually, create a vendor/supplier with a unique name and the submitter's exact email, then sync and retry the export. ## Do I Need to Reconnect QuickBooks Online? -No. Correcting Vendor records and retrying the export is typically sufficient. +No. Resolve the name conflict or correct the vendor/supplier email, then sync and retry the export. diff --git a/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md b/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md index be4c4c815bd2..67851322b651 100644 --- a/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md +++ b/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md @@ -1,17 +1,17 @@ --- -title: ONL583 Export Error in QuickBooks Online -description: Learn how to fix the ONL583 export error in QuickBooks Online when a vendor already exists but cannot be matched to the report submitter. -keywords: ONL583, QuickBooks Online vendor already exists, vendor could not be matched, submitter email mismatch, duplicate vendor record, Automatically create employees vendors, Expensify QuickBooks Online export error, Workspace Admin, accounting export error -internalScope: Audience is Workspace Admins using QuickBooks Online integration. Covers fixing the ONL583 export error caused by vendor email mismatches or duplicate records. Does not cover other export error codes. +title: How to Fix the ONL583 Export Error in QuickBooks Online +description: Learn how to fix the ONL583 export error when a vendor, supplier, customer, or employee name in QuickBooks Online prevents Expensify from creating a vendor for the report submitter. +keywords: ONL583, QuickBooks Online duplicate name, vendor already exists, supplier name conflict, customer or employee name conflict, submitter email mismatch, Expensify QuickBooks Online export error, Workspace Admin +internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers fixing the ONL583 export error caused by a name conflict when automatically creating a vendor for the report submitter. Does not cover other export error codes. --- -# ONL583 Export Error in QuickBooks Online +# How to Fix the ONL583 Export Error in QuickBooks Online -If you see the error: +The ONL583 error identifies the submitter's email and the conflicting record name. For example: -ONL583: A vendor with this name already exists in QuickBooks Online, but couldn’t be matched. Please confirm the existing vendor record uses the same email as the submitter. +> We could not find a vendor/supplier in QuickBooks Online for jane@acme.com. A record named 'Jane Doe' already exists in QuickBooks Online under a different email, or as another record type such as a customer or employee. Please rename that record, or create a vendor/supplier for jane@acme.com under a different name. -This means QuickBooks Online already has a vendor with the same name, but Expensify cannot match it to the report submitter based on email address. +This means Expensify cannot find a matching vendor/supplier by email, and QuickBooks Online rejects creating one because its name is already in use. --- @@ -19,67 +19,23 @@ This means QuickBooks Online already has a vendor with the same name, but Expens The ONL583 error occurs when: -- Expensify attempts to create a vendor for the report submitter. -- A vendor with the same name already exists in QuickBooks Online. -- The existing vendor record does not have the same email address as the submitter in Expensify. -- The submitter’s email address is associated with multiple records (for example, both an employee and a vendor). +- Expensify cannot find a vendor/supplier matching the report submitter's email address. +- Expensify attempts to create a vendor for the submitter. +- The name is already used by a vendor/supplier with a different email, or by a customer or employee record. -Expensify matches vendors using email addresses. If the email does not match exactly, the export will fail. +Expensify matches vendors by email address. QuickBooks Online requires unique names across vendors/suppliers, customers, and employees. --- -## How to Confirm the Vendor Email in QuickBooks Online +## How to Fix the Name Conflict in QuickBooks Online 1. Log in to QuickBooks Online. -2. Go to **Expenses**. -3. Select **Vendors**. -4. Search for the vendor with the same name as the report submitter. -5. Open the vendor record. -6. Confirm the **Email** field exactly matches the submitter’s email address in Expensify. -7. Update the email if needed and click **Save**. - -After updating the email, retry exporting the report. - ---- - -## How to Check for Duplicate Records in QuickBooks Online - -If the export still fails: - -1. Use the global search bar in QuickBooks Online. -2. Search for the report submitter’s email address. -3. Review all associated records (vendor, employee, etc.). -4. Identify any duplicate records using the same email. -5. Remove or deactivate duplicate records as appropriate. -6. Save your changes. - -Retry exporting the report after cleaning up duplicate records. - ---- - -## How to Disable Automatically Create Employees/Vendors in Expensify - -If you prefer to manage vendors manually: - -### On Web - -1. Go to the **Workspaces** navigation tab on the left. -2. Select your Workspace. -3. Click **Accounting**. -4. Click **Advanced**. -5. Turn off **Automatically create employees/vendors**. -6. Click **Save**. - -### On Mobile - -1. Tap the **Workspaces** navigation tab on the bottom. -2. Select your Workspace. -3. Tap **Accounting**. -4. Tap **Advanced**. -5. Turn off **Automatically create employees/vendors**. -6. Tap **Save**. - -After disabling automatic creation, retry exporting the report. +2. Search for the **record name shown in the error**, not just the submitter's email. Check vendor/supplier, customer, and employee records. +3. If the record is the correct vendor/supplier for the submitter, update its email to exactly match the submitter's email in Expensify and save your changes. +4. If the record belongs to someone else or is a customer or employee, choose one of these fixes: + - Rename the conflicting record so Expensify can automatically create the vendor/supplier under the original name. + - Create a vendor/supplier with a different, unique name and the submitter's exact email address. +5. Sync the QuickBooks Online connection in Expensify, then retry exporting the report. --- @@ -87,8 +43,12 @@ After disabling automatic creation, retry exporting the report. ## Does the Vendor Email Have to Match Exactly? -Yes. The vendor email in QuickBooks Online must exactly match the submitter’s email address in Expensify for the export to work. +Yes. The vendor/supplier email in QuickBooks Online must exactly match the submitter's email address in Expensify for Expensify to match the records. + +## Can a Customer or Employee Record Cause This Error? + +Yes. A customer or employee record can use the name Expensify is trying to give the vendor/supplier. Search by the name shown in the error, even if that record uses a different email. -## Can Duplicate Vendor or Employee Records Cause This Error? +## Can I Fix This by Disabling Automatic Vendor Creation? -Yes. If multiple records share the same email address, QuickBooks Online may not correctly match the vendor during export, resulting in the ONL583 error. +Disabling automatic creation does not resolve the name conflict or create a matching vendor/supplier. If you manage vendors manually, create a vendor/supplier with a unique name and the submitter's exact email, then sync and retry the export. From f5fd0e0524bfd50295aa9a800375ab8d97bf7839 Mon Sep 17 00:00:00 2001 From: Francois Laithier Date: Thu, 1 Oct 2026 16:38:28 -0700 Subject: [PATCH 2/3] docs(qbo): restore original ONL583 article titles Keep the page headings and title metadata consistent with the existing format used by other export-error help articles. --- .../Troubleshooting/Export-Errors/ONL583-Export-Error.md | 4 ++-- .../Troubleshooting/Export-Errors/ONL583-Export-Error.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) 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 index f1dd583a19c6..112ee901ea85 100644 --- 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 @@ -1,11 +1,11 @@ --- -title: How to Fix the ONL583 Export Error in QuickBooks Online Integration +title: ONL583 Export Error in QuickBooks Online Integration description: Learn how to fix the ONL583 export error when a vendor, supplier, customer, or employee name in QuickBooks Online prevents Expensify from creating a vendor for the report submitter. keywords: ONL583, QuickBooks Online duplicate name, vendor already exists, supplier name conflict, customer or employee name conflict, submitter email mismatch, Expensify QuickBooks Online integration, Workspace Admin internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers fixing the ONL583 export error caused by a name conflict when automatically creating a vendor for the report submitter. Does not cover other QuickBooks Online error codes. --- -# How to Fix the ONL583 Export Error in QuickBooks Online Integration +# ONL583 Export Error in QuickBooks Online Integration The ONL583 error identifies the submitter's email and the conflicting record name. For example: diff --git a/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md b/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md index 67851322b651..8d27488891fd 100644 --- a/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md +++ b/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md @@ -1,11 +1,11 @@ --- -title: How to Fix the ONL583 Export Error in QuickBooks Online +title: ONL583 Export Error in QuickBooks Online description: Learn how to fix the ONL583 export error when a vendor, supplier, customer, or employee name in QuickBooks Online prevents Expensify from creating a vendor for the report submitter. keywords: ONL583, QuickBooks Online duplicate name, vendor already exists, supplier name conflict, customer or employee name conflict, submitter email mismatch, Expensify QuickBooks Online export error, Workspace Admin internalScope: Audience is Workspace Admins using the QuickBooks Online integration. Covers fixing the ONL583 export error caused by a name conflict when automatically creating a vendor for the report submitter. Does not cover other export error codes. --- -# How to Fix the ONL583 Export Error in QuickBooks Online +# ONL583 Export Error in QuickBooks Online The ONL583 error identifies the submitter's email and the conflicting record name. For example: From a6eb29e4baddc332f4e11a5bb202df188d9b6ddc Mon Sep 17 00:00:00 2001 From: Francois Laithier Date: Thu, 1 Oct 2026 16:58:11 -0700 Subject: [PATCH 3/3] docs(qbo): use exact sync labels in ONL583 help Match each platform's sync control so admins can follow the troubleshooting steps without guessing. Apply the exact labels to both the export steps and related FAQs. --- .../Troubleshooting/Export-Errors/ONL583-Export-Error.md | 8 ++++---- .../Troubleshooting/Export-Errors/ONL583-Export-Error.md | 4 ++-- 2 files changed, 6 insertions(+), 6 deletions(-) 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 index 112ee901ea85..7d9a26e860be 100644 --- 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 @@ -35,7 +35,7 @@ Expensify matches vendors by email address. QuickBooks Online requires unique na 4. If the record belongs to someone else or is a customer or employee, choose one of these fixes: - Rename the conflicting record so Expensify can automatically create the vendor/supplier under the original name. - Create a vendor/supplier with a different, unique name and the submitter's exact email address. -5. Sync the QuickBooks Online connection in Expensify, then retry exporting the report. +5. In Expensify, select **Sync Now** for the QuickBooks Online connection. Once the sync completes, retry exporting the report. --- @@ -43,7 +43,7 @@ Expensify matches vendors by email address. QuickBooks Online requires unique na ## Can I Retry the Export? -Yes. After correcting the records in QuickBooks Online, sync the connection in Expensify and retry exporting the report. +Yes. After correcting the records in QuickBooks Online, select **Sync Now** in Expensify and retry exporting the report. ## Does ONL583 Mean the Vendor Does Not Exist? @@ -51,8 +51,8 @@ Not necessarily. A vendor/supplier may exist under a different email, or the nam ## Can I Fix This by Disabling Automatic Vendor Creation? -Disabling automatic creation does not resolve the name conflict or create a matching vendor/supplier. If you manage vendors manually, create a vendor/supplier with a unique name and the submitter's exact email, then sync and retry the export. +Disabling automatic creation does not resolve the name conflict or create a matching vendor/supplier. If you manage vendors manually, create a vendor/supplier with a unique name and the submitter's exact email, then select **Sync Now** in Expensify and retry the export. ## Do I Need to Reconnect QuickBooks Online? -No. Resolve the name conflict or correct the vendor/supplier email, then sync and retry the export. +No. Resolve the name conflict or correct the vendor/supplier email, then select **Sync Now** in Expensify and retry the export. diff --git a/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md b/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md index 8d27488891fd..b4cbee822bf4 100644 --- a/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md +++ b/docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/ONL583-Export-Error.md @@ -35,7 +35,7 @@ Expensify matches vendors by email address. QuickBooks Online requires unique na 4. If the record belongs to someone else or is a customer or employee, choose one of these fixes: - Rename the conflicting record so Expensify can automatically create the vendor/supplier under the original name. - Create a vendor/supplier with a different, unique name and the submitter's exact email address. -5. Sync the QuickBooks Online connection in Expensify, then retry exporting the report. +5. In Expensify, select **Sync now** for the QuickBooks Online connection. Once the sync completes, retry exporting the report. --- @@ -51,4 +51,4 @@ Yes. A customer or employee record can use the name Expensify is trying to give ## Can I Fix This by Disabling Automatic Vendor Creation? -Disabling automatic creation does not resolve the name conflict or create a matching vendor/supplier. If you manage vendors manually, create a vendor/supplier with a unique name and the submitter's exact email, then sync and retry the export. +Disabling automatic creation does not resolve the name conflict or create a matching vendor/supplier. If you manage vendors manually, create a vendor/supplier with a unique name and the submitter's exact email, then select **Sync now** in Expensify and retry the export.