Skip to content

Commit a3e39d2

Browse files
rlinozrlinoz
authored
Merge pull request Expensify#63769 from Expensify/maddylewis-patch-7
[NO QA] Update Connect-to-QuickBooks-Desktop.md
2 parents 8b62aa4 + 5be029a commit a3e39d2

3 files changed

Lines changed: 183 additions & 175 deletions

File tree

‎docs/articles/new-expensify/connections/quickbooks-desktop/Configure-QuickBooks-Desktop.md‎

Lines changed: 70 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -1,103 +1,118 @@
11
---
2-
title: Configure-QuickBooks-Desktop.md
2+
title: Configure QuickBooks Desktop
33
description: Learn how to connect and configure your QuickBooks Desktop integration with Expensify to manage imports, exports, and advanced accounting settings.
4-
keywords: [QuickBooks Desktop, Expensify integration, accounting settings, import settings, export settings, QBD, configure QuickBooks Desktop]
4+
keywords: [New Expensify, QuickBooks Desktop, Expensify integration, accounting settings, import settings, export settings, QBD, configure QuickBooks Desktop]
5+
order: 2
56
---
67

8+
<div id="new-expensify" markdown="1">
9+
710
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.
811

912
---
1013

1114
# Step 1: Initial Connection
1215

13-
**Web/Desktop:**
14-
1. Go to **Settings > Workspaces > [Workspace Name] > Accounting**.
16+
1. From the left-hand menu, click **Workspaces > [Workspace Name] > Accounting > QuickBooks Desktop**.
1517
2. Find QuickBooks Desktop in the list of integrations and click **Set up**.
1618
3. You'll receive a Codat link URL that must be opened on the computer where QuickBooks Desktop is installed.
1719
4. Open the provided link on your QuickBooks Desktop computer and follow the connection flow.
1820
5. Once connected, you'll see a syncing screen while information imports from QuickBooks Desktop to Expensify.
1921

20-
**Mobile:**
21-
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.
22-
2322
---
2423

2524
# Step 2: Configure Import Settings
2625

2726
These steps define how your QuickBooks Desktop data is pulled into Expensify.
2827

29-
1. Go to **Settings > Workspaces > [Workspace Name] > Accounting**.
28+
1. From the left-hand menu, click **Workspaces > [Workspace Name] > Accounting > QuickBooks Desktop**.
3029
2. Click the **Import** tab under the QuickBooks Desktop connection.
3130
3. Choose which coding configurations to import from QuickBooks Desktop. For each configuration, you can manage its import status:
32-
- **Chart of accounts**: Always imported and used as categories in Expensify.
33-
- **Classes**: Can be imported as tags or report fields for class-level tracking.
34-
- **Customers/projects**: Can be imported as tags or report fields for expense-level tracking.
35-
- **Items**: Can be imported and used as tags for itemized coding.
31+
32+
* **Chart of accounts**: Always imported and used as categories in Expensify.
33+
* **Classes**: Can be imported as tags or report fields for class-level tracking.
34+
* **Customers/projects**: Can be imported as tags or report fields for expense-level tracking.
35+
* **Items**: Can be imported and used as tags for itemized coding.
3636

3737
**Default Settings:**
38-
- Classes are enabled as tags by default
39-
- Customers/projects and Items are disabled by default
38+
39+
* Classes are enabled as tags by default
40+
* Customers/projects and Items are disabled by default
4041

4142
4. **For Classes and Customers/Projects**: Choose whether to import them as:
42-
- **Tags**: Applied at the expense level
43-
- **Report fields**: Applied at the report level
43+
44+
* **Tags**: Applied at the expense level
45+
* **Report fields**: Applied at the report level
4446

4547
5. **Control your imports**:
46-
- The interface will show the current import status for each item (e.g., "Imported as categories" or "Not imported").
47-
- Use the options provided to change these settings.
48+
49+
* The interface will show the current import status for each item (e.g., "Imported as categories" or "Not imported").
50+
* Use the options provided to change these settings.
4851

4952
---
5053

5154
# Step 3: Configure Export Settings
5255

5356
These settings control how Expensify exports reports and transactions to QuickBooks Desktop.
5457

55-
1. Under the **Accounting** tab, go to the **Export** section.
56-
2. Configure the following settings:
58+
1. From the left-hand menu, click **Workspaces > [Workspace Name] > Accounting > QuickBooks Desktop**.
59+
2. Under the **Accounting** tab, go to the **Export** section.
60+
3. Configure the following settings:
5761

5862
**Basic Export Settings:**
59-
- **Preferred Exporter**: Choose a Workspace Admin to automate report exports (defaults to workspace owner).
60-
- **Note**: If exporting company card transactions, the preferred exporter must also be a Domain Admin.
61-
- **Export Date**: Choose **date of last expense** (default), **export date**, or **submitted date**.
63+
64+
* **Preferred Exporter**: Choose a Workspace Admin to automate report exports (defaults to workspace owner).
65+
66+
* **Note**: If exporting company card transactions, the preferred exporter must also be a Domain Admin.
67+
* **Export Date**: Choose **date of last expense** (default), **export date**, or **submitted date**.
6268

6369
**Out-of-Pocket Expenses:**
64-
- **Export out-of-pocket expenses as**: Choose from:
65-
- **Vendor bill** (default)
66-
- **Check** (includes option to mark as "print later" in QuickBooks Desktop)
67-
- **Journal entry** (not supported if taxes are enabled)
68-
- Select the appropriate bank account for each export type.
70+
71+
* **Export out-of-pocket expenses as**: Choose from:
72+
73+
* **Vendor bill** (default)
74+
* **Check** (includes option to mark as "print later" in QuickBooks Desktop)
75+
* **Journal entry** (not supported if taxes are enabled)
76+
* Select the appropriate bank account for each export type.
6977

7078
**Company Card Expenses:**
71-
- **Export company card expenses as**: Choose from:
72-
- **Credit card** (default)
73-
- **Debit card**
74-
- **Vendor bill**
75-
- Configure accounts based on your selection:
76-
- **Credit card account**: First credit card account in imported list (default)
77-
- **Debit card account**: First bank account in imported list (default)
78-
- **Accounts payable account**: First Accounts Payable account (for vendor bills)
79-
- **Default vendor**: First vendor in imported list (for vendor bills)
79+
80+
* **Export company card expenses as**: Choose from:
81+
82+
* **Credit card** (default)
83+
* **Debit card**
84+
* **Vendor bill**
85+
* Configure accounts based on your selection:
86+
87+
* **Credit card account**: First credit card account in the imported list (default)
88+
* **Debit card account**: First bank account in the imported list (default)
89+
* **Accounts payable account**: First Accounts Payable account (for vendor bills)
90+
* **Default vendor**: First vendor in the imported list (for vendor bills)
8091

8192
**Expensify Card Transactions:**
82-
- **Export Expensify Card transactions as**: Typically set to **Credit card**.
83-
- Expensify Card transactions automatically export to an "Expensify Card Liability Account" created with the integration.
93+
94+
* **Export Expensify Card transactions as**: Typically set to **Credit card**.
95+
* Expensify Card transactions automatically export to an "Expensify Card Liability Account" created with the integration.
8496

8597
---
8698

8799
# Step 4: Configure Advanced Settings
88100

89101
These options manage syncing behavior, automation preferences, and additional account settings.
90102

91-
1. Still in the **Accounting** section, select the **Advanced** tab.
92-
2. Review and configure each setting (all default to enabled):
93-
- **Auto-sync**: Enable this for Expensify to automatically sync with QuickBooks Desktop every day.
94-
- **Invite employees**: Automatically invite employees to the workspace.
95-
- **Auto-create entities**: Expensify will automatically create vendors in QuickBooks Desktop if they don't exist already.
96-
- **Sync reimbursed reports**: Automatically sync reimbursed reports.
103+
1. From the left-hand menu, click **Workspaces > [Workspace Name] > Accounting > QuickBooks Desktop**.
104+
2. Still in the **Accounting** section, select the **Advanced** tab.
105+
3. Review and configure each setting (all default to enabled):
97106

98-
3. **Account Selections:**
99-
- **Bill payment account**: Select the account for bill payments (defaults to first option)
100-
- **Invoice collections account**: Select the account for invoice collections (defaults to first option)
107+
* **Auto-sync**: Enable this for Expensify to automatically sync with QuickBooks Desktop every day.
108+
* **Invite employees**: Automatically invite employees to the workspace.
109+
* **Auto-create entities**: Expensify will automatically create vendors in QuickBooks Desktop if they don't exist already.
110+
* **Sync reimbursed reports**: Automatically sync reimbursed reports.
111+
112+
4. **Account Selections:**
113+
114+
* **Bill payment account**: Select the account for bill payments (defaults to the first option)
115+
* **Invoice collections account**: Select the account for invoice collections (defaults to the first option)
101116

102117
---
103118

@@ -116,7 +131,7 @@ Due to QuickBooks Desktop being an offline platform, exports are asynchronous:
116131

117132
## Can I set up the QuickBooks Desktop integration from my mobile device?
118133

119-
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.
134+
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.
120135

121136
## What happens if I try to export a report that's already been exported?
122137

@@ -128,7 +143,7 @@ No, **Locations** are a QuickBooks Online-only feature. For similar tracking in
128143

129144
## Why can't I export as a journal entry?
130145

131-
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**.
146+
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.
132147

133148
## How do I reconnect if my QuickBooks Desktop integration stops working?
134149

@@ -144,5 +159,8 @@ Yes. The QuickBooks Desktop integration is available on the **Control** plan.
144159

145160
## What's the difference between tags and report fields for Classes and Customers/Projects?
146161

147-
- **Tags**: Applied at the individual expense level, allowing different expenses on the same report to have different values
148-
- **Report fields**: Applied at the report level, meaning all expenses on a report share the same value
162+
* **Tags**: Applied at the individual expense level, allowing different expenses on the same report to have different values
163+
* **Report fields**: Applied at the report level, meaning all expenses on a report share the same value
164+
165+
</div>
166+

‎docs/articles/new-expensify/connections/quickbooks-desktop/Connect-to-QuickBooks-Desktop.md‎

Lines changed: 46 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,86 +1,82 @@
11
---
22
title: QuickBooks Desktop
33
description: Easily connect Expensify to QuickBooks Desktop for streamlined expense management and accounting.
4+
keywords: [New Expensify, QuickBooks Desktop, Web Connector, accounting integration, expense management]
45
order: 1
56
---
67

7-
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.
8+
<div id="new-expensify" markdown="1">
89

9-
This guide walks you through connecting Expensify to QuickBooks Desktop, ensuring a smooth integration for managing your business expenses efficiently.
10+
QuickBooks Desktop is accounting software designed for small and medium-sized businesses. Connecting Expensify to QuickBooks Desktop streamlines your expense management and accounting workflows.
1011

11-
---
12-
13-
# Connect to QuickBooks Desktop
14-
15-
{% include info.html %}
16-
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.
17-
{% include end-info.html %}
18-
19-
1. In Expensify, click your profile image or icon in the bottom-left menu.
20-
2. Scroll down and click **Workspaces** in the left menu.
21-
3. Select the workspace to connect to QuickBooks Desktop.
22-
4. Click **More features** in the left menu.
23-
5. In the **Integrate** section, enable the **Accounting** toggle.
24-
6. Click **Accounting** in the left menu.
25-
7. Click **Set up** next to QuickBooks Desktop.
26-
8. Click **Copy** to copy the link. Paste this link into the computer running QuickBooks Desktop.
27-
9. Select your QuickBooks Desktop version.
28-
29-
![QuickBooks Desktop version selection](https://help.expensify.com/assets/images/QBO_desktop_02.png){:width="100%"}
30-
31-
10. Download the Web Connector and follow the installation instructions.
32-
11. Open the Web Connector.
33-
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.
12+
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**.
3413

35-
{% include info.html %}
36-
Ensure the correct company file is open in QuickBooks Desktop and is the only one open.
37-
{% include end-info.html %}
14+
---
3815

39-
13. In QuickBooks Desktop, select **Yes, always allow access, even when QuickBooks is not running**, then click **Continue**.
16+
# Step 1: Start the Setup in Expensify
4017

41-
![QuickBooks Desktop access permission](https://help.expensify.com/assets/images/QBO_desktop_04.png){:width="100%"}
18+
1. From the left-hand menu, select **Workspaces**
19+
2. Choose the workspace you want to connect to
20+
3. Click **More features** in the left-hand menu
21+
4. In the **Integrate** section, toggle on **Accounting**
22+
5. Click **Accounting** in the left-hand menu
23+
6. Click **Set up** next to QuickBooks Desktop
24+
7. Click **Copy** to copy the link, then paste the link into the computer that runs QuickBooks Desktop
25+
8. Select your QuickBooks Desktop version
4226

43-
14. Click **OK**, then click **Yes**.
27+
![QuickBooks Desktop version selection](https://help.expensify.com/assets/images/QBO_desktop_02.png){:width="100%"}
4428

45-
![QuickBooks Desktop confirmation](https://help.expensify.com/assets/images/QBO_desktop_05.png){:width="100%"}
29+
---
4630

47-
15. Click **Copy** to copy the password.
31+
# Step 2: Install and Launch the Web Connector
4832

49-
![Copy Web Connector password](https://help.expensify.com/assets/images/QBO_desktop_06.png){:width="100%"}
33+
1. Download the Web Connector and follow the installation instructions
34+
2. Open the Web Connector
35+
3. When prompted, download the config file and open it using File Explorer. This will automatically load the application into the Web Connector
5036

51-
16. Paste the password into the Password field of the Web Connector and press **Enter**.
37+
**Note:** Make sure the correct company file is open in QuickBooks Desktop and that it’s the only one open.
5238

53-
![Paste password in Web Connector](https://help.expensify.com/assets/images/QBO_desktop_08.png){:width="100%"}
39+
---
5440

55-
17. Click **Yes** to save the password. The new connection will appear in the Web Connector.
41+
# Step 3: Authorize and Finalize the Connection\
5642

57-
![Save Web Connector password](https://help.expensify.com/assets/images/QBO_desktop_07.png){:width="100%"}
43+
1. In QuickBooks Desktop, select **Yes, always allow access, even when QuickBooks is not running**, then click **Continue**
44+
2. Click **OK**, then click **Yes**
45+
3. Click **Copy** to copy the password
46+
4. Paste the password into the **Password** field in the Web Connector and press **Enter**
47+
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.
5848

59-
{% include info.html %}
60-
Securely save this password in a trusted password manager. You'll need it for future configuration updates or troubleshooting.
61-
{% include end-info.html %}
49+
![Save Web Connector password](https://help.expensify.com/assets/images/QBO_desktop_07.png){:width="100%"}
6250

6351
---
6452

6553
# FAQ
6654

67-
## What are the hardware and software requirements for QuickBooks Desktop connector?
55+
## What are the hardware and software requirements?
6856

69-
- **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).
70-
- **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.
57+
- **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)
58+
- **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.
7159

72-
## What versions of QuickBooks Desktop are supported?
60+
## Which QuickBooks Desktop versions are supported?
7361

74-
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:
62+
Expensify supports:
7563

76-
- **Latest three versions** of QuickBooks Desktop (US, Canada)
64+
- The **latest three versions** of QuickBooks Desktop (US, Canada)
7765
- **Version tiers**: Accountant, Pro, Pro Plus, Premier, Premier Plus, Enterprise
7866
- **Special editions**: Contractor, Manufacturing and Wholesale, Accountant, Professional Services, Nonprofit
7967

80-
## Can multiple QuickBooks Desktop Connectors be installed on the same machine?
68+
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)
8169

82-
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.
70+
## Can I install multiple QuickBooks Desktop connectors?
71+
72+
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.
8373

8474
## Can I export negative expenses?
8575

86-
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.
76+
Yes, in general. However:
77+
78+
- If you select **Check** as your export option, the total report amount cannot be negative
79+
- This also applies to debit card exports (QuickBooks Desktop treats these as non-reimbursable checks)
80+
- Non-reimbursable checks must have a **positive** amount
81+
82+
</div>

0 commit comments

Comments
 (0)