QuickBooks Online integration
Sync inventory, customers, and invoices between OneAce and QuickBooks Online in real time.
Prerequisites
- A QuickBooks Online account (US, UK, Canada, Australia, or India)
- Admin access to your QB company file
- OneAce account with Owner or Admin role
- Items created in both QB and OneAce (mapping is manual)
Setup steps
- 1
Open Integrations Settings
Go to Settings → Integrations (or Settings → Platform) in OneAce, then select QuickBooks Online. - 2
Click "Connect to QB"
You'll be redirected to QuickBooks.com to authorize OneAce. Log in if prompted. - 3
Review and approve permissions
QB will show you what OneAce can access: Items, Customers, Invoices, Purchase Orders. Click Authorize. - 4
Return to OneAce and map your items
You'll return to OneAce. Go to Integrations → QB Items Mapping to match QB items with OneAce items. OneAce syncs using the QB Item ID, so you must have the item in both systems first. - 5
Enable sync direction (optional)
Choose whether OneAce pushes stock changes to QB (recommended for inventory control) or only receives updates. This is set at the organization level. - 6
Test the integration
Record a stock movement in OneAce. Check QB a moment later to verify the quantity updated. Refresh QB if you don't see the change immediately.
What syncs
| Entity | Direction | Details |
|---|---|---|
| Inventory Items | Bidirectional | Stock quantity syncs both ways. On-hand count in QB = Inventory level in OneAce. |
| Customers | Read-only | OneAce reads QB customer list for reference (e.g., in PO creation). Creates no new customers. |
| Invoices | Read-only | OneAce can link to QB invoices; useful for reconciliation. Does not create invoices in QB. |
| Purchase Orders | Push-only | OneAce can create bills in QB from receiving activity (when enabled). |
Visual reference
Troubleshooting
"Authorization failed" or "Invalid redirect"
This usually means the OAuth redirect URL is wrong. Check that your OneAce instance URL in Settings matches the URL you used to log in (e.g., https://app.oneace.app). If you self-host, ensure your domain is allowlisted in QB app settings.
"Item not found" or mapping fails
QB sync requires the item to exist in both systems already. Create the item in QB first, then in OneAce, then map them by QB Item ID. OneAce does not auto-create items from QB yet (planned for a later release).
Quantity not syncing to QB
Check sync direction: Go to Settings → Integrations and confirm push is enabled.
Wait a moment: Sync is asynchronous and may take 30 seconds.
Refresh QB: Sometimes QB caches the previous value. Refresh your browser.
Check logs: Go to Settings → Integration Logs to see if an error occurred during sync.
"Token expired" or "Reauthorize" prompt
QB OAuth tokens expire after 180 days. Disconnect and reconnect in Settings → Integrations. You won't lose your item mappings; they're stored on OneAce's side.
Still stuck?
Email support@oneace.app with:
- Your QB company ID (found in QB Settings)
- The item SKU or QB Item ID you're trying to sync
- A screenshot of the error message
FAQ
Can I sync multiple QB companies? No, one OneAce org connects to one QB company. If you have multiple QB companies, create separate OneAce orgs or reach out to discuss enterprise plans.
Does OneAce sync QB expenses or POs? OneAce can read QB invoices and bills. Full two-way PO sync is planned.
What if I disconnect QB? Your OneAce data stays. Sync stops. Reconnect anytime to resume.