QuickBooks Online (Intuit) — täielik juhend

Flowbyte ühendub **Intuiti QuickBooks Online (QBO)** Accounting API-ga. Flowbyte jääb ERP-ks; QBO saab raamatupidamisdokumendid (USA / rahvusvahelised ettevõtted).

### Mida saab teha

**Push (Flowbyte → QBO)**

* Kliendid (nimi, e-post, aadress)
* Müügiarved (DocNumber = Flowbyte arve nr) ja kreeditarved
* Maksed (seotud QBO arvega)
* Tooted → Items (SKU)
* Lao QtyOnHand (valikuline)
* Pearaamatu kanded / journals (valikuline, vajab konto map’i)
* Tarnijad → Vendors (valikuline)
* Ostuarved → Bills (valikuline)

**Pull / webhook**

* Maksukataloog (TaxCode) ühendamisel / Testil
* Kontoplaan + Flowbyte ↔ QBO vastendus
* Webhookid: Customer, Invoice, Payment, JournalEntry (nt arve **makstud**, kui QBO saldo on 0)

**Maksud**

* **US:** TAX / NON; AST kui lubatud (+ tarneaadress)
* **EU / Global:** TaxExcluded + KM% → TaxCode map
* Eesti KM jaoks eelista **mitte-USA** QBO firmat

**Automaatika**

* Iga päev ~05:40
* Müügiarve lõpetamisel kohe push
* Mitu QBO firmat (realm) — lülita / ühenda teine

### Kiire algus

1. **Seaded → API liidesed → QuickBooks Online**
2. **Ühenda** → Intuiti luba
3. **Testi ühendust**
4. Lülita sync’id → **Salvesta**
5. Soovi korral tõmba kontoplaan ja kaardista kontod
6. Soovi korral **Push** kliendid / arved / maksed
7. Kontrolli QBO-s Sales → Customers / Invoices

### Sünkroni lülitid

| Lüliti | Vaikimisi |
|--------|-----------|
| Kliendid / Arved / Maksed / Tooted / Kontoplaan | sees |
| Kanded, Lao, Tarnijad, Ostuarved | väljas |

### Levinud küsimused

**Miks „Sales tax: US“?** Ühendatud QBO firma on USA — EE KM jaoks ühenda mitte-USA firma.

**Kas QBO muudab Flowbyte andmeid?** Webhook võib märkida arve makstuks. Täis kahepoolset realist sync’i pole.

**Journals / ladu ebaõnnestub?** Kaardista esmalt kontoplaan.

### Tugi

* Flowbyte: support@flowbyte.ee
* Viga: teade + intuit_tid + QBO firma riik