QuickBooks Online integration

Coming soon

The QuickBooks Online integration is built end-to-end — OAuth flow, token refresh, encrypted token storage with pgsodium, idempotent invoice sync, customer mapping — and is currently going through Intuit’s app-review certification process. It is **not yet operational** for tenants. CSV export from /admin/bookkeeping is the live accounting bridge in the meantime; once Intuit approves our app, direct sync turns on for every account at the same flat $99/mo price.

What the integration does

  • Planned: authenticate via QuickBooks OAuth — token refresh handled automatically.
  • Planned: sync paid invoices from GroundCut to QBO with line items, customer mapping, and payment records.
  • Built and ready: token storage (AEAD-encrypted at rest under the qbo_tokens pgsodium key) and the syncInvoiceToQuickbooks library function.
  • Planned: track the last sync timestamp and most recent error per tenant for visibility.
  • Planned: map GroundCut customers to QBO customers via quickbooks_customer_id on the customer row.

What’s automated

  • Nothing is operational today — the integration is awaiting Intuit certification. Use CSV export from /admin/bookkeeping in the meantime.
  • When approved: invoice flips to paid → QuickBooks sync runs; idempotent, refund-aware, with token refresh.

Setup steps

  1. 1Not available yet — QuickBooks app review is in progress with Intuit.
  2. 2In the meantime, use CSV export from /admin/bookkeeping (see the CSV Export integration page) to feed your bookkeeper.
  3. 3When the integration goes live, OAuth setup will appear at /admin/settings → Connect QuickBooks — no upgrade or extra fee.
  4. 4Existing tenants will get a notification when the integration switches on.

Related GroundCut features

  • CSV Export (the live accounting bridge today).
  • Invoices module (will be the source of every sync once active).
  • Customer records (will map 1:1 to QBO customers via quickbooks_customer_id once active).

QuickBooks Online integration FAQs

Why isn’t QuickBooks Online sync live yet?+
Direct sync between a third-party app and QuickBooks Online requires Intuit to certify the app — they review the OAuth flow, scope usage, error handling, and customer-data treatment before issuing production credentials. We submitted for review and are working through their feedback. The integration code is complete and tested in sandbox; the gate is Intuit’s approval timeline, not engineering work on our side.
What do I do for accounting in the meantime?+
Use CSV export from /admin/bookkeeping. The export covers income, expenses, and the audit log with date-range filters. The CSV imports cleanly into QuickBooks Online via Bank Data or Receipts (and into Xero, Wave, and any spreadsheet workflow). Many operators actually prefer the CSV workflow permanently because it keeps the bookkeeper in control of when entries post.
Will sync work for QuickBooks Desktop once it ships?+
No, QuickBooks Online only. The integration uses Intuit’s OAuth-based REST API for QBO. QuickBooks Desktop has a different (and aging) integration model that we don’t support. CSV export covers Desktop today and will continue to after QBO sync goes live.
Will it cost extra when it ships?+
No. New integrations land on the standard $99/mo plan with no upcharge. There’s only one tier and one price; everything we ship is included.
Can I sync to Xero instead?+
No direct integration is built. The schema has a xero_sync_id column on invoices reserved for a future integration, but the integration code itself isn’t built. CSV export covers Xero today (Xero accepts the same CSV format as QBO Bank Data import). If Xero is a hard requirement for native sync, let us know on the contact form so we can prioritize accordingly.

Want QuickBooks Online integration sooner?

Operator demand drives roadmap priority. Tell us this matters and it moves up.

14-day free trial · No card required · Cancel any time