Skip to content

QuickBooks integration

Connect QuickBooks as a downstream accounting destination. Zyelra remains the books of record. Production QuickBooks is blocked until verified.

Source of truth

Zyelra’s general ledger is canonical. QuickBooks receives outbound accounting objects (such as journals and, where implemented, vendors/bills) and can be compared in reconciliation. Changes in QuickBooks do not silently overwrite Zyelra.

What each system owns

  • Zyelra — operational books of record (CoA, journals, AP/AR, operating projections)
  • QuickBooks — downstream accounting destination for outbound sync and external reporting
  • Payment providers — money movement rails (not the Zyelra ledger)

Connect (when available)

  1. Step 1In Zyelra

    Open Accounting software

    Go to Finance → Accounting software (accounting_integrations.view). Manage actions need accounting_integrations.manage.

  2. Step 2In Zyelra

    Authorize QuickBooks

    Start Connect / authorize when the provider card offers it. Complete OAuth with the Intuit company you intend to use (typically sandbox until production is enabled).

  3. Step 3In Zyelra

    Review mappings and sync

    Map accounts as prompted. Follow sync status and reconciliation surfaces. Pause/resume and retries exist for operations maturity — use them when sync health shows issues.

When sync looks wrong

  • Confirm you are not expecting production QBO while production remains BLOCKED
  • Complete account mappings before diagnosing missing journals
  • Use Finance → Reconciliation; fix Zyelra first
  • See QuickBooks troubleshooting for symptom → cause → solution

Not supported (do not expect)

  • Sales Invoice sync as a first-class SoT (intentionally unsupported)
  • Customer Payment / AR payment sync as supported production capability
  • Intuit Batch API
  • Provider reverse_journal_entry API (Zyelra uses compensating/reversal workflows on its side)
  • Full multicurrency / TaxCode engine as a verified product claim
  • QuickBooks becoming Zyelra’s operational database
  • QBO-13 / Batch-oriented expansions documented as available

Next step

Ledger, collections, operating balances, AP, disbursements, and QuickBooks.

More Finance guides →

Related guides

  • Finance overview

    Zyelra’s ledger and operating balances are the financial source of truth. Payment providers are rails — not a custodial Zyelra wallet.

  • Vendor bills and accounts payable

    Create, approve, post, and record payment on vendor bills. Draft bills can also come from maintenance tasks.

  • Reconciliation

    Compare Zyelra ledger state to external accounting objects (especially QuickBooks) without treating the provider as source of truth.

  • Chart of accounts and ledger

    Zyelra’s chart of accounts and ledger are the canonical books of record. Providers and QuickBooks are downstream rails and destinations.

  • Journals, statements, and bank accounts

    Post and review journals, read statements, and keep bank account records aligned with Zyelra ledger state.

  • QuickBooks troubleshooting

    Fix OAuth, mapping, sync, and reconciliation issues — without assuming production QuickBooks is enabled.