Merge pull request #84815 from Expensify/helpsite-quickbooks-desktop-new-and-classic

[No QA] Add QuickBooks Desktop troubleshooting docs (New + Classic)

Author: stephanieelliott

docs/articles/expensify-classic/connections/quickbooks-desktop/Troubleshooting/Authentication-and-Login-errors/DESK03-Error.md

@@ -0,0 +1,66 @@
+---
+title: DESK03 Error in QuickBooks Desktop Web Connector
+description: Learn how to resolve the DESK03 error in QuickBooks Web Connector when no data exchange is required due to cooldown timing.
+keywords: DESK03, QuickBooks Web Connector error, no data exchange required, QBWC cooldown, QuickBooks Desktop sync delay, Expensify QuickBooks Desktop sync error, Workspace Admin, accounting sync error
+internalScope: Audience is Workspace Admins using QuickBooks Desktop integration with Web Connector. Covers resolving the DESK03 error caused by Web Connector cooldown timing. Does not cover QuickBooks Online errors.
+---
+
+# DESK03 Error in QuickBooks Desktop Web Connector
+
+If you see the error:
+
+DESK03: No data exchange required.
+
+This means the QuickBooks Web Connector (QBWC) has temporarily delayed the next update.
+
+---
+
+## Why the DESK03 Error Happens in QuickBooks Web Connector
+
+The DESK03 error occurs because QuickBooks Web Connector enforces a cooldown period between updates.
+
+The delay is typically:
+
+- Three to five times the length of the previous run (sync or export).
+- Capped at a maximum of 60 minutes.
+
+For example:
+
+- If the previous sync took five minutes, the next update may not start for 15 to 25 minutes.
+
+This behavior is controlled by QuickBooks Web Connector, not Expensify.
+
+---
+
+## How to Fix the DESK03 Error
+
+In most cases, no action is required other than waiting.
+
+### If Auto-Run Is Enabled in QuickBooks Web Connector
+
+1. Wait for the next scheduled run.
+2. Monitor the **Last Result** column in QuickBooks Web Connector.
+3. Confirm it shows **OK**.
+4. Verify that the data synced or exported successfully.
+
+If the export did not complete, retry the export in Expensify after the cooldown period.
+
+### If Auto-Run Is Not Enabled
+
+1. Wait approximately 30 minutes (or until the cooldown period has passed).
+2. Confirm the **Last Result** shows **OK**.
+3. Retry the export or sync in Expensify.
+
+Once the cooldown period ends, the process should run normally without displaying the DESK03 message.
+
+---
+
+# FAQ
+
+## Is DESK03 an Error With Expensify?
+
+No. The cooldown behavior is enforced by QuickBooks Web Connector, not Expensify.
+
+## Can I Force the Sync to Run Immediately?
+
+No. QuickBooks Web Connector controls the cooldown timing and prevents updates from running until the required delay has passed.

docs/articles/expensify-classic/connections/quickbooks-desktop/Troubleshooting/Authentication-and-Login-errors/DESK08-Error.md

@@ -0,0 +1,100 @@
+---
+title: DESK08 Error in QuickBooks Desktop Web Connector
+description: Learn how to fix the DESK08 error in QuickBooks Desktop when Expensify cannot connect to the Web Connector or company file.
+keywords: DESK08, QuickBooks Desktop connection error, unable to reach QuickBooks Desktop, Web Connector not open, QuickBooks company file not open, run Web Connector as administrator, reinstall Web Connector, Expensify QuickBooks Desktop sync error, Workspace Admin
+internalScope: Audience is Workspace Admins using QuickBooks Desktop integration with Web Connector. Covers fixing the DESK08 error caused by connection issues between Expensify and QuickBooks Desktop. Does not cover QuickBooks Online errors.
+---
+
+# DESK08 Error in QuickBooks Desktop Web Connector
+
+If you see the error:
+
+DESK08: Unable to reach QuickBooks Desktop connection. Please confirm both Web Connector and QuickBooks company file are both open.
+
+This means Expensify cannot connect to QuickBooks Desktop through the Web Connector.
+
+---
+
+## Why the DESK08 Error Happens in QuickBooks Desktop
+
+The DESK08 error occurs when:
+
+- QuickBooks Desktop is not open.
+- The correct company file is not open.
+- QuickBooks Web Connector (QBWC) is not running.
+- The Web Connector is installed on a different machine than QuickBooks Desktop.
+- The Web Connector does not have sufficient permissions to connect.
+
+Expensify relies on the Web Connector to communicate with QuickBooks Desktop. If either application is not running or not accessible, the sync will fail.
+
+---
+
+## How to Fix the DESK08 Error
+
+### Step One: Confirm Both Applications Are Running
+
+1. Open **QuickBooks Desktop**.
+2. Open the correct **company file**.
+3. Launch **QuickBooks Web Connector**.
+4. Attempt to sync again from Expensify.
+
+---
+
+### Step Two: Confirm Web Connector Is Installed in the Correct Location
+
+Verify that the Web Connector is installed on the same machine where QuickBooks Desktop is installed:
+
+- If QuickBooks Desktop is installed on your local computer, the Web Connector must also be installed locally.
+- If QuickBooks Desktop is hosted on a remote server, the Web Connector must be installed on that same server.
+
+If they are installed on different machines, reinstall the Web Connector in the correct location.
+
+---
+
+### Step Three: Run Web Connector as Administrator
+
+If the error persists:
+
+1. Close QuickBooks Web Connector completely.
+2. Use **Task Manager** to confirm it is no longer running.
+3. Right-click the **QuickBooks Web Connector** icon.
+4. Select **Run as administrator**.
+5. Retry the sync.
+
+---
+
+### Step Four: Restart and Retry
+
+1. Restart **QuickBooks Desktop**.
+2. Reopen the correct company file.
+3. Open **QuickBooks Web Connector**.
+4. In Expensify:
+   - Go to **Settings**.
+   - Select **Workspaces**.
+   - Select your Workspace.
+   - Click **Accounting**.
+   - Click **Sync now**.
+5. Retry the sync.
+
+---
+
+### Step Five: Reinstall QuickBooks Web Connector
+
+If the issue continues:
+
+1. Uninstall **QuickBooks Web Connector**.
+2. Download and reinstall the latest version.
+3. Reconfigure the connection in Web Connector.
+4. Retry the sync.
+
+---
+
+# FAQ
+
+## Does DESK08 Mean My Data Is Lost?
+
+No. This error only indicates a connection issue. Your data remains in both Expensify and QuickBooks Desktop.
+
+## Does This Apply to QuickBooks Online?
+
+No. DESK08 applies only to QuickBooks Desktop integrations using the Web Connector.

docs/articles/expensify-classic/connections/quickbooks-desktop/Troubleshooting/Authentication-and-Login-errors/DESK15-Sync-Error.md

@@ -0,0 +1,70 @@
+---
+title: DESK15 Sync Error in QuickBooks Desktop Web Connector
+description: Learn how to fix the DESK15 sync error in QuickBooks Desktop by downloading and sharing Web Connector logs for review.
+keywords: DESK15, QuickBooks Desktop sync error, could not execute request, Web Connector log file, QBWC error log, Expensify QuickBooks Desktop connection issue, Workspace Admin, accounting sync error
+internalScope: Audience is Workspace Admins using QuickBooks Desktop integration with Web Connector. Covers resolving the DESK15 sync error by retrieving Web Connector logs. Does not cover QuickBooks Online errors.
+---
+
+# DESK15 Sync Error in QuickBooks Desktop Web Connector
+
+If you see the error:
+
+DESK15: Could not execute QuickBooks Desktop request.
+
+This means QuickBooks Web Connector was unable to process a request from Expensify, typically due to a connection or configuration issue.
+
+---
+
+## Why the DESK15 Sync Error Happens in QuickBooks Desktop
+
+The DESK15 error occurs when:
+
+- There is a communication issue between Expensify and QuickBooks Desktop.
+- QuickBooks Web Connector encounters an internal processing error.
+- The company file is not responding as expected.
+- Permission or hosting restrictions block the request.
+
+Further troubleshooting requires reviewing the QuickBooks Web Connector log file.
+
+---
+
+## How to Download the QuickBooks Web Connector Log File
+
+### If QuickBooks Is Installed Locally
+
+1. Open **QuickBooks Web Connector**.
+2. Click **View logs**.
+3. Save the downloaded log file to your computer.
+
+### If QuickBooks Is Hosted on a Server
+
+1. Contact your hosting provider.
+2. Ask them to open **QuickBooks Web Connector**.
+3. Have them click **View logs**.
+4. Request a copy of the downloaded log file.
+
+---
+
+## What to Do Next
+
+After downloading the log file:
+
+1. Share the log file with **Concierge**.
+2. Include:
+   - The Workspace name.
+   - The approximate time the error occurred.
+   - Any recent changes made to QuickBooks or the server environment.
+
+Concierge will review the log file to identify the root cause and provide next steps.
+
+---
+
+# FAQ
+
+## Can I Fix DESK15 Without the Log File?
+
+In most cases, no. The log file is required to determine the specific cause of the failure.
+
+## Does DESK15 Mean My Data Is Corrupted?
+
+No. This error indicates a failed request, not data loss. Your data remains intact in both Expensify and QuickBooks Desktop.

docs/articles/expensify-classic/connections/quickbooks-desktop/Troubleshooting/Authentication-and-Login-errors/DESK23-Error.md

@@ -0,0 +1,91 @@
+---
+title: DESK23 Error in QuickBooks Desktop Web Connector
+description: Learn how to fix the DESK23 error in QuickBooks Desktop when the wrong company file is open during sync.
+keywords: DESK23, QuickBooks Desktop wrong company file open, Web Connector company file error, QuickBooks Desktop sync error, reauthorize Web Connector, Expensify QuickBooks Desktop sync error, Workspace Admin
+internalScope: Audience is Workspace Admins using QuickBooks Desktop integration with Web Connector. Covers resolving the DESK23 error caused by incorrect or unauthorized company files. Does not cover QuickBooks Online errors.
+---
+
+# DESK23 Error in QuickBooks Desktop Web Connector
+
+If you see the error:
+
+DESK23: The wrong QuickBooks company file is open. Please close the file and reopen.
+
+This means QuickBooks Desktop has a different company file open than the one connected to your Expensify Workspace.
+
+---
+
+## Why the DESK23 Error Happens in QuickBooks Desktop
+
+The DESK23 error occurs when:
+
+- Multiple QuickBooks company files are open at the same time.
+- A company file that is not connected to the Expensify Workspace is open.
+- The Web Connector is trying to sync with a different file than the one currently active.
+
+Expensify can only sync with the specific company file that was originally authorized.
+
+---
+
+## How to Confirm the Correct Company File Is Open
+
+1. Open **QuickBooks Desktop**.
+2. Go to **File** > **Open or Restore Company**.
+3. Select the correct company file associated with your Expensify Workspace.
+4. Close any other open company files.
+5. Retry the sync in Expensify.
+
+If the correct company file is already open and the error persists:
+
+1. Completely close **QuickBooks Desktop**.
+2. Reopen QuickBooks Desktop.
+3. Open the correct company file.
+4. Retry the sync.
+
+---
+
+## How to Sync QuickBooks Desktop in Expensify
+
+1. In Expensify, go to **Settings**.
+2. Select **Workspaces**.
+3. Select your Workspace.
+4. Click **Accounting**.
+5. Click **Sync now**.
+
+If the error continues, proceed with reauthorization.
+
+---
+
+## How to Reauthorize the Web Connector
+
+1. Log in to **QuickBooks Desktop** in **Single-user mode** as an Admin.
+2. Go to **Edit** > **Preferences**.
+3. Select **Integrated Applications**.
+4. Click the **Company Preferences** tab.
+5. Locate the **Web Connector** entry.
+6. Remove the Web Connector from the list.
+7. Click **OK**.
+
+Then, in Expensify:
+
+1. Go to **Settings**.
+2. Select **Workspaces**.
+3. Select your Workspace.
+4. Click **Accounting**.
+5. Click **Sync now**.
+
+This will prompt reauthorization for QuickBooks Desktop. Complete the authorization process.
+
+Once reauthorized, the connection should sync successfully.
+
+---
+
+# FAQ
+
+## Can I Have Multiple Company Files Open During Sync?
+
+No. Only the specific company file connected to the Expensify Workspace should be open during sync.
+
+## Does This Apply to QuickBooks Online?
+
+No. DESK23 applies only to QuickBooks Desktop integrations using the Web Connector.