🟢 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.



