# Quickbooks Desktop

**Here’s everything you need to know about the QBD integration and how it works with the Alternative Payments platform.**

***

Quickbooks Desktop is available for partners to use in conjunction with their Alternative Partner Dashboard to sync invoices to our platform and auto-reconcile invoice payments back to QBD. Once the integration is connected, a dropdown menu will appear in the Integrations section and partners can select the bank account in Quickbooks Desktop where they want deposits to be recorded.&#x20;

***

### **Overview of synced items & frequency**

| Sync Item           | Sync Frequency |
| ------------------- | -------------- |
| Invoice Details     | 5 mins         |
| Invoice Line Items  | 5 mins         |
| Customers           | 5 mins         |
| Payments            | 5 mins         |
| Deposits            | ❌              |
| Archiving invoices  | 5 mins         |
| Archiving customers | 5 mins         |
| Delete Payments     | 5 mins         |
| PDF Invoices        | ❌              |

{% hint style="info" %}
**NOTE:** *You can select how often you want the connector to sync. By default, it’s every 5 minutes and the sync time for these items will default to whatever is selected/updated.*
{% endhint %}

***

### **Quickbooks Desktop sync details**

| Item                            | Sync Details                                                                                                                                                                                                                   |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Invoice Status Update           | Invoice statuses updated in QBD will sync to Alternative Payments and vice versa (two-way sync). If a payment fails in Alternative Payments, it will revert the payment status back in QBD as well according to the sync time. |
| Changes to Unpaid Invoices      | Changes to unpaid invoices (amount and due date) in QBD will sync to Alternative Payments; changes to unpaid invoices in Alternative Payment will **not** sync back to QBD.                                                    |
| Partial Payments/Credits        | Any partial invoice payments/credits applied to an invoice in QBD will reflect in the outstanding balance of the invoice in Alternative Payments.                                                                              |
| Customer Created in Alternative | Customers created in Alternative Payments do **not** sync to QBD.                                                                                                                                                              |
| Invoices Created in Alternative | Invoices created in Alternative Payments do **not** sync to QBD.                                                                                                                                                               |
| Deleted Invoices and Customers  | Invoices and customers deleted in QBD sync back to Alternative Payments based on the connector sync time configuration.                                                                                                        |
| PDF Invoice                     | No PDF invoice is synced back to Alternative Payment,  however, line items are synced in from QBD into an internal invoice template.                                                                                           |

***

### **Quickbooks Desktop Overview**

* **Multi-computer/multi-server installation:** The initial setup for the connector needs to be installed by the ***Admin*** and can be installed on a server or computer where Quickbooks Desktop is installed. Once the initial connection is completed, it can then be installed on multiple computers / servers (*Alternative Payments will need to provide a specific link for other team members to install the connector on a different server/computer*). Ideally, it should be installed on the user’s computer/server they access who is spending the most time on Quickbooks Desktop.
* **Updating sync time:** By default the sync is every 5 minutes. To update your connector sync time within Quickbooks Desktop, navigate to File > App Management > Update Web Services. This will show the pop-up window to manage the Alternative Payments application and adjust the sync time. You will also be able to trigger a manual sync from here.
* **Payments and deposits:** Once the first initial sync is completed, you will need to select an account to record payments and an account to record deposits in the drop-downs within the Integrations section of your dashboard. It is recommended to select **"Undeposited Funds"** as the account for payments and a bank account for deposits. See our [**Quickbooks Desktop Reconciliation guide**](https://help.alternativepayments.io/integrations/accounting-integration-guides/quickbooks-desktop/quickbooks-desktop-reconciliation) for more detailed instructions.&#x20;

***

### **How to connect Quickbooks Desktop to your Partner Dashboard**

Connect your Quickbooks Desktop to make reconciliation easy by following these steps:

1. Make sure you’re on the computer/server with Quickbooks Desktop running and logged into the **Admin.**
2. Select ***Connect*** in the Quickbooks Desktop module with the ***Integrations*** section of your Alternative Payments dashboard.
3. **Input Quickbooks Desktop Options:** A *“Connect with Alternative Payments”* Rutter window pop-up will appear. Enter both the **Company name** as well as the **Company File Path,** if available.&#x20;

{% hint style="info" %}
**NOTE:** *The Company File Path is important, as saving that will ensure that data is synced even when Quickbooks Desktop is not running (recommended) and if other users need to install the connector on their own computers/for their own accounts after the first initial installation is completed.*
{% endhint %}

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2FyIuB4JfXezsMwceau8vL%2Fqbd1.webp?alt=media&#x26;token=985961df-3b4f-4368-bf2f-a6b81a28827e" alt=""><figcaption></figcaption></figure>

4. **Download and Run the QuickBooks Desktop Web Connector**: Click on the **QWC file** to download the connector. Open your QuickBooks Desktop application. Navigate to File -> App Management -> Update web services. This will launch the QBD Web Connector.

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2FTfK5OyRMaZ7NH3nRiGQZ%2Fqbd2.webp?alt=media&#x26;token=114fc882-3028-4c20-a899-edd39f63f069" alt=""><figcaption></figcaption></figure>

5. **Add the Web Connector to QuickBooks Desktop**\
   \
   After the QBD Web Connector is open, you can either double click the "quickbooks.qwc" file you downloaded to open it in the Web Connector or you can select *"Add an application"* to add the qwc connector file. \
   \
   This **"Authorize New Web Service"** will pop up. Click on OK.

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2FoYCetOGJMek1bnZ5Qck5%2Fqbd-authorizewebconnector.webp?alt=media&#x26;token=2b0ff49e-d7a3-4945-958d-b71a13afdf5e" alt=""><figcaption></figcaption></figure>

6. An Application Permission popup will then appear. Recommendation is to select **“Yes, always allow access, even when my Quickbooks isn’t running.”** Please leave the box to allow access to personal data unchecked and click on "Continue."

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2F6MIcFQTleGAHhwnJTm89%2Fqbd-app-permission-1-1.webp?alt=media&#x26;token=e5f7c9d6-cf25-4fed-8f63-97f62487842b" alt=""><figcaption></figcaption></figure>

The Application permission confirmation window will pop up. Please select "Confirm."

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2Fj3KEZJ30WuXkVMTz00PP%2Fqbd-app-permission-2.webp?alt=media&#x26;token=fd783a10-bf19-4854-b8cd-4a573503f2c8" alt=""><figcaption></figcaption></figure>

7. **Start Sync and Add Password**\
   \
   In the QBD web connector, you will see an Alternative Payments connector application showing. Select the checkbox next to the Alternative Payments app, then select “Update Selected.”&#x20;

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2FoEQfWpGUK2Rv8rOfVUnA%2Fqbd3-1%20copy.jpg?alt=media&#x26;token=9548faa6-af55-4fe9-9b98-d36beac8083e" alt=""><figcaption></figcaption></figure>

8. Navigate back to the Rutter window pop-up and copy the unique password. Input the password for the application back into the QBD web connector.&#x20;

{% hint style="info" %}
***Note:** Make sure to keep the password stored in case you need to re-input.*
{% endhint %}

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2FqvYFvhNXZzV9qYWKdysI%2Fqbd-password.webp?alt=media&#x26;token=a37d6f3d-6d3b-43b2-9af3-8ceea6c9667b" alt=""><figcaption></figcaption></figure>

9. A window will automatically pop up prompting you to Save the password. (If it doesn't pop up automatically, select the Tab button on your keyboard).&#x20;

{% hint style="info" %}
*This password is critical as connection syncs will not function correctly unless the end user is able to add this password into QuickBooks Desktop.*
{% endhint %}

The sync will begin running. The Application Progress bar will run through then the Total Progress bar will run through.&#x20;

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2F3gygBZfw8VkWI9jTWD8D%2Fqbd4-1.webp?alt=media&#x26;token=dc7bd1f0-9b71-433e-a805-59755e746286" alt=""><figcaption></figcaption></figure>

10. Once the sync has authenticated, the original download link window will show Authentication Complete!

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2FBWYwgMOnvPcTY865BrlX%2FScreen%20Shot%202024-11-19%20at%2011.33.04%20AM.png?alt=media&#x26;token=880eb77c-f57d-4cea-9974-c4a2e9c30494" alt=""><figcaption></figcaption></figure>

The sync will still run in the Quickbooks Windows Connector pop up until the progress bars for both hits 100%.&#x20;

{% hint style="info" %}
***NOTE:** The integration will first sync the last 12 months of data, then it will sync in historical data. Sync completion time will vary depending on the amount of data that is within Quickbooks Desktop.*&#x20;
{% endhint %}

**Love our platform?** Rate us on [Channel Program](https://channelprogram.com/v/alternativepayments) and check out our [Referral Program page](https://www.alternativepayments.io/referral-partners/)!
