Skip to main content

Company Settings: Breezy → QuickBooks Online Integration Settings (Full Breakdown)

Below is a breakdown of what each option in this QuickBooks Online integration page does, and when you might enable it.

Written by Ryan Pillsbury
Updated over 3 months ago

🟢 1. Authorization

Before any syncing can occur, your account must be connected to QuickBooks Online.

Authorized with QuickBooks
This indicates that Breezy is successfully connected and can send data to your QuickBooks company.

If you have not connected yet, please refer to this article to learn how to connect

If needed, you can disconnect and reconnect by clicking Manage Connection.


🔄 2. Sync Options

These settings control when Breezy automatically syncs financial data to QuickBooks Online.


Invoice Sync Triggers (Choose Only One)

There are three settings that determine when the invoice itself is sent to QuickBooks.
You should enable only one of these to avoid duplicate syncs or conflicts in QuickBooks.

Auto Sync Invoices when Issued

Syncs invoices to QuickBooks as soon as they are issued in Breezy.

Auto Sync Invoices on Payment

Syncs invoices each time a payment is recorded.
This option is best for workflows using deposits, split payments, or progress billing.

Auto Sync Invoices when Fully Paid

Syncs invoices only after the final payment is collected.


Why Only One Invoice Sync Trigger Should Be Enabled

QuickBooks does not automatically override or merge invoice updates if multiple sync triggers fire at different times.
If more than one is turned on, the same invoice may sync:

  • When issued

  • When a deposit is paid

  • When another payment is made

  • When the balance is fully paid

This causes:

  • Duplicate invoices

  • Overwritten or rejected updates

  • “Object Not Found” or “TxnID mismatch” errors

  • Partially synced invoices

Expected Behavior (Correct Flow)

If only “Auto Sync Invoices on Payment” is enabled:

✔ Breezy will sync the invoice the moment the first payment is applied
✔ Subsequent payments update the same invoice in QuickBooks
✔ No duplicates or conflicting changes occur

This is the only flow where “update/override on payment” works reliably.


Non-Conflicting Sync Options (Safe to Combine)

The options below do not conflict with invoice syncing and can be turned on together:

✔ Auto Sync Payments

Syncs payment records into QuickBooks but does not send invoices.

✔ Auto Sync Payouts

Syncs Breezy Payments’ payout deposits to your bank account in QuickBooks.

✔ Auto Sync Invoices on Voided

Only triggers when an invoice is voided — safe to combine with any setup.

✔ Enable Dynamic Tax Rate Calculation by QuickBooks Online

Allows QuickBooks to calculate tax instead of Breezy.

✔ Sync Discounts as Negative Line Items

Formats discounts in a way QuickBooks can properly report and track.

These settings work independently and do not affect when invoices sync.


🧾 3. Default Pricebook Income Accounts

These settings determine which Income Account in QuickBooks will be used for each type of Pricebook item.
If a Pricebook item does not have its own mapping, Breezy applies these defaults.


Default/Fallback Income Account

Used when no other income account is configured.
Applies to ad-hoc items or items missing specific mappings.

Equipment Item Income Account

Used for equipment items such as AC units, furnaces, and heat pumps.

Service Item Income Account

Used for service-based items such as tune-ups, repairs, and maintenance tasks.

Material Item Income Account

Used for materials such as filters, capacitors, refrigerant, and installation parts.

Labor Item Income Account

Used for labor-related items such as hourly charges or technician labor line items.

Maintenance Plan Item Income Account

Used for recurring charges such as service agreement fees or membership plans.

These mappings ensure revenue from different item types is correctly categorized in QuickBooks.


🏦 4. Payout Accounts (for Breezy Payments)

These settings control how Breezy syncs payouts, processing fees, and refunds from Breezy Payments into QuickBooks.


Payout Deposit Bank Account

Select the bank account where Breezy Payments deposits funds.
This is used for syncing daily or scheduled payout deposits.

Payout Fees Expense Account

Processing fees (discount fees, transaction fees) are recorded in this QuickBooks Expense account.

Payout Refunds Income Account

Refunds issued through Breezy Payments are recorded as negative income in this account.

Payment Processor Balance Account

A temporary “clearing” account used to track the movement of funds before payouts deposit into your bank.
This helps ensure accurate reconciliation in QuickBooks.


📝 5. Best Practices

✓ Enable Auto Sync Payouts to simplify reconciliation.
✓ Use accurate income accounts that match your accounting structure.
✓ If you operate in multiple tax jurisdictions, enable Dynamic Tax Rate Calculation.
✓ Review mappings with your accountant to ensure proper reporting.

Need Assistance?

If you're unsure which settings fit your workflow, reach out to our support team—we’d be happy to help configure your integration.

Did this answer your question?