# Configure QuickBooks Companies

Before configuring QuickBooks companies, let's have a look at the attributes based on which the QuickBooks data is synced:

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuXy1RH3hLqMSKHF1f%2FConfig%20QB%20Attributes.png?alt=media\&token=43aa5cf7-906a-46d2-81cb-91bacbd7fb33)

* **Account Attribute:** This is a dropdown that populates all the **Lookup** as well as **Option Set** fields on **Account** entity. You have to select value which would be considered as criteria for syncing data from CRM to QuickBooks and vice-versa. The default value is considered **Owning Business Unit**.
* **Contact Attribute:** This drop-down populates all the **Lookup** as well as **Option Set** fields on **Contact** entity. You have to select value which would be considered as criteria for syncing data from CRM to QuickBooks, and vice-versa. The default value is considered **Owning Business Unit**.
* **Use Field Service Tax:** Field Service Tax works only for **US QuickBooks companies**. This is a dropdown that gives the user an option to either choose **Field Service Tax** entity or **InoLink Tax** entity. Tax data would be synced in the chosen tax entity. If the user has selected **No**, then **InoLink Tax** entity would be considered, if the user has selected **Yes**, then **Field Service Tax** entity would be considered. If **Field Service Tax** is set as **‘Yes’**, then **Tax Code** and **Tax Code** **Details** (Field Service tax entities) privilege must be given to **InoLink security roles** for Tax synchronization.

{% hint style="info" %}
**Note: Selected values of Account and Contact Attribute must be the same.**
{% endhint %}

### Configuring Single or Multiple QuickBooks companies

QuickBooks Company can be synced on basis of **Lookup** values or **Option Set** fields.

#### Case 1: Configuring Dynamics 365 CRM with 1 QuickBooks Company.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuYABhg-B7Q0k1BQQP%2FConfig%20QB%20Case1.1.png?alt=media\&token=1541c2d2-3ff0-45cf-a8f0-341f5c0304a5)

* **Company Name:** It will display the name of the QuickBooks Company. Initially, it will be empty, once the company data has been saved, you can see the name of the company.

{% hint style="info" %}
**Note: User cannot add the same company twice at the same time. As once the company is added it is saved in QuickBooks Companies section. The user can add the same Company again after removing the Company from the selected list.**
{% endhint %}

* **Country:** It will display the country of QuickBooks Company. Initially, it will be empty, once the company data has been saved, you can see the country.
* **Base Currency:** It will display the base currency of QuickBooks Company. Initially, it will be empty, once the company data has been saved, you can see the base currency.
* **OAuth Version:** Select the OAuth version of the QuickBooks Company.
* **Use Sandbox:** Select **Yes** for configuring company of the **Sandbox** environment and **No** for configuring company of **Production/Live** environment.
* **OAuth Consumer Key/Client ID:** This depends on the OAuth version of QuickBooks i.e. **OAuth 1.0 or OAuth 2.0.** You need to copy the key obtained from the QuickBooks Developer/Production Account App as mentioned in the [Prerequisites.](https://docs.inogic.com/inolink/inolink-settings/enable-and-connect-dynamics-365-and-quickbooks-system/connect-and-configure-quickbooks#prerequisites)
* **OAuth Consumer Secret/Client Secret:** This depends on the OAuth version of **OAuth 1.0 or OAuth 2.0.** You need to copy the key obtained from the QuickBooks Developer/Production Account App as mentioned in the [Prerequisites.](https://docs.inogic.com/inolink/inolink-settings/enable-and-connect-dynamics-365-and-quickbooks-system/connect-and-configure-quickbooks#prerequisites)
* **Owning Business Unit:** Select which **Business Unit** to be considered for syncing the data from CRM to QB and vice-versa. If you select **Root/Parent BU,** then all CRM data would be integrated with configured QB Company. If you select a **child BU**, then only records of selected child BU would be integrated with QB.
* **User:** Select a **CRM user** under whom the records would be created (i.e. Owner of the record would be the selected CRM user).

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuYKxcK-hLhyrPM0qm%2FConfig%20QB%20Case1.2.png?alt=media\&token=e22a2f70-8a76-4b87-8c27-7d08537ffff5)

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuYRU4cSpF5Zzr8Xub%2FConfig%20QB%20Case1.3.png?alt=media\&token=a7b4c36d-ef96-4675-92ed-6fcedf39a395)

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuYZTw_TuKpbrf3GMH%2FConfig%20QB%20Case1.4.png?alt=media\&token=003695e9-d6fc-44dd-a5dc-3a2b6dbda509)

After clicking on **Authorize & Save** button you will get the above message to proceed further. Once you click on **Yes** you will be redirected to **sign in your QuickBooks system**. There you need to select the required company with which you want to sync Dynamics 365 CRM.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FLQccmLacVYaC3gmjwybA%2FQB%20Company%20Selection.png?alt=media\&token=38f0c168-aaa3-4a62-b131-a195f77726b3)

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuYmgWZ41OltmgiNrj%2FConfig%20QB%20Case1.6.png?alt=media\&token=80de272c-53cf-48b4-ae41-7e16415170f2)

After clicking on Connect you will get success message as shown below:

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuYuAKpejzL9wjFmhU%2FConfig%20QB%20Case1.7.png?alt=media\&token=58e46e58-9e19-4a87-81c1-bfd201a67c84)

#### Case 2: Configuring Dynamics 365 CRM with Multiple QuickBooks Company.

Click on **(+) Add** button to configure more than one QuickBooks company and fill the required details as shown in below screenshot:

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuZ2qpRBwMTjtMs4r9%2FConfig%20QB%20Case2.1.png?alt=media\&token=9d80e1e9-6eb3-4fe9-90c9-ca03a159426b)

Now, you need to click on **Authorize & Save** button and you will re-directed to QuickBooks company list screen. In case you are not logged-in to QuickBooks then you will be re-directed to **Sign in** page. Next, select the required company with which you want to sync Dynamics 365 CRM.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuZBjDRzvQHlzvYwWI%2FConfig%20QB%20Case2.2.png?alt=media\&token=736bf82c-8e76-4f98-be9f-46bb30910643)

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FLQccmLacVYaC3gmjwybA%2FQB%20Company%20Selection.png?alt=media\&token=38f0c168-aaa3-4a62-b131-a195f77726b3)

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuZRP432TTxWs-ifAE%2FConfig%20QB%20Case2.4.png?alt=media\&token=facbe237-0080-4100-8719-b18d73e1e4d0)

After clicking on **Connect** you will get success message as shown below:

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuZYKZ3vgTpKLTM22X%2FConfig%20QB%20Case2.5.png?alt=media\&token=a755bc3b-511b-4c37-9117-c7f0ef4ac834)

{% hint style="info" %}
**Note: If users configure the Root/Parent Business Unit for the first time in QuickBooks Companies then they cannot add and configure the multiple QuickBooks companies. Only when the Child Business Unit is added for the first time the user can configure multiple QuickBooks companies.**
{% endhint %}

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuZh2QmBbEYMXpUaLD%2FConfig%20QB%20Case2.6.png?alt=media\&token=1f1802c1-43cf-4c25-a33b-ebff9d7120a1)

{% hint style="info" %}
**Note: If users configure the Child Business Unit for the first time in QuickBooks Companies and try to add another company with Root Business Unit then the user gets the below error. Once the company is linked with particular child business unit then user can only select child business unit to configure another QuickBooks company.**&#x20;
{% endhint %}

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuZn-NB6Oeoj6TnofK%2FConfig%20QB%20Case2.7.png?alt=media\&token=285e3aff-1009-4d30-94aa-b276a2a1b809)

{% hint style="info" %}
**Note: If the user wants to delete the selected company from InoLink Settings then he/she first needs to unlink the Accounts/Contacts/Products. After doing so there is an option of Remove QuickBooks Companies as shown below.**
{% endhint %}

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-MeuZtO2CBzajS41XeD6%2FConfig%20QB%20Case2.8.png?alt=media\&token=df4c35f8-54ef-4f79-bf4a-78fa18377074)

#### InoLink Settings Display Window

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MeuUKBuvdc8ztrGcivf%2F-Meu_-DfjpsjCxqPNyah%2FConfig%20QB%20Case2.9.png?alt=media\&token=e757b6a6-7bd4-4878-b954-8898491ccb3d)

{% hint style="info" %}
**Note: QuickBooks side the status displayed is 'Mappings installation in process. This may take a while'. For integration between two systems i.e. Dynamics 365 and QB requires mappings to say which field of QuickBooks must map with which field of Dynamics 365 and vice versa. This status indicates that the mappings installation is in process.**
{% endhint %}

{% hint style="success" %}
For further queries, reach out to us at <crm@inogic.com>
{% endhint %}
