QuickBooks Connector Features¶
QuickBooks Online is a widely used cloud accounting platform. By connecting it with Odoo using the QuickBooks Connector, your invoices, bills, credit notes, refunds and payments move between the two systems automatically, so your books stay aligned without re-keying documents.
The connector talks to your QuickBooks company (realm) through the official Intuit QuickBooks Online v3 REST API, authenticated with OAuth 2.0. Both the Sandbox and Production environments are supported.
Supported Features¶
- Secure OAuth 2.0 Connection
Connect Odoo to your QuickBooks company with your own Intuit Developer app — Client ID, Client Secret and a Redirect URI generated for you by Odoo.
Access tokens refresh automatically in the background, an expired or revoked grant is reported clearly so you can re-authorize.
Switch between Sandbox and Production from the connection form.
- Chart of Accounts Synchronization
Import your QuickBooks Chart of Accounts and map each QuickBooks account to an Odoo account, matches are suggested automatically by code and name.
- Customer Invoices & Credit Notes
Export posted customer invoices and credit notes to QuickBooks, automatically on confirmation or on demand from the Sync with QuickBooks wizard.
- Vendor Bills & Vendor Refunds
Export posted vendor bills and vendor refunds to QuickBooks as Bill and Vendor Credit records.
- Payments & Bill Payments
Export customer payments and bill payments, linked to the QuickBooks invoice or bill they settle, and deposited to the mapped QuickBooks bank account.
- Two-Way Document Sync
Import QuickBooks invoices, bills, credit memos, vendor credits, payments and bill payments back into Odoo through a reviewable staging queue.
- Customers, Vendors & Products
Partners and products are pushed to QuickBooks on demand, or automatically as a side effect of exporting a document that uses them.
- Tax Handling
US companies rely on QuickBooks Automated Sales Tax, the Quick Calc Taxes button pulls live rates onto a sale order or draft invoice.
Non-US companies can round-trip the tax-included / tax-excluded setting to QuickBooks.
- Automation & Batching
Optional scheduled actions fetch from QuickBooks, process the import queue and drain the export queue in configurable batches, so large volumes never block a user.
- Monitoring & Logs
Every import and export is logged with its request, response and error detail. Failed exports can be retried in one click, and failures can raise a scheduled activity for a responsible user.
- Duplicate Protection
Before creating a document, the connector checks QuickBooks for the same document number and links to the existing record instead of creating a duplicate.
Synchronization Behaviour¶
The connector is poll-based — QuickBooks webhooks are not used. Documents move through scheduled actions, the manual Sync with QuickBooks wizard, and the automatic export that runs when you confirm a document in Odoo.
Fetch From QuickBooks |
Import |
Process Import Queue |
Import |
Process Export Queue |
Export |
Customer Invoice |
Export |
Customer Credit Note |
Export |
Vendor Bill |
Export |
Vendor Refund |
Export |
Customer Payment |
Export |
Bill Payment |
Export |
Chart of Accounts |
Import |
Invoices |
Bi-directional |
Vendor Bills |
Bi-directional |
Credit Notes & Vendor Refunds |
Bi-directional |
Payments & Bill Payments |
Bi-directional |
Customers & Vendors |
Export |
Products |
Export |
Sales Tax Rates |
Import |
Benefits¶
- Books That Agree
One document number, one amount, one customer — created once in Odoo and mirrored in QuickBooks instead of typed twice.
- No Duplicates
Document numbers are checked against QuickBooks before creation, an existing record is linked rather than duplicated.
- Accurate US Sales Tax
Quick Calc Taxes applies live QuickBooks Automated Sales Tax rates, broken down by state, county and district, on the Odoo document.
- Nothing Silently Fails
Failed exports, skipped records and API errors are all logged with full detail, retryable in one click, and can raise an activity for the person responsible.
- Scales With Volume
Documents are sent in batches, and the queue-based crons keep large syncs off the user’s screen and inside a controlled batch size.
Conclusion¶
The QuickBooks Connector turns QuickBooks into a mirror of your Odoo accounting, with invoices, bills, credit notes, refunds and payments synchronized in both directions, reviewable before they land, and fully logged.
Note
The connector requires the intuit-oauth Python library on the Odoo server, and an app created in the Intuit Developer Portal for your Client ID and Client Secret. See Generate QuickBooks Credentials.
Note
One connection per company. Odoo allows a single QuickBooks configuration per company — creating a second one for the same company is rejected. In a multi-company database, create one connection per company, each pointing at its own QuickBooks realm.
Note
QuickBooks webhooks are not used. Synchronization is poll-based and runs through the scheduled actions, the Sync with QuickBooks wizard, and the auto-export on confirmation.