Articles in this section
QuickBooks Desktop Version Integration Stripe Integration in Vtiger Xero Integration Tally Integration - Cloud Tally Integration - OnPremise Razorpay Integration MYOB Accounting Integration Sage Business Accounting Integration Configure PayPal to process your payments

QuickBooks Online Version Integration

Learn all about integrating and using QuickBooks (Online Version) with Vtiger CRM.
B
Bindu Rekha Babu
10 Mar, 2026 - Updated  2 days ago

Feature Availability

Vtiger Editions: One Pilot | One Growth | One Professional | One Enterprise

Introduction

The QuickBooks integration enables seamless synchronization between Vtiger CRM and QuickBooks. This integration automatically performs a two-way sync whenever a record is created or updated in either application. By connecting Vtiger with QuickBooks, your sales and accounting teams can work with the same data without switching between systems. Records such as Contacts, Products, Vendors, Invoices, and Purchase Orders are synchronized, ensuring data consistency across both platforms.

About QuickBooks

QuickBooks is a widely used accounting software for small and medium-sized businesses. It is available in both cloud-based and on-premise versions.
QuickBooks helps businesses manage financial operations such as:

  • Tracking expenses
  • Managing payroll
  • Generating financial reports
  • Maintaining a Chart of Accounts

Chart of Accounts Add-on

The Chart of Accounts is an add-on available in the Vtiger Marketplace. You must install it separately. This add-on simplifies Product information updates between Vtiger and QuickBooks. It ensures that Product Income and Expense accounts are preserved during synchronization, preventing them from being overwritten.

How the Chart of Accounts works

The steps below show how the CoA works:

  1. Install the Chart of Accounts Add-on from the Vtiger Marketplace.
  2. Copy all Income and Expense accounts from QuickBooks to the Chart of Accounts in Vtiger (Settings).
  3. Add any missing account types in Vtiger.

During synchronization, the following mapping occurs:

  • QuickBooks Income Account to Vtiger Sales Account
  • QuickBooks Expense Account to Vtiger Purchase Account


Note: This feature is primarily designed for customers in the USA, UK, India, Australia, and Canada, but it can also be accessed by customers in other regions.

Benefits

The following are the benefits of integrating QuickBooks with Vtiger:

  • Eliminates duplicate data entry between sales and accounting teams.
  • Reduces errors during data exchange.
  • Enables access to customer billing information and payment details directly within Vtiger.
  • Allows users to create invoices from Quotes or Sales Orders in Vtiger and sync them with QuickBooks.
  • Ensures accurate synchronization of financial and customer data.

In this article, you will learn about:

  • Integrating QuickBooks with Vtiger
  • Syncing data between QuickBooks and Vtiger
  • Troubleshooting Tips

Configuring QuickBooks with Vtiger

You need to install the QuickBooks Add-on and configure it before integrating it with Vtiger CRM.  

Installing QuickBooks Add-on

Follow these steps to install QuickBooks:

  1. Log in to your CRM.
  2. Go to the main Menu.
  3. Click Add-ons. This will take you to the Add-ons page.
  4. Look for QuickBooks.
  5. Click Install.
  6. Click Yes to confirm the installation.

Configuring QuickBooks

Configuring QuickBooks will help establish a connection between Vtiger and QuickBooks. This is a one-time process.
Note: Log in to your QuickBooks account and Vtiger account and keep them open.

Follow these steps to configure and set up QuickBooks:

  1. Log in to your CRM.
  2. Go to the main Menu.
  3. Click Settings.
  4. Select QuickBooks under the Extensions tab.
  5. Click Proceed.
  6. Select QuickBooks Online from the QuickBooks editions drop-down menu.
  7. Read the prerequisites carefully and click Connect with QuickBooks. The authorization pop-up will appear.
  8. Click Authorize to proceed. Next, you will be redirected to the Vtiger QuickBooks page.
  9. Select Income Account and Expense Account details, which will be used while synchronizing products/services from Vtiger to QuickBooks.
  10. Click Save settings to proceed with the account mapping. You will then be redirected to the Sync Settings window.

Syncing Data

The integration supports automatic data synchronization between both platforms. Supported modules include:

  • Contacts
  • Products
  • Services
  • Vendors
  • Invoices
  • Purchase Orders

You can start synchronization from the List View of these modules.

Follow these steps to sync data: 

  1. Log in to your CRM.
  2. Go to the main Menu.
  3. Go to the List View of any of the Contacts/Products/Services/Invoices/Vendors module.
  4. Click Sync.
  5. Select QuickBooks.
  6. Click Sync Settings.
  7. Enable the Checkbox to sync the modules.
  8. Select sync direction from the following:
    1. Sync QuickBooks data with Vtiger
    2. Sync Vtiger data with QuickBooks
    3. Sync Both Ways
  9. Click Save Settings ​​​​​​to save the Sync Settings.
  10. Click Sync Now to start syncing records.

Note:

  • 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.
  • Vtiger CRM Contacts are synced as Customers in your QuickBooks Online account and vice versa. Contacts can be synced individually.
  • Products and Services in Vtiger CRM are synced as Products/Services in QuickBooks.
  • Vendors in Vtiger CRM are synced as Vendors in QuickBooks.
  • Invoices in Vtiger CRM are synced as Invoices in QuickBooks. However, Invoices can’t be synced individually. Contacts and Products should also be synced alongside Invoices.
  • For synchronizing Invoices, you need to have the Contacts, Products, and Services module enabled in Vtiger.
  • A Purchase Order in Vtiger CRM is synced as a Purchase Order in QuickBooks.
  • Sync does not handle Delete activities.
  • Any records deleted in Vtiger will not be deleted in QuickBooks, and vice versa.

Field Mapping

For any synchronization to be successful, mapping the fields is necessary to ensure that information is transferred in both directions. 

The fields you can add are shown in the image below:


 

Syncing Contacts

Vtiger

QuickBooks

First Name

First Name

Last Name

Last Name

Organization Name

Company Name

Office Phone

Phone

Mobile Phone

Mobile

Secondary Phone

Other Phone

Fax

Fax

Primary Email

Email

Mailing Street

Street

Mailing City

City

Mailing State

State

Mailing Zip

Zip

Mailing Country

Country

Description

Notes

 

Vtiger to QuickBooks

The Display Name field is mandatory in QuickBooks. Hence, the First Name and Last Name fields are combined and displayed as the Display Name in QuickBooks.

QuickBooks to Vtiger

  • The Last Name field is mandatory in Vtiger. If the Last Name field in QuickBooks is empty, the 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.

Syncing Products and Services Data 

Vtiger

QuickBooks

Product Name

Name

Service Name

Name

Unit Price

Price/Rate

Description

Description

 

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 the Products module in Vtiger CRM.
  • Records in Services are synced to the Services module in Vtiger CRM.

Syncing Vendor Data

Vtiger

QuickBooks

Vendor Name

Name

Primary Email

Email

Primary Phone

Phone

Website

Website

Street

Street

City

City

State

State

Postal Code

Zip

Vtiger

QuickBooks

Contact Name

Customer Name

QB Invoice No

Invoice No

Invoice Date

Invoice Date

Invoice Due Date

Invoice Due Date

Billing Address

Bill Address

Shipping Address

Ship Address

Products

Products

Services

Services

Quantity

Quantity

List Price

List Price

Tax

Tax

Discount

Discount

Shipping Charges

Shipping

Shipping Address

Shipping Address

Note: Vtiger allows you to edit the Vendor name field in QuickBooks. You can add the name of a vendor’s organization as well as the name of an individual. 

You can change the mapping of your vendor’s name to their organization or company name.

Syncing Purchase Order 

Vtiger

QuickBooks

Billing Address

Street

Shipping Address

Shipping address

Shipping City

City

Shipping State

State

Shipping Country

Country

Shipping Postal Code

Postal code

Subject

Purchase order no

Vendor Name

Vendor

Billing City

city

Billing State

state

Billing Country

Country

Billing Postal Code

Postal code

QB Ship via

Ship via

Due Date

Purchase Order date

QB Purchase Order No

Purchase Order no

Note: Map QuickBooks custom fields to Vtiger.

Syncing Payment Data 

Vtiger

QuickBooks

Payment No

Reference no

Related Contact

Customer name

Amount

Amount received

Date Received

Payment date

 

Vtiger to QuickBooks

  • Invoices not associated with 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 to Group in Vtiger, the total of all available taxes is passed to QuickBooks as a single tax.
  • 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.
  • The total Shipping and Handling charges 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 creates a No Company Organization record in Vtiger and associates an Invoice 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 the 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, the Shipping tax percentages should be the same in both QuickBooks and Vtiger.
  • At least one tax should be active in Vtiger to sync Invoices from Vtiger to QB.
  • While syncing an invoice from Vtiger to QuickBooks, if tax values are zero, the Invoice will be created in QuickBooks with a Tax mode out of scope.
  • While syncing Products from Vtiger to QuickBooks, the Income and Expense accounts will be mapped based on the details you provided.
  • Invoice in Vtiger with individual tax type having group level discounts and item level discounts will be skipped
  • If any line items in Vtiger do not have taxes in individual mode, we will check for a zero-value tax in QuickBooks and sync the Invoice. If the zero-value tax is unavailable, the invoice will be skipped.
  • During the first sync, all Sales taxes are copied from QuickBooks to Vtiger, and all purchase taxes are skipped.

Troubleshooting Tips

Some Common Errors

Below are a few common errors users often face during the sync process:

  • Error: Vtiger Invoice contains products that are not available in QuickBooks – Vtiger Error.
  • The specified products, such as Product A or Service B, are not in QuickBooks. First, you must sync these products.
  • Error: Vtiger Invoice contains currency that is not available in QuickBooks - Vtiger Error.
    • The base currency of Vtiger CRM and QuickBooks should be the same.
    • If the base currency is the same in both applications and the issue persists, follow these steps:
      • Go to Invoices.
      • Click on Skipped Invoice.
      • Go to Item Details.
      • Update the record currency to match the base currency.
      • Save the Invoice.
      • Try syncing the invoice once more.
  • Error: The specified string length does not match the supported length. Min:0 Max:4,000 supported. Supplied length:4,312 - QuickBooks Error.
    • Product descriptions must be fewer than 4,000 characters, as QuickBooks has a character limit of 4,000 for item descriptions.
  • Error: Invalid account type: You can't associate a product or service with accounts of certain types(such as Debtors and Creditors). If the product or service is something you sell, use an income account. If the product or service is something you buy, use an expense account.- QuickBooks Error.
    • Please follow these steps to resolve the issue.
      • Go to the QuickBooks Sync Settings page.
      • Click on Account settings.
      • Give a proper expense account and save
      • Go to the sync log of QuickBooks.
      • Click on Sync Now.
  • Error: Related To does not have a value
    • Please follow these steps to resolve the issue.
      • Go to Module Layouts & Fields of Payments.
      • Make Related To nonmandatory.
      • Go to the sync log of QuickBooks.
      • Click on Sync Now.
  • Error: Vendor related to the QuickBooks Invoice is not created in Vtiger - Vtiger Error
    • The specified vendors are not found in Vtiger. Please sync the vendors first, then sync the purchase orders.
  • Error: Product/Service linked to the QuickBooks Invoice is not synced to Vtiger - Vtiger Error
    • The specified Products/Services are not synced to Vtiger. Please sync the Products/Services first, then sync the Invoices.
  • Error - Business Validation Error: You must set a transaction amount. The status of this payment is not "Received," "Paid," or "Refunded," and hence, the transaction amount doesn't exist. - QuickBooks Error
    • Please follow these steps to resolve the issue.
      • Go to Payments.
      • Open the skipped payments.
      • Change the status Received, Paid, or Refunded and Save.
      • Go to the sync log of QuickBooks.
      • Click on Sync Now.
  • Error: A matching product bundle with the same name is not available in QuickBooks. Please manually create a product bundle in QuickBooks with the same name as Vtiger and resync. QuickBooks does not provide API to create or update product bundles - Vtiger Error. 
    • Please follow these steps to resolve the issue.
      • Log in to QuickBooks.
      • Create a product bundle manually in QuickBooks using the same name as in Vtiger.
      • Go to the sync log of QuickBooks in Vtiger.
      • Click on Sync Now.
  •  Error: Vtiger Purchase order contains currency that is not available in QuickBooks - QuickBooks Error 
    • Currency of the purchase order must match QuickBooks' base currency.
    • Please follow these steps to resolve the issue.
      • Go to Purchase Orders.
      • Open the skipped Purchase order.
      • Go to the Item details block.
      • Change the currency to match QuickBooks' base currency and Save
      • Go to the sync log of QuickBooks in Vtiger.
      • Click on Sync Now.
  • Error: Vtiger Invoice contains tax values that are not available in QuickBooks - QuickBooks Error 
    • Vtiger created taxes are not supported. Only QuickBooks-created taxes must be used in Invoices.
    • Please follow these steps to resolve the issue.
      • Go to Invoice Module
      • Click on skipped invoice.
      • Go to edit view
      • Scroll to the item details section.
      • Remove the taxes which are Vtiger created.
      • Save the invoice
      • Now go to the QuickBooks sync log.
      • Click Sync Now.
  • Error: Invalid reference record id specified for currency_id 
    • The QuickBooks currency must be present in Vtiger.
    • Please follow these steps to resolve the issue.
      • Go to Currencies in Settings.
      • Create the currency that is in QuickBooks.
      • Now go to the QuickBooks sync log.
      • Click Sync Now.
  • Error: Required parameter CustomerRef is missing in the request - QuickBooks Error. 
    • Please follow these steps to resolve the issue.
      • Go to Payments.
      • Open the Skipped Payments.
      • Add Related Contact and Save.
      • Now go to the QuickBooks sync log.
      • Click Sync Now.

References

QuickBooks Desktop Version Integration

Home Privacy Policy Terms of Service Security Center Policy & Legal Center Contact Us
© Copyright 2025 Vtiger. All rights reserved.
Powered by Vtiger
Facebook Twitter Linkedin Youtube