From ff228c5c22b771487573c3353e86d1ea4ae2d50f Mon Sep 17 00:00:00 2001 From: maddylewis <38016013+maddylewis@users.noreply.github.com> Date: Mon, 9 Jun 2025 13:56:55 -0400 Subject: [PATCH 1/5] Update Connect-to-QuickBooks-Desktop.md https://github.com/Expensify/Expensify/issues/482861 --- .../Connect-to-QuickBooks-Desktop.md | 91 +++++++++---------- 1 file changed, 44 insertions(+), 47 deletions(-) diff --git a/docs/articles/new-expensify/connections/quickbooks-desktop/Connect-to-QuickBooks-Desktop.md b/docs/articles/new-expensify/connections/quickbooks-desktop/Connect-to-QuickBooks-Desktop.md index b5f13d353bea..b3f5744db5b1 100644 --- a/docs/articles/new-expensify/connections/quickbooks-desktop/Connect-to-QuickBooks-Desktop.md +++ b/docs/articles/new-expensify/connections/quickbooks-desktop/Connect-to-QuickBooks-Desktop.md @@ -1,86 +1,83 @@ --- title: QuickBooks Desktop description: Easily connect Expensify to QuickBooks Desktop for streamlined expense management and accounting. +keywords: [New Expensify, QuickBooks Desktop, Web Connector, accounting integration, expense management] order: 1 --- -QuickBooks Desktop is accounting software developed by Intuit, designed for small and medium-sized businesses to manage financial tasks. Connecting Expensify to QuickBooks Desktop makes expense management seamless. +
-This guide walks you through connecting Expensify to QuickBooks Desktop, ensuring a smooth integration for managing your business expenses efficiently. +QuickBooks Desktop is accounting software designed for small and medium-sized businesses. Connecting Expensify to QuickBooks Desktop streamlines your expense management and accounting workflows. ---- +To connect QuickBooks Desktop to Expensify, you must log in as an Admin in QuickBooks Desktop. Make sure **the company file you want to connect to is the only one open**. -# Connect to QuickBooks Desktop +--- -{% include info.html %} -To connect QuickBooks Desktop to Expensify, you must log into QuickBooks Desktop as an Admin. The company file you want to connect must be the only one open. -{% include end-info.html %} +# Step 1: Start the Setup in Expensify -1. In Expensify, click your profile image or icon in the bottom-left menu. -2. Scroll down and click **Workspaces** in the left menu. -3. Select the workspace to connect to QuickBooks Desktop. -4. Click **More features** in the left menu. -5. In the **Integrate** section, enable the **Accounting** toggle. -6. Click **Accounting** in the left menu. -7. Click **Set up** next to QuickBooks Desktop. -8. Click **Copy** to copy the link. Paste this link into the computer running QuickBooks Desktop. -9. Select your QuickBooks Desktop version. +1. From the left-hand menu, select **Workspaces** +2. Choose the workspace you want to connect to +3. Click **More features** in the left-hand menu +4. In the **Integrate** section, toggle on **Accounting** +5. Click **Accounting** in the left-hand menu +6. Click **Set up** next to QuickBooks Desktop +7. Click **Copy** to copy the link, then paste the link into the computer that runs QuickBooks Desktop +8. Select your QuickBooks Desktop version ![QuickBooks Desktop version selection](https://help.expensify.com/assets/images/QBO_desktop_02.png){:width="100%"} -10. Download the Web Connector and follow the installation instructions. -11. Open the Web Connector. -12. When prompted during setup, download the config file and open it using File Explorer. This will automatically load the application into the QuickBooks Web Connector. - -{% include info.html %} -Ensure the correct company file is open in QuickBooks Desktop and is the only one open. -{% include end-info.html %} - -13. In QuickBooks Desktop, select **Yes, always allow access, even when QuickBooks is not running**, then click **Continue**. - - ![QuickBooks Desktop access permission](https://help.expensify.com/assets/images/QBO_desktop_04.png){:width="100%"} +--- -14. Click **OK**, then click **Yes**. +# Step 2: Install and Launch the Web Connector - ![QuickBooks Desktop confirmation](https://help.expensify.com/assets/images/QBO_desktop_05.png){:width="100%"} +1. Download the Web Connector and follow the installation instructions +2. Open the Web Connector +3. When prompted, download the config file and open it using File Explorer. This will automatically load the application into the Web Connector -15. Click **Copy** to copy the password. +Make sure the correct company file is open in QuickBooks Desktop and that it’s the only one open. - ![Copy Web Connector password](https://help.expensify.com/assets/images/QBO_desktop_06.png){:width="100%"} +--- -16. Paste the password into the Password field of the Web Connector and press **Enter**. +# Step 3: Authorize and Finalize the Connection\ - ![Paste password in Web Connector](https://help.expensify.com/assets/images/QBO_desktop_08.png){:width="100%"} +1. In QuickBooks Desktop, select **Yes, always allow access, even when QuickBooks is not running**, then click **Continue** +2. Click **OK**, then click **Yes** +3. Click **Copy** to copy the password +4. Paste the password into the **Password** field in the Web Connector and press **Enter** +5. Click **Yes** to save the password. The new connection will appear in the Web Connector. Save this password in a secure password manager. You'll need it for future configuration updates or troubleshooting. -17. Click **Yes** to save the password. The new connection will appear in the Web Connector. ![Save Web Connector password](https://help.expensify.com/assets/images/QBO_desktop_07.png){:width="100%"} -{% include info.html %} -Securely save this password in a trusted password manager. You'll need it for future configuration updates or troubleshooting. -{% include end-info.html %} - --- # FAQ -## What are the hardware and software requirements for QuickBooks Desktop connector? +## What are the hardware and software requirements? -- **Hardware requirements**: Ensure the host machine meets [Intuit's recommended specifications](https://quickbooks.intuit.com/learn-support/en-us/help-article/install-products/system-requirements-quickbooks-desktop-2022/L9664spDA_US_en_US). -- **Software requirements**: Windows 10 or 11 with the latest service packs installed. Users have run the connector on older Windows versions, but we don't officially support them. The Web Connector doesn't run on Mac OS. +- **Hardware**: Refer to [Intuit’s system requirements](https://quickbooks.intuit.com/learn-support/en-us/help-article/install-products/system-requirements-quickbooks-desktop-2022/L9664spDA_US_en_US) +- **Software**: Windows 10 or 11 with the latest service packs. While some users report success with older versions, these are not officially supported. The Web Connector does not run on Mac OS. -## What versions of QuickBooks Desktop are supported? +## Which QuickBooks Desktop versions are supported? -Expensify follows [Intuit’s service discontinuation policy](https://quickbooks.intuit.com/learn-support/en-us/help-article/feature-preferences/quickbooks-desktop-service-discontinuation-policy/L17cXxlie_US_en_US) and supports these versions: +Expensify supports: -- **Latest three versions** of QuickBooks Desktop (US, Canada) +- The **latest three versions** of QuickBooks Desktop (US, Canada) - **Version tiers**: Accountant, Pro, Pro Plus, Premier, Premier Plus, Enterprise - **Special editions**: Contractor, Manufacturing and Wholesale, Accountant, Professional Services, Nonprofit -## Can multiple QuickBooks Desktop Connectors be installed on the same machine? +Expensify follows [Intuit’s service discontinuation policy](https://quickbooks.intuit.com/learn-support/en-us/help-article/feature-preferences/quickbooks-desktop-service-discontinuation-policy/L17cXxlie_US_en_US) + +## Can I install multiple QuickBooks Desktop connectors? -Yes. Install one connector per company file. You can install multiple connectors to sync multiple company files to Expensify from one computer. Ensure you're logged into the correct QuickBooks company file when syncing. +Yes. You can install one connector per company file. Multiple connectors can run from the same computer. Just ensure you're logged into the correct company file before syncing. ## Can I export negative expenses? -Generally, yes. However, if you select **Check** as your export option, the report’s total cannot be negative. This also applies to non-reimbursable expenses exported as debit card transactions. Because QuickBooks Desktop doesn't support debit cards, transactions export as a non-reimbursable check, which must have a positive total amount. +Yes, in general. However: + +- If you select **Check** as your export option, the total report amount cannot be negative +- This also applies to debit card exports (QuickBooks Desktop treats these as non-reimbursable checks) +- Non-reimbursable checks must have a **positive** amount + +
From df947c43b5ed37a8467870e00a5ba03ac9d4e9dc Mon Sep 17 00:00:00 2001 From: maddylewis <38016013+maddylewis@users.noreply.github.com> Date: Mon, 9 Jun 2025 13:58:54 -0400 Subject: [PATCH 2/5] Update Connect-to-QuickBooks-Desktop.md --- .../quickbooks-desktop/Connect-to-QuickBooks-Desktop.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/articles/new-expensify/connections/quickbooks-desktop/Connect-to-QuickBooks-Desktop.md b/docs/articles/new-expensify/connections/quickbooks-desktop/Connect-to-QuickBooks-Desktop.md index b3f5744db5b1..599f82252564 100644 --- a/docs/articles/new-expensify/connections/quickbooks-desktop/Connect-to-QuickBooks-Desktop.md +++ b/docs/articles/new-expensify/connections/quickbooks-desktop/Connect-to-QuickBooks-Desktop.md @@ -24,7 +24,7 @@ To connect QuickBooks Desktop to Expensify, you must log in as an Admin in Quick 7. Click **Copy** to copy the link, then paste the link into the computer that runs QuickBooks Desktop 8. Select your QuickBooks Desktop version - ![QuickBooks Desktop version selection](https://help.expensify.com/assets/images/QBO_desktop_02.png){:width="100%"} +![QuickBooks Desktop version selection](https://help.expensify.com/assets/images/QBO_desktop_02.png){:width="100%"} --- @@ -34,7 +34,7 @@ To connect QuickBooks Desktop to Expensify, you must log in as an Admin in Quick 2. Open the Web Connector 3. When prompted, download the config file and open it using File Explorer. This will automatically load the application into the Web Connector -Make sure the correct company file is open in QuickBooks Desktop and that it’s the only one open. +**Note:** Make sure the correct company file is open in QuickBooks Desktop and that it’s the only one open. --- @@ -46,8 +46,7 @@ Make sure the correct company file is open in QuickBooks Desktop and that it’s 4. Paste the password into the **Password** field in the Web Connector and press **Enter** 5. Click **Yes** to save the password. The new connection will appear in the Web Connector. Save this password in a secure password manager. You'll need it for future configuration updates or troubleshooting. - - ![Save Web Connector password](https://help.expensify.com/assets/images/QBO_desktop_07.png){:width="100%"} +![Save Web Connector password](https://help.expensify.com/assets/images/QBO_desktop_07.png){:width="100%"} --- From 1fe84c5e7c4d6e74530c424d6e1bbc1e549a4ac0 Mon Sep 17 00:00:00 2001 From: maddylewis <38016013+maddylewis@users.noreply.github.com> Date: Mon, 9 Jun 2025 14:05:42 -0400 Subject: [PATCH 3/5] Update Configure-QuickBooks-Desktop.md --- .../Configure-QuickBooks-Desktop.md | 122 ++++++++++-------- 1 file changed, 70 insertions(+), 52 deletions(-) diff --git a/docs/articles/new-expensify/connections/quickbooks-desktop/Configure-QuickBooks-Desktop.md b/docs/articles/new-expensify/connections/quickbooks-desktop/Configure-QuickBooks-Desktop.md index 90d2397e82f7..bddb5b5ef3d3 100644 --- a/docs/articles/new-expensify/connections/quickbooks-desktop/Configure-QuickBooks-Desktop.md +++ b/docs/articles/new-expensify/connections/quickbooks-desktop/Configure-QuickBooks-Desktop.md @@ -1,50 +1,53 @@ --- -title: Configure-QuickBooks-Desktop.md +title: Configure QuickBooks Desktop description: Learn how to connect and configure your QuickBooks Desktop integration with Expensify to manage imports, exports, and advanced accounting settings. -keywords: [QuickBooks Desktop, Expensify integration, accounting settings, import settings, export settings, QBD, configure QuickBooks Desktop] +keywords: \[QuickBooks Desktop, Expensify integration, accounting settings, import settings, export settings, QBD, configure QuickBooks Desktop] +order: 2 --- +
+ Connecting QuickBooks Desktop to Expensify helps streamline expense reporting, reimbursements, and accounting workflows. This guide walks you through connecting and configuring your import, export, and advanced settings for QuickBooks Desktop. --- # Step 1: Initial Connection -**Web/Desktop:** -1. Go to **Settings > Workspaces > [Workspace Name] > Accounting**. +1. From the left-hand menu, click **Workspaces > [Workspace Name] > Accounting > QuickBooks Desktop**. 2. Find QuickBooks Desktop in the list of integrations and click **Set up**. 3. You'll receive a Codat link URL that must be opened on the computer where QuickBooks Desktop is installed. 4. Open the provided link on your QuickBooks Desktop computer and follow the connection flow. 5. Once connected, you'll see a syncing screen while information imports from QuickBooks Desktop to Expensify. -**Mobile:** -Since QuickBooks Desktop is a desktop application, the connection process must be completed on the device that hosts QuickBooks Desktop. If you attempt to connect from a mobile device, you'll see a blocking screen directing you to complete the setup on your desktop. - --- # Step 2: Configure Import Settings These steps define how your QuickBooks Desktop data is pulled into Expensify. -1. Go to **Settings > Workspaces > [Workspace Name] > Accounting**. +1. From the left-hand menu, click **Workspaces > [Workspace Name] > Accounting > QuickBooks Desktop**. 2. Click the **Import** tab under the QuickBooks Desktop connection. 3. Choose which coding configurations to import from QuickBooks Desktop. For each configuration, you can manage its import status: - - **Chart of accounts**: Always imported and used as categories in Expensify. - - **Classes**: Can be imported as tags or report fields for class-level tracking. - - **Customers/projects**: Can be imported as tags or report fields for expense-level tracking. - - **Items**: Can be imported and used as tags for itemized coding. + + * **Chart of accounts**: Always imported and used as categories in Expensify. + * **Classes**: Can be imported as tags or report fields for class-level tracking. + * **Customers/projects**: Can be imported as tags or report fields for expense-level tracking. + * **Items**: Can be imported and used as tags for itemized coding. **Default Settings:** -- Classes are enabled as tags by default -- Customers/projects and Items are disabled by default + +* Classes are enabled as tags by default +* Customers/projects and Items are disabled by default 4. **For Classes and Customers/Projects**: Choose whether to import them as: - - **Tags**: Applied at the expense level - - **Report fields**: Applied at the report level + + * **Tags**: Applied at the expense level + * **Report fields**: Applied at the report level 5. **Control your imports**: - - The interface will show the current import status for each item (e.g., "Imported as categories" or "Not imported"). - - Use the options provided to change these settings. + + * The interface will show the current import status for each item (e.g., "Imported as categories" or "Not imported"). + * Use the options provided to change these settings. --- @@ -52,35 +55,44 @@ These steps define how your QuickBooks Desktop data is pulled into Expensify. These settings control how Expensify exports reports and transactions to QuickBooks Desktop. -1. Under the **Accounting** tab, go to the **Export** section. -2. Configure the following settings: +1. From the left-hand menu, click **Workspaces > [Workspace Name] > Accounting > QuickBooks Desktop**. +2. Under the **Accounting** tab, go to the **Export** section. +3. Configure the following settings: **Basic Export Settings:** - - **Preferred Exporter**: Choose a Workspace Admin to automate report exports (defaults to workspace owner). - - **Note**: If exporting company card transactions, the preferred exporter must also be a Domain Admin. - - **Export Date**: Choose **date of last expense** (default), **export date**, or **submitted date**. + +* **Preferred Exporter**: Choose a Workspace Admin to automate report exports (defaults to workspace owner). + + * **Note**: If exporting company card transactions, the preferred exporter must also be a Domain Admin. +* **Export Date**: Choose **date of last expense** (default), **export date**, or **submitted date**. **Out-of-Pocket Expenses:** - - **Export out-of-pocket expenses as**: Choose from: - - **Vendor bill** (default) - - **Check** (includes option to mark as "print later" in QuickBooks Desktop) - - **Journal entry** (not supported if taxes are enabled) - - Select the appropriate bank account for each export type. + +* **Export out-of-pocket expenses as**: Choose from: + + * **Vendor bill** (default) + * **Check** (includes option to mark as "print later" in QuickBooks Desktop) + * **Journal entry** (not supported if taxes are enabled) +* Select the appropriate bank account for each export type. **Company Card Expenses:** - - **Export company card expenses as**: Choose from: - - **Credit card** (default) - - **Debit card** - - **Vendor bill** - - Configure accounts based on your selection: - - **Credit card account**: First credit card account in imported list (default) - - **Debit card account**: First bank account in imported list (default) - - **Accounts payable account**: First Accounts Payable account (for vendor bills) - - **Default vendor**: First vendor in imported list (for vendor bills) + +* **Export company card expenses as**: Choose from: + + * **Credit card** (default) + * **Debit card** + * **Vendor bill** +* Configure accounts based on your selection: + + * **Credit card account**: First credit card account in the imported list (default) + * **Debit card account**: First bank account in the imported list (default) + * **Accounts payable account**: First Accounts Payable account (for vendor bills) + * **Default vendor**: First vendor in the imported list (for vendor bills) **Expensify Card Transactions:** - - **Export Expensify Card transactions as**: Typically set to **Credit card**. - - Expensify Card transactions automatically export to an "Expensify Card Liability Account" created with the integration. + +* **Export Expensify Card transactions as**: Typically set to **Credit card**. +* Expensify Card transactions automatically export to an "Expensify Card Liability Account" created with the integration. --- @@ -88,16 +100,19 @@ These settings control how Expensify exports reports and transactions to QuickBo These options manage syncing behavior, automation preferences, and additional account settings. -1. Still in the **Accounting** section, select the **Advanced** tab. -2. Review and configure each setting (all default to enabled): - - **Auto-sync**: Enable this for Expensify to automatically sync with QuickBooks Desktop every day. - - **Invite employees**: Automatically invite employees to the workspace. - - **Auto-create entities**: Expensify will automatically create vendors in QuickBooks Desktop if they don't exist already. - - **Sync reimbursed reports**: Automatically sync reimbursed reports. +1. From the left-hand menu, click **Workspaces > [Workspace Name] > Accounting > QuickBooks Desktop**. +2. Still in the **Accounting** section, select the **Advanced** tab. +3. Review and configure each setting (all default to enabled): -3. **Account Selections:** - - **Bill payment account**: Select the account for bill payments (defaults to first option) - - **Invoice collections account**: Select the account for invoice collections (defaults to first option) + * **Auto-sync**: Enable this for Expensify to automatically sync with QuickBooks Desktop every day. + * **Invite employees**: Automatically invite employees to the workspace. + * **Auto-create entities**: Expensify will automatically create vendors in QuickBooks Desktop if they don't exist already. + * **Sync reimbursed reports**: Automatically sync reimbursed reports. + +4. **Account Selections:** + + * **Bill payment account**: Select the account for bill payments (defaults to the first option) + * **Invoice collections account**: Select the account for invoice collections (defaults to the first option) --- @@ -116,7 +131,7 @@ Due to QuickBooks Desktop being an offline platform, exports are asynchronous: ## Can I set up the QuickBooks Desktop integration from my mobile device? -No, the initial connection and most configuration must be done from a desktop/web browser. Since QuickBooks Desktop runs on a desktop computer, the integration setup requires access to that same computer. Mobile users will see a blocking screen directing them to complete setup on desktop. +No, the initial connection and most configuration must be done from a desktop or web browser. Since QuickBooks Desktop runs on a desktop computer, the integration setup requires access to that same computer. Mobile users will see a blocking screen directing them to complete the setup on a desktop. ## What happens if I try to export a report that's already been exported? @@ -128,7 +143,7 @@ No, **Locations** are a QuickBooks Online-only feature. For similar tracking in ## Why can't I export as a journal entry? -If **taxes** are enabled, exporting as a journal entry is not supported. You'll need to switch to exporting as a **check** or **vendor bill**. +If taxes are enabled, exporting as a journal entry is not supported. You'll need to switch to exporting as a check or vendor bill. ## How do I reconnect if my QuickBooks Desktop integration stops working? @@ -144,5 +159,8 @@ Yes. The QuickBooks Desktop integration is available on the **Control** plan. ## What's the difference between tags and report fields for Classes and Customers/Projects? -- **Tags**: Applied at the individual expense level, allowing different expenses on the same report to have different values -- **Report fields**: Applied at the report level, meaning all expenses on a report share the same value +* **Tags**: Applied at the individual expense level, allowing different expenses on the same report to have different values +* **Report fields**: Applied at the report level, meaning all expenses on a report share the same value + +
+ From 60d242dd9f9025d53128ad74672f792daa8ffa12 Mon Sep 17 00:00:00 2001 From: maddylewis <38016013+maddylewis@users.noreply.github.com> Date: Mon, 9 Jun 2025 14:08:54 -0400 Subject: [PATCH 4/5] Update Configure-QuickBooks-Desktop.md --- .../quickbooks-desktop/Configure-QuickBooks-Desktop.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/new-expensify/connections/quickbooks-desktop/Configure-QuickBooks-Desktop.md b/docs/articles/new-expensify/connections/quickbooks-desktop/Configure-QuickBooks-Desktop.md index bddb5b5ef3d3..898fe77d53fa 100644 --- a/docs/articles/new-expensify/connections/quickbooks-desktop/Configure-QuickBooks-Desktop.md +++ b/docs/articles/new-expensify/connections/quickbooks-desktop/Configure-QuickBooks-Desktop.md @@ -1,7 +1,7 @@ --- title: Configure QuickBooks Desktop description: Learn how to connect and configure your QuickBooks Desktop integration with Expensify to manage imports, exports, and advanced accounting settings. -keywords: \[QuickBooks Desktop, Expensify integration, accounting settings, import settings, export settings, QBD, configure QuickBooks Desktop] +keywords: [New Expensify, QuickBooks Desktop, Expensify integration, accounting settings, import settings, export settings, QBD, configure QuickBooks Desktop] order: 2 --- From 5be029adf3a63629110a43afaa2bc021bbfda2ea Mon Sep 17 00:00:00 2001 From: maddylewis <38016013+maddylewis@users.noreply.github.com> Date: Mon, 9 Jun 2025 14:11:56 -0400 Subject: [PATCH 5/5] Update QuickBooks-Desktop-Troubleshooting.md --- .../QuickBooks-Desktop-Troubleshooting.md | 140 +++++++++--------- 1 file changed, 67 insertions(+), 73 deletions(-) diff --git a/docs/articles/new-expensify/connections/quickbooks-desktop/QuickBooks-Desktop-Troubleshooting.md b/docs/articles/new-expensify/connections/quickbooks-desktop/QuickBooks-Desktop-Troubleshooting.md index 7efc8a52db76..a0e91ba677ed 100644 --- a/docs/articles/new-expensify/connections/quickbooks-desktop/QuickBooks-Desktop-Troubleshooting.md +++ b/docs/articles/new-expensify/connections/quickbooks-desktop/QuickBooks-Desktop-Troubleshooting.md @@ -1,125 +1,119 @@ --- -title: QuickBooks Desktop troubleshooting +title: QuickBooks Desktop Troubleshooting description: Resolve common QuickBooks Desktop integration issues with Expensify, including Web Connector, authentication, import, and export errors. +keywords: [New Expensify, QuickBooks Desktop, Web Connector, export error, sync issues, import missing categories, authentication issues] order: 3 --- -This article provides step-by-step solutions for common QuickBooks Desktop issues encountered when syncing with Expensify. Follow these troubleshooting steps to quickly address and resolve connectivity, authentication, import, and export problems. +
---- - -# The Web Connector cannot be reached - -These errors usually indicate a connection issue between Expensify and QuickBooks. +This guide provides step-by-step solutions for the most common issues, including Web Connector errors, authentication problems, and data import/export failures. -## How to resolve - -1. Ensure QuickBooks Desktop and the Web Connector are running. -2. Install the Web Connector in the same location as QuickBooks (local desktop or remote server). +--- -If the error persists: +# Web Connector cannot be reached -1. Completely close the Web Connector (use Task Manager if needed). -2. Right-click the Web Connector icon and select **Run as administrator**. -3. Sync your Expensify workspace again. +If you're seeing connection errors, it's likely due to an issue between QuickBooks and the Web Connector. -If issues continue: +## Steps to Fix -1. Quit and reopen QuickBooks Desktop. -2. In Expensify, go to **Settings > Workspaces**. -3. Select your workspace connected to QuickBooks Desktop. -4. Click **Accounting**. -5. Click the three vertical dots next to **QuickBooks Desktop**. -6. Click **Sync now**. -7. If unresolved, reinstall the Web Connector using the provided link. +1. Make sure both QuickBooks Desktop and the Web Connector are running. +2. Confirm that the Web Connector is installed in the same environment as QuickBooks (either local desktop or remote server). +3. If the error persists: + - Close the Web Connector completely (use Task Manager if necessary). + - Right-click the Web Connector and choose **Run as administrator**. + - Try syncing your Expensify workspace again. +4. Still not working? + - Quit and reopen QuickBooks Desktop. + - From the left-hand menu, go to **Workspaces > [Workspace Name] > Accounting**. + - Click the three dots next to **QuickBooks Desktop**, then select **Sync now**. + - If none of the above works, reinstall the Web Connector using the official link from QuickBooks. --- # Connection or authentication issues -These errors usually indicate a credential issue. +These typically occur when QuickBooks can't authenticate the Web Connector or Expensify. -## How to resolve +## Steps to Fix -1. Ensure QuickBooks Desktop is open with the correct company file. -2. Ensure the QuickBooks Web Connector is open and online. -3. Close any open dialogue boxes in QuickBooks Desktop and retry syncing or exporting. -4. Check permissions: log in to QuickBooks Desktop as Admin (single-user mode). +1. Open QuickBooks Desktop with the correct company file. +2. Make sure the QuickBooks Web Connector is online. +3. Close any open dialog boxes in QuickBooks and try syncing again. +4. Log in as Admin in single-user mode. 5. Go to **Edit > Preferences > Integrated Applications > Company Preferences**. - -![Company Preferences](https://help.expensify.com/assets/images/quickbooks-desktop-company-preferences.png){:width="100%"} - -6. Select the Web Connector and click **Properties**. - -![Web Connector Properties](https://help.expensify.com/assets/images/quickbooks-desktop-access-rights.png){:width="100%"} - -7. Check **Allow this application to login automatically** and click **OK**. +6. Select **Web Connector**, then click **Properties**. +7. Enable **Allow this application to login automatically**, then click **OK**. 8. Close all QuickBooks windows. -If unresolved, contact Concierge with: - -- QuickBooks Desktop version. -- Location of QuickBooks and company file (local or remote). -- Location of Web Connector (local or remote). -- Provider of remote environment (if applicable, e.g., RightNetworks). +**If issues persist, contact Concierge with the following details:** +- QuickBooks Desktop version +- Location of QuickBooks and company file (local or remote) +- Location of Web Connector +- Name of hosting provider (if remote, e.g., RightNetworks) --- -# Import issues or missing categories/tags +# Import issues or missing categories, or tags -These issues indicate the integration needs updating or QuickBooks version incompatibility. +These issues usually signal that the integration is outdated or not fully compatible. -## How to resolve +## Steps to Fix -1. Re-sync the connection from **Workspace Accounting** settings. -2. Verify configuration in QuickBooks. Expensify imports chart of accounts as categories or export account options, and imports projects, customers, and tags as tags. +1. Re-sync from **Workspaces > [Workspace Name] > Accounting**. +2. Check your QuickBooks configuration: + - Chart of accounts = categories/export accounts + - Projects, customers, and classes = tags in Expensify -If unresolved, contact Concierge with details and QuickBooks screenshots. +If issues persist, contact Concierge support with screenshots of your QuickBooks setup and error details. --- -# Export or "can't find category/class/location/account" issues +# Export errors or missing categories, classes, or accounts -These errors usually generate a system message in Expense Chat indicating the issue. +These errors often show up in Expense Chat during report export. -## How to resolve +## Steps to Fix -1. Re-sync the connection from **Workspace Accounting** settings. -2. Re-apply coding to expenses and re-export reports. -3. Verify your QuickBooks Desktop version supports the selected export option ([check compatibility](https://quickbooks.intuit.com/desktop/)). +1. Re-sync from **Workspaces > [Workspace Name] > Accounting > QuickBooks Desktop**. +2. Re-apply the coding on your expenses and re-export the report. +3. Make sure your QuickBooks Desktop version supports the export feature you’re using ([check compatibility](https://quickbooks.intuit.com/desktop/)). -If unresolved, contact Concierge with Report ID, context, and Expensify error screenshot. +**If issues persist, contact Concierge support with the following details:** +- The Report ID +- Screenshot of the error in Expensify +- Details about the export issue --- -# “Oops!” error when syncing or exporting +# Error: “Oops!” error when syncing or exporting -These errors can often be temporary or false alarms. +This message may appear even if the sync or export worked. -## How to resolve +## Steps to Fix -1. Check if the sync/export was successful. -2. Retry syncing or exporting if unsuccessful. +1. Check whether the action actually succeeded. +2. Retry syncing or exporting if needed. -If persistent, download QuickBooks Desktop logs via Web Connector (**View Logs**) and contact Concierge. +If the error keeps showing: +- Open the Web Connector +- Click **View Log** to download the QuickBooks Desktop logs +- Contact Concierge and share the logs -{% include info.html %} -If using a remote server (e.g., RightNetworks), contact their support for logs. -{% include end-info.html %} +**Note:** If you're using a remote server (e.g., RightNetworks), contact their support for help retrieving logs. --- # Reports not exporting to QuickBooks Desktop -Usually caused by the Web Connector or QuickBooks company file being closed during export. - -## How to resolve +This usually means QuickBooks or the Web Connector was closed during the export attempt. -1. Ensure the Web Connector and QuickBooks Desktop company file are open. -2. In Web Connector, verify **Last Status** is "Ok". +## Steps to Fix -![Web Connector Status](https://help.expensify.com/assets/images/quickbooks-desktop-web-connector.png){:width="100%"} +1. Ensure QuickBooks Desktop and the Web Connector are both open. +2. In Web Connector, confirm the **Last Status** reads “Ok”. +3. Check the associated Expense Chat in Expensify to verify if the export was successful. -3. Check Expense Chat in Expensify to confirm successful export. +Still not exporting? Share the Report ID and a screenshot of your Web Connector with Concierge. -If unresolved, contact Concierge with Expensify Report ID and Web Connector screenshot. +