1.Overview
2.Installation
- Download the .zip file from your account.
- Log into your WordPress Dashboard and navigate to Plugins > Add New.
- Click on the Upload Plugin button on top and upload the zip file of the plugin.
- Install the plugin and click Activate to get started.
- Authorize the connection between QuickBooks Online and WooCommerce to start using the plugin.
3.Setup
Follow the steps below to learn how to set up this QuickBooks Integration for the WooCommerce plugin.
- After installing and activating the plugin, you’ll see this screen asking you to connect your QuickBooks account with the plugin.
To do so, go to WP Swings→ QuickBooks on your WordPress admin dashboard. Then, you’ll be able to see the following screen. Click on the button – Connect Your Account.
2. There are two ways to connect WooCommerce to your QuickBooks account.
-
- Direct Login and Authorize
- Log in Through the Custom App
Using Direct Login and Authorize Method
2. Connection Type- Here, you will get two options: Production and Sandbox.
The client can choose any option by their account type, either Sandbox or Production.
3. Next, you will click on the Authorize button, and you’ll be led to the QuickBooks sign-in page.
4. Sign in using your QuickBooks ID, and after doing that successfully, you’ll be redirected to this page asking you to move to the next step.
Log in Through the Custom App
- Click on the button- Connect Your Account.
Here are the steps to get these details.
- Click on the Get API keys link
- You’ll be asked to log in with your QuickBooks account(create a new one if you don’t have one)
- After logging in, you will be redirected to the QuickBooks console where you can create a new application.
- Click on the “QuickBooks Online and Payments” platform.
- Add the name of your app and select the scope.
- After that, you need to click on the “Create App” button, which will lead you to this dashboard.
- Click on “Keys and OAuth” under the Development section in the left panel and you’ll see your Client ID and Client Secret there.
Add your website’s URL in the link field under the redirect URIs section.
- Copy the Client ID and Secret and paste them into the form in the plugin panel and click on Authorize.
- After clicking on Authorize, you will see this window.
- Click on “Move to the Next Step” to proceed further.
- You’ll then see a window asking you to Create Feeds. Click on the “Create Feeds” button to create them.
- Once you create the feeds, you’re done. You can now click “Move to Next Step” and then “Complete Onboarding” to complete the setup.
- Clicking on Complete Onboarding will lead you to a window with a button called “Visit Dashboard”. Click on it and you’ll see the dashboard.
- In case your Financial Accounts aren’t mapped with product feeds. A pop-up like this will appear.
- On clicking the Go To Product Feeds, you will be directed to a page where you will find an additional option- Map QuickBooks Accounts.
- Once you click on that, you will get the following options:
- AssetAccountRef
- ExpenseAccountRef
- IncomeAccountRef
- DepositAccountRef
- You can select and choose from the dropdown menu as per your needs.
- You can map different accounts and if those are not listed you can click on “Refresh Accounts” and then all the new accounts with existing accounts will be listed in the dropdown.
- Next, you will need to click on the Update button.
4.Dashboard
The dashboard displays the number of products, contacts, and orders that are successfully synchronized over QuickBooks.
- To disconnect the QuickBooks Woo integration, click on the “Disconnect” button on the plugin’s dashboard.
- After you click on it, you’ll get a popup asking you to confirm your decision. Click on Disconnect there. You will be successfully disconnected.
5.Feeds
You can design a set of rules for how your WooCommerce data will be synchronized over QuickBooks using feeds. The QuickBooks integration for WooCommerce plugin offers three alternative default feeds, namely,
- Customers Feed
- Invoices Feed
- Products Feed
- Refund Receipt Feed
Customer Feed:-
- Primary Email Address
- Currency Label
- Currency Code
- Primary Phone Number
- Billing Latitude
- Billing Longitude
- Billing City
- Billing Country
- Billing Line 1
- Billing Zip Code
- Billing State
- Shipping Latitude
- Shipping Longitude
- Shipping City
- Shipping Country
- Shipping Line 1
- Shipping Zip Code
- Shipping State
- Middle Name
- Notes
- Suffix
- Company Name
- Family Name
- Print On Check Name
- Display Name
- Given Name
- Fully Qualified Name
- Title
- Web Address URI
- Preferred Delivery Method
- Is Project
- Domain
- GSTIN
- Active
Invoice Feed:-
- Doc Number
- First Name
- Last Name
- Billing Address Line1
- Billing Address Line2
- Billing City
- Billing Country
- Billing State
- Billing Zip Code
- Shipping Address Line1
- Shipping Address Line2
- Shipping City
- Shipping Country
- Shipping State
- Shipping Zip Code
- Shipping From Address Line1
- Shipping From Address Line2
- Shipping From City
- Shipping From Country
- Shipping From State
- Shipping From Zip Code
- Customer Id
- Customer Name
- Currency Label
- Currency Code
- Billing Email Name
- Print Status
- EmailStatus
- Customer Memo value
- Transaction Date
- Tracking Num
- Deposited Amount
- Balance Amount
- Due Date
- Apply Tax After Discount
- Total Tax
Product Feed:-
- Name
- SKU
- Fully Qualified Name
- Taxable
- Unit Price
- Item Category Type
- Item Type
- Purchase Cost
- Track Quantity On Hand
- Quantity On Hand
- Inventory Start Date
- Purchase Description
- Description
- Purchase Tax Included
You can customize your feeds with the settings that come with them. Click on the Edit icon to access those settings.
- To add a new feed using WooCommerce objects, Click Add Feeds. Add the title of the new feed
Here are the settings you get under the feeds:
Select Object: This setting lets you select the WooCommerce object you want to sync the data for.
There are six objects available for creating feeds: Customers, Invoices, Products, Refund Receipts, Sales Receipts, and Estimates.
Map Fields: This setting helps you map a field to the value it will contain. For example, you can map a Billing Address field with the address to make sure it stores the correct value.
Add New Field: This setting helps you add a new field in the feed. If you want to sync some other data, you can add that field to the respective feed.
Primary Field: This setting helps you choose a field that will work as a primary key.
Select Event: This setting lets you select the event that triggers the data synchronization.
- Click Publish/ Update in the right panel or Back to Feeds which will take you back to your dashboard in case you want to edit more.
5.2.Invoice Status
This new feature will automatically update the status of the invoice in QuickBooks as PAID, once the order/ payment is set to complete on your WooCommerce store. Now, you may automatically create customers and invoices with updated status when purchases are made on your WooCommerce online store by using the WooCommerce to QuickBooks plugin.
5.3.Filter For Errors
As you may already know, the QuickBooks Integration plugin offers a thorough WooCommerce QuickBooks sync log report that enables you to quickly identify errors. Using the new filter for errors functionality, you can now filter out all these errors from the logs area while data syncing.
5.4.Shipping Charges Syncing
Integrate WooCommerce with QuickBooks and completely automate your accounting. No need to manually enter invoices, customers, or products again. No Synchronization Limits; the plugin supports unlimited real-time sync of orders, customers, inventory, and shipping charges as well.
To enable shipping charges syncing; Go to Settings > Account & Settings > Sales > Sales Form Content, and ensure the checkbox for Shipping is checked.
6.Syncing of Tax Value and Tax Rate
Now, the tax value and tax rate will also be synced to QuickBooks invoices along with the orders with the help of this latest feature of QuickBooks, i.e. QuickBooks syncing including necessary tax details.
Make sure to generate the same tax rate at the QuickBooks invoicing end as well in order to avoid any syncing errors.
7.Data Sync
The data sync tab helps you with data synchronization. You get 2 different options here:
- Bulk Data Sync: Bulk Data sync synchronizes all the data(including historical data) of the selected object.
- One-Click Sync: One-click Sync synchronizes only the newly added data of the selected object or the one that failed to sync earlier.
- Two-Way Sync for WooCommerce Products: With Two-way sync, you can pull the products created in QuickBooks with one click and enable the option to create the products in your WooCommerce store.
8.Logs
The Logs section shows any errors that occurred during the data sync process. This tab contains multiple details for each log. Here are those:
- Feed: Displays which feed the error occurred in.
- Woo Object: Displays the WooCommerce object.
- Woo Object Id: Displays the WooCommerce object ID.
- QuickBooks Object: Displays the QuickBooks object.
- QuickBooks Object Id: Displays the QuickBooks object ID.
- Time: Displays the timestamp at the error occurred.
9.Settings
You get 3 settings here:
- Enable instant sync: When you enable this toggle, WooCommerce data is instantly synced to QuickBooks. If you turn off this option, you’ll have to manually sync the data from the Data Sync tab.
- Enable logging: Enabling this option allows you to save sync log errors. If you deactivate this option, no logs will be saved.
- Enable auto-sync: Enabling this option will sync all your data in the background.
- Wipe complete data on disconnect: If you enable this toggle, all the data you’ve synced over QuickBooks will be deleted once you disconnect the plugin.
- Delete log after x days: This option will let you select the number of days you want to store the sync logs. For example, selecting 30 days will store the logs for 30 days and be deleted after that.
10.Unit Price/Rate Syncing in Invoice on QuickBooks
The product’s price will sync on QuickBooks as the unique price that will be seen in the Rate section of QuickBooks.
Product individual prices will sync on columns of invoice line items in QuickBooks.
11.Fetch Key Data With Sale Receipt and Estimate Object
The Sales Receipt object in QuickBooks WooCommerce Integration allows you to accurately track and record customer payments. It monitors various forms of payment, including cash, checks, credit card payments, and other payment methods, ensuring accurate financial management and reporting.
The Estimate object is used to create feeds that sync data about quotes or bids sent to customers. This data includes the potential costs of products or services you intend to sell, as well as their pricing and the terms of the sale. This data is sent to the Estimate QuickBooks module.
12.Syncing Discounts Data To Invoice Module
Invoice feeds can be used for synchronizing discount data applied to orders using coupons. By leveraging invoice feeds, you can ensure that the QuickBooks Invoice module accurately reflects both the absolute discount value and the discount percentage, regardless of the discount type (whether fixed or percentage).
16.Sync SKU in Items and Invoices
You can sync SKUs between your products and invoices. You can enable or disable this feature directly from the plugin settings.
When a product has an assigned SKU, it will automatically sync with the corresponding items and invoices in QuickBooks.
Important: To use this feature, ensure the “SKU for Invoices” option is enabled in your QuickBooks account.
Follow these steps to activate it:
- Navigate to Settings > Account and Settings > Sales > Products and Services.
- Check the option for “Show SKU Columns”.
This ensures SKUs are properly displayed and synchronized across your invoices and items.
17.Sync User Browser Info and IP address
You can set up fields in the feed to capture and sync user details like IP addresses and browser information with QuickBooks.
This helps improve reports, gives better insights into user activity, and adds an extra layer of security by making it easier to spot unusual activity. To do this, go to the feed settings, add fields for IP and browser info, map them to QuickBooks, and test to make sure everything works smoothly.
18.Two-Way Deletion For WooCommerce Products
When you move a product to the trash in WooCommerce, it automatically becomes inactive in QuickBooks. Similarly, if you mark a product as inactive in QuickBooks, it is moved to the trash in WooCommerce.
Restoring a product from the trash in WooCommerce reactivates it in QuickBooks, and the same happens if you reactivate it in QuickBooks. This process works seamlessly for both simple and variable products.
20.Sync Product Categories
With our QuickBooks integration plugin, you can easily sync parent and child product categories. Once synced, these categories will appear under the products in your QuickBooks dashboard, helping you manage product information more accurately and keeping it updated.
You can enable and disable this option from the settings.
21.Sync WooCommerce Base Currency Over QuickBooks
When the order is placed on a WooCommerce store, the invoice currency of that particular order will be similar to its base currency. It means the base currency of the WooCommerce order will sync over the invoice of that particular order.
Suppose, the WooCommerce order is placed:
Then, the base currency and invoice currency are the same as you can see:
22.Compatible With Fox Currency Switcher Plugin
Order currency will sync precisely the same as it was before on QuickBooks. QuickBooks home currency will not matter in this case.
Here is the setting of the FOX Currency Switcher plugin on which the price will be calculated during the checkout:
When the WooCommerce order currency is switched through this switcher plugin, the currency and price of that particular order will sync correctly.
Suppose the order is placed on the WooCommerce store, and its currency is in UGX:
Then, you see that its currency is synced on QuickBooks correctly irrespective of its home currency via the switcher plugin:
23.Compatible With WooCommerce HPOS
Quickbooks integration for WooCommerce is compatible with WooCommerce High-Performance Order Storage (HPOS) is an easy-to-understand and solid database structure that uses an alternative storage mechanism for Order Tables to ensure the smooth workflow of your WooCommerce Store.
To Enable HPOS Follow these steps:
Firstly, make sure your WooCommerce version is updated with the latest 8.0. After that navigate to WooCommerce > Settings > Advanced > Features and choose the High Performance Order Storage option for orders.
You can switch between data storages freely to sync the data between the tables.
For more information, refer to the WooCommerce HPOS Documentation
24.FAQ’s
Can we sync the data with the Quickbooks plugin?
Yes, we have given two options for this: Bulk sync and One-click Sync which you can choose according to your need.
Can we sync the tax value and tax rate as well?
Yes, if you need to sync the tax value or tax rate both things you can do with our Quickbooks plugin
What is the difference between Bulk sync and One-click Sync?
Bulk Sync: Syncs all the data of a particular object.
One-click Sync: Syncs only the newly added data or the one that failed to sync earlier.
I don’t want to sync all the data automatically, what options can we opt for?
We have given the option of Manually syncing data so that you can choose the manual option too.
Can we check sync error logs with the Quickbooks plugin?
Yes, there is an option in the backend where you can check all your logs.
Can the logs be deleted automatically after some days?
Yes, you can set the number of days you want to store the logs. They’ll be deleted after the set days.
We want to delete some data from the plugin, is this possible?
Yes, with this plugin you can delete plugin data as you want.