Overview of the QuickBooks Connector
The WooCommerce QuickBooks Connector is an admin extension that synchronizes your store's commerce data with Intuit QuickBooks Online. Everything is managed from a single dashboard inside WordPress admin — your customers never see it, and your storefront is untouched.
What It Does
| Data | WooCommerce → QuickBooks | QuickBooks → WooCommerce |
|---|---|---|
| Customers | Export, with per-customer mapping | Import into WooCommerce users |
| Products | Export (variations included), manual or real-time | Staged Import List or real-time via webhooks |
| Product images | Optional image sync | Optional image sync |
| Orders | Manual export, or automatic by order status | — |
| Payments | Recorded per gateway rules, with fees and deposits | — |
| Refunds | Automatic refund receipts | — |
| Taxes | Mapped tax classes applied on export | — |
Who It Is For
- Store owners who reconcile WooCommerce sales in QuickBooks Online
- Accountants who need orders recorded as the right transaction type, in the right accounts
- Merchants selling both online and in person — orders are labeled by source (WooCommerce or POS) when a Webkul POS plugin is active
- Anyone tired of retyping orders, customers, and refunds into their books
Requirements
Software Requirements
| Component | Requirement |
|---|---|
| WordPress | 6.7 or higher (tested up to 7.0) |
| WooCommerce | 10.0 or higher (tested up to 10.9) — must be active |
| PHP | 7.4 or higher (tested up to 8.4) |
| WordPress user | Administrator access |
The plugin is compatible with WooCommerce High-Performance Order Storage (HPOS) and Cart/Checkout Blocks.
QuickBooks Requirements
- An Intuit QuickBooks Online company — a sandbox company for testing or a production company for live books
- An Intuit Developer app providing the OAuth Client ID and Client Secret (created free at developer.intuit.com)
- The plugin's two Redirect URIs registered in that app — shown with copy buttons on the Connection Settings page
Background Processing
Real-time product updates, webhook processing, and scheduled bank deposits run through WP-Cron. Make sure your site's cron is operating normally (it does by default on most hosts).
How the Pieces Fit Together
- Connect once through the Setup Wizard or the Connection Settings page.
- Map accounts in General Settings so QuickBooks knows where product income, expenses, assets, and deposits belong.
- Map payment methods and taxes so payments and totals land correctly.
- Choose your sync style — push records manually from the Customers, Products, and Orders tabs, or switch on Auto Sync and let the connector work in the background.
Next step: Install the plugin →
