QuickBooks Online (Intuit) — full guide

Flowbyte connects to **Intuit QuickBooks Online (QBO)** via the Accounting API. Flowbyte stays the ERP; QBO receives bookkeeping documents (US / international companies).

### What it can do

**Push (Flowbyte → QBO)**

* Customers (name, email, address)
* Sales invoices (DocNumber = Flowbyte invoice #) and credit notes
* Payments (linked to the QBO invoice)
* Products → Items (SKU)
* Inventory QtyOnHand (optional)
* Journal entries (optional; needs account mapping)
* Vendors from suppliers (optional)
* Bills from purchase invoices (optional)

**Pull / webhook**

* Tax catalog (TaxCode) on connect / Test
* Chart of accounts + Flowbyte ↔ QBO mapping
* Webhooks: Customer, Invoice, Payment, JournalEntry (e.g. mark invoice **paid** when QBO balance is 0)

**Tax**

* **US:** TAX / NON; AST when enabled (+ ship-to address)
* **EU / Global:** TaxExcluded + VAT% → TaxCode map
* For Estonian VAT prefer a **non-US** QBO company

**Automation**

* Daily ~05:40
* Immediate push when a sales invoice is finalized
* Multi-realm — switch / connect another QBO company

### Quick start

1. **Settings → API interfaces → QuickBooks Online**
2. **Connect** → authorize at Intuit
3. **Test connection**
4. Enable sync toggles → **Save**
5. Optionally pull chart of accounts and map accounts
6. Optionally **Push** customers / invoices / payments
7. Verify in QBO: Sales → Customers / Invoices

### Sync toggles

| Toggle | Default |
|--------|---------|
| Customers / Invoices / Payments / Products / Chart of accounts | on |
| Journals, Inventory, Vendors, Bills | off |

### FAQ

**Why “Sales tax: US”?** Connected QBO company is US — reconnect a non-US company for EU VAT.

**Can QBO change Flowbyte data?** Webhooks can mark an invoice paid. Full two-way line sync is not claimed.

**Journals / inventory fail?** Map the chart of accounts first.

### Support

* Flowbyte: support@flowbyte.ee
* On failure: error text + intuit_tid + QBO company country