How to setup QuickBooks Desktop web connector

The following article outlines how to set up QuickBooks Desktop with the Web Connector app. Carefully read the QuickBooks Desktop Integration Overview page before beginning the setup process. Use the following article as a reference guide: Field Mapping for QuickBooks Desktop. 

Steps:

1. Create a user specifically for establishing the Procurify and QuickBooks Desktop connection. Using an existing user will cause the connection to fail.
2. Log into Procurify as the newly created user.
3. Navigate to Settings → Integrations
4. Under Procurify API, click View. If you do not see the Procurify API option or do not see the screen below, please reach out to a Procurify Representative.
5. In the text field, type "QBD API Credentials" and click Create application

   

6. The page will generate a Client ID and Client Secret. Important: These credentials are only displayed once. Use the copy button to paste them to a safe location. We recommend using a Password Vault application. 

   

7. The QuickBooks Web Connector can be downloaded here. We recommend always downloading the latest version. 

8. After download, and unzipping the file, you will see a installer.exe type file, run it.

   

9. After installation, QuickBooks Desktop Web Connected is usually located in C:\Program Files. We recommend making a shortcut on your Desktop. To locate the Web Connecter, do a Cortana search of key phrase "Web Connector". Note: The .exe file will not install or open if you do not have software install permissions on your Windows machine. If so, please reach out to your IT admin.

   

Now that you have installed the QuickBooks Web Connector, it’s time configure the integration between Procurify and QuickBooks Desktop.

Downloading Configuration Files from Procurify

1. Navigate to Settings → Integrations
2. Under QuickBooks Desktop, click Set Up

3. In the pop-up window, enter your database file path. Please read the article Finding your QuickBooks Desktop path on locating your file path. Important: ensure your file path is written in lower case, or you may encounter issues.

4. On the next page, you will find Web Connecter files for download using the drop down on the right. Ensure to download all 5 .qwc files onto your computer. 

Do not open these files when they are downloaded. You will need to edit these files following the steps below.

Configuring QuickBooks Web Connector Files

The following steps guide you on editing the Configuration files. The example screenshots will show the Vendor file as an example. The steps will need to be repeated for each of the five configuration files.

1. Open Windows Notepad or any simple text editor application/software. 
2. Drag and drop the Vendor configuration file previously downloaded into the empty notepad.
3. Replace the username (by default, an email address) with the Client ID from your Procurify API credentials. Ensure there are no spaces at the beginning and end, and that no brackets were removed in the process.

   

4. Save and close this file.

Repeat the above steps (replacing the default email UserName with the API ClientID) for the remaining Configuration files.

Setting up the Configuration

To install the configuration files you’ve downloaded, there are a few prerequisites:

• You must have permission to freely install/uninstall files on your Windows machine.
• You must have Admin access to your QuickBooks company file
  • There is ONLY ONE Admin account per QuickBooks company file, usually the person who created the file. If you are not sure, contact your IT admin.
• You must turn your QuickBooks company file to Single User Mode

Once you are ready, simply double-click on any downloaded configuration files, and you will see two QuickBooks Web Connector pop-ups.

• You may be prompted to enter a password. Enter the Client Secret generated in step 1.
• On the first pop-up, click OK to proceed.
• On the second pop-up, select the option “Yes, always; allow access even if QuickBooks is not running”, this will allow the integrations to run silently in the background without affecting other users.

  

Important: If any of the above steps fail, there should be an error pop-up window (view image below). Simply follow the instructions and triage the errors.  

With each successfully added configuration, you will see a new entry.

Upon running the sync, you will be prompted to enter a password. Use the API Client Secret each time. 

Once you've completed all the steps listed above, learn how to import Vendors and Account Codes from QuickBooks Desktop via the web connector.