Skip to main content
The QuickBooks accounting integration posts the invoices, credit notes, customers and payments Alguna creates into QuickBooks Online, mapped to your chart of accounts, so the ledger reflects billing without re-keying. Use it when Alguna issues and collects invoices and QuickBooks is the system of record for accounting. If instead you want QuickBooks to send invoices to customers and collect payment, see QuickBooks Invoicing. Everything synced here — whether created in the dashboard or through the API — follows the object model in How Alguna works.

​
Connecting Quickbooks

To connect your Quickbooks account to Alguna, follow these steps:
  1. Go to Settings → Connections → Integrations in Alguna.
  2. Click Connect on the tile with Quickbooks.
  3. Choose the Quickbooks organization you wish to connect to Alguna.
    • If you’re testing in the sandbox environment, we recommend connecting to a Quickbooks Sandbox.
  4. Authorize the connection between Quickbooks and Alguna.
  5. Set Alguna as your source of truth for customer and invoice creation.
  6. Optionally, import existing customers from Quickbooks into Alguna (this can be done at a later date as well).
  7. Set up your accounting ledger and payment accounts for proper ledger entry mapping.

​
Connection Scope

When connected to Quickbooks, Alguna syncs the following fields to ensure accurate accounting:
  • Accounts:
    • Chart of Accounts: Alguna syncs invoices and payments to the appropriate ledger account in Quickbooks, based on your setup.
  • Customers:
    • Customers created in Alguna are synced to Quickbooks, allowing smooth invoicing and payment management.
  • Items:
    • All line items on invoices, including quantities, pricing, tax rates, and amounts, are synced between Alguna and Quickbooks.
  • Invoices:
    • Issued invoices, including details such as due dates, amounts, and tax breakdowns, are sent to Quickbooks.
  • Payments:
    • Payments made through Alguna are synced to Quickbooks for reconciliation.

​
Syncing & Linking Accounts

During the onboarding process, Alguna allows you to import existing customers from Quickbooks into Alguna. This simplifies customer management by keeping records up to date. Once synced, we recommend using Alguna as your source of truth for customer creation. Alguna only manages customers (not suppliers) during syncs with Quickbooks. Quickbooks keeps customers and vendors as separate records; only customers are synced.

​
Accounting Sync & Payment Reconciliation

During the Quickbooks setup process, you can decide how you would like invoices to sync with Quickbooks. Alguna provides flexibility with three sync options:
  1. Only When Issued:
    • When an invoice is sent to the customer, Alguna automatically syncs it to Quickbooks as an open invoice.
    • Payment reconciliation occurs outside of Quickbooks, directly with your payment providers.
  2. Only When Paid:
    • Invoices are created in Quickbooks only after they are issued and the payment is collected via Alguna.
    • Quickbooks will not be aware of any open invoices until the payment is processed and synced.
  3. When Issued and Paid:
    • The invoice is synced when it is issued and again when payment is collected via Alguna, ensuring that both stages are reflected in Quickbooks.

​
Details Synced

When Alguna syncs invoices and payments to Quickbooks, the following details are transferred:

​
Managing Tax

For taxable customers, Alguna can provide specific tax codes when syncing invoices to Quickbooks. Ensure that tax rates in Alguna match those in Quickbooks to prevent discrepancies.

​
Payment Reconciliation

If payments are collected through Alguna, the reconciliation is automatically synced to Quickbooks. This means that the original payment source and the payment record are matched in both systems, keeping your financials accurate.

​
Sync failures

When a record cannot be posted — an authentication problem, a rate limit, a validation error on the QuickBooks side — Alguna opens a sync issue under Settings → Connections → Sync issues rather than failing silently, and retries or pauses according to the cause. See External sync.

​
Using Quickbooks for Customer Invoicing

In addition to syncing with Quickbooks for accounting purposes, you can also choose to use Quickbooks to send invoices directly to customers and to collect payments. For more information, see Quickbooks Invoicing.