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 new file mode 100644 index 000000000000..b5f13d353bea --- /dev/null +++ b/docs/articles/new-expensify/connections/quickbooks-desktop/Connect-to-QuickBooks-Desktop.md @@ -0,0 +1,86 @@ +--- +title: QuickBooks Desktop +description: Easily connect Expensify to QuickBooks Desktop for streamlined expense management and accounting. +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. + +--- + +# 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 %} + +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. + + ![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**. + + ![QuickBooks Desktop confirmation](https://help.expensify.com/assets/images/QBO_desktop_05.png){:width="100%"} + +15. Click **Copy** to copy the password. + + ![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**. + + ![Paste password in Web Connector](https://help.expensify.com/assets/images/QBO_desktop_08.png){:width="100%"} + +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? + +- **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. + +## What versions of QuickBooks Desktop 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: + +- **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? + +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. + +## 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. 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 new file mode 100644 index 000000000000..67cf43373ffd --- /dev/null +++ b/docs/articles/new-expensify/connections/quickbooks-desktop/QuickBooks-Desktop-Troubleshooting.md @@ -0,0 +1,125 @@ +--- +title: QuickBooks Desktop troubleshooting +description: Resolve common QuickBooks Desktop integration issues with Expensify, including Web Connector, authentication, import, and export errors. +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. + +## 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: + +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 issues continue: + +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. + +--- + +# Connection or authentication issues + +These errors usually indicate a credential issue. + +## How to resolve + +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). +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**. +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). + +--- + +# Import issues or missing categories/tags + +These issues indicate the integration needs updating or QuickBooks version incompatibility. + +## How to resolve + +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. + +If unresolved, contact Concierge with details and QuickBooks screenshots. + +--- + +# Export or "can't find category/class/location/account" issues + +These errors usually generate a system message in Workspace Chat indicating the issue. + +## How to resolve + +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/)). + +If unresolved, contact Concierge with Report ID, context, and Expensify error screenshot. + +--- + +# “Oops!” error when syncing or exporting + +These errors can often be temporary or false alarms. + +## How to resolve + +1. Check if the sync/export was successful. +2. Retry syncing or exporting if unsuccessful. + +If persistent, download QuickBooks Desktop logs via Web Connector (**View Logs**) and contact Concierge. + +{% include info.html %} +If using a remote server (e.g., RightNetworks), contact their support for logs. +{% include end-info.html %} + +--- + +# Reports not exporting to QuickBooks Desktop + +Usually caused by the Web Connector or QuickBooks company file being closed during export. + +## How to resolve + +1. Ensure the Web Connector and QuickBooks Desktop company file are open. +2. In Web Connector, verify **Last Status** is "Ok". + +![Web Connector Status](https://help.expensify.com/assets/images/quickbooks-desktop-web-connector.png){:width="100%"} + +3. Check Workspace Chat in Expensify to confirm successful export. + +If unresolved, contact Concierge with Expensify Report ID and Web Connector screenshot.