Articles in this section
QuickBooks Online Version Integration
Table of Contents
Introduction
|
Vtiger’s integration creates automatic 2-way sync of data between the CRM and Quickbooks every time a record is updated or created.
|
About QuickBooks
QuickBooks is accounting software for small and medium-sized businesses. It comes in both on-premise and cloud-based versions. QuickBooks covers a wide range of accounting functions such as:
- Track expenses
- Manage payroll
- Generate reports
|
Feature Availability
|
|
|
|
| |
| |||||
|
|
|
|
|
|
Getting Started
Did you know that QuickBooks is an extension that you must install? It is not readily available in Vtiger, so you need to install it from Vtiger’s Extension Store and configure it.
Installation
Follow these steps to install QuickBooks:
- Log in to your CRM account.
- Click the Main Menu.
- Click Add-ons at the bottom left. This will take you to the Extension Store.
- Look for QuickBooks.
- Click Install.
- Click Yes to confirm the installation.
Configuration and Setup
Configuring QuickBooks will help establish a connection between Vtiger and QuickBooks. This is a one-time process.
Follow these steps to configure and set up QuickBooks:
- Log in to your CRM account.
- Click the Main Menu.
- Go to the List View of Contacts/Products/Services/Invoices/Vendors module.
- Click the Sync button on the top.
- Select QuickBooks and click Configure.
- Choose your QuickBooks edition from the drop-down.
- Click Proceed.
- Read the prerequisites carefully and click Connect with QuickBooks.
- If you are not logged into QuickBooks, you need to sign in using your QuickBooks credentials.
- If you are logged in, an authorization popup will appear. Click Authorize to proceed. Next, you will be redirected to the Vtiger QuickBooks page.
- Select Income Account and Expense Account details, which will be used while synchronizing products/services from Vtiger to QuickBooks.
- Click Save settings to proceed with the account mapping.
Synchronization Between Vtiger and QuickBooks
The sync process is straightforward and easy. With the sync, your contacts, products, services, vendors, and invoices are updated on both ends. This ensures that important fields are automatically mapped and you do not have to re-enter data.
|
Follow these steps to sync data:
- Log in to your CRM account
- Click the Main Menu
- Go to the List View of Contacts/Products/Services/Invoices/Vendors module
- Click the Sync button on the top
- Select QuickBooks
- Click Sync Settings
- Click on the checkbox beside the module you want to sync
- From the drop-down below, select the direction of sync:
- Sync QuickBooks data with Vtiger
- Sync Vtiger data with QuickBooks
- Sync Both Ways
- Click Save Settings
- Click Sync Now to start syncing records
- After records are synced successfully, the Sync Log displays the number of records created and updated on both ends in a tabular format
- Click on the numbers displayed under Created, Updated, Deleted, and Skipped columns to know the record details
|
Field Mapping
For any synchronization to be successful, mapping the fields is necessary to ensure information is transferred mutually.
|
The fields you can add are shown in the image below.

Let us now look at the fields that are mapped by default.
Synchronization of Contacts
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Vtiger to QuickBooks
The Display Name field is mandatory in QuickBooks. Hence First Name and Last Name fields are combined and displayed as Display Name in QuickBooks.
QuickBooks to Vtiger
- The Last Name field is mandatory in Vtiger. If the Last Name field in QuickBooks is empty, Display Name is taken as the Last Name in Vtiger CRM.
- If the Company field is empty, a default organization record QB Sync No Company is created, and a contact is associated with it.
Synchronization of Products and Services Data
|
|
|
|
|
|
|
|
|
|
Vtiger to QuickBooks
Products/Services is a single entity in QuickBooks, whereas Vtiger offers Products and Services as two different modules. During the sync process, Products and Services in Vtiger are jointly mapped as the Products/Services module in QuickBooks.
QuickBooks to Vtiger
- Records in Products are synced to Products module in Vtiger CRM.
- Records in Services are synced to Services module in Vtiger CRM.
Synchronization of Vendor Data
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Synchronization of Vendor Data
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Purchase Order Synchronization
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Synchronization of Payment Data
|
|
|
|
|
|
|
|
|
|
Vtiger to QuickBooks
- Invoices that are not related to any Contact record in Vtiger CRM are not synced to QuickBooks.
- Vtiger CRM Invoices are not synced if handling charges are not enabled in QuickBooks.
- You can sync the Bundle product type in Vtiger to the bundle in QuickBooks if the product has the same name. Then, the Invoices will sync from Vtiger to QuickBooks with the bundle product info.
- If Tax Mode is set as Group in Vtiger, the total of all available taxes are passed over as a single tax to QuickBooks.
- If Tax Mode is set as Individual in Vtiger, the tax amount for individual line items will be calculated, and the total tax amount will be updated to QuickBooks.
- To successfully sync Vtiger Invoice with QuickBooks, add a group tax in QuickBooks, which includes all the selected taxes for a product or service in Vtiger.
- Any new tax added in QuickBooks gets auto-created in Vtiger after synchronization.
- Shipping and Handling charges total will be updated to Shipping in QuickBooks.
QuickBooks to Vtiger
- Invoice Tax Type in Vtiger will be set as Group or Individual depending on the data received from the QuickBooks Invoice.
- QuickBooks Shipping will be added to Vtiger Shipping and Handling Charges.
- Organization Name is mandatory to create an Invoice in Vtiger. After synchronization, the information in the Company field in QuickBooks Invoice will be populated as Organization Name in Vtiger.
- If the Company field is empty, QB Sync No Company Organization record is created in Vtiger, and an Invoice is associated with it.
Limitations
US-Edition
- When you perform the sync for the first time, all the taxes from QuickBooks will be copied to Vtiger.
- Vtiger Invoice with individual tax type should have the same taxes for all the line items.
- Shipping should be enabled from QuickBooks Company settings if you are tracking Shipping charges from Vtiger Invoice module.
Non-US Edition
- While syncing Invoices from QuickBooks to Vtiger, Currencies used in QB Invoices should exist in Vtiger.
- While syncing Invoices from QuickBooks to Vtiger, Shipping tax percentages should be the same in Vtiger and QuickBooks.
- At least one tax should be active in Vtiger to sync Invoices from Vtiger to QB.
- While syncing Invoice from Vtiger to QuickBooks, if tax values are zero, then the Invoice will be created in QuickBooks with mode as Out of scope of Tax.
- While syncing Products from Vtiger to QuickBooks, Income account and Expense account will be mapped from the details you provided.
- Invoice in Vtiger with individual tax type having group level discounts and item level discounts will be skipped
- If any of the line items in Vtiger is not having taxes in individual mode, we will be checking for a zero value tax in QuickBooks and sync the Invoice. If Zero value tax is not available then Invoice will be skipped.
- When you do the first sync, all Sales taxes will be copied from QuickBooks to Vtiger and all purchase taxes will be skipped.