QuickBooks Integration Documentation home
Back to Documentation home
Integration Guide Β· Finance

Bidsquare + QuickBooks Online.

Connect Bidsquare to QuickBooks Online, map your data once, and push clean invoices and settlements whenever you're ready. Bidsquare stays the single source of truth β€” you control exactly when data moves.

βš™οΈ

How it works

Three principles that govern every sync. Understand these first and the rest of the setup makes sense.

START HERE

The Bidsquare–QuickBooks integration keeps your accounting data accurate by making Bidsquare the single source of truth for all financial records.

  • Data flows one way β€” from Bidsquare to QuickBooks. QuickBooks never writes back to Bidsquare.
  • Syncs are manual β€” nothing pushes automatically in the background. You control exactly when data moves, so you can finalize invoices, payments and refunds in Bidsquare first, then push clean, complete data across.
  • Each sync is smart β€” when you run a sync, the system creates or updates customer and vendor profiles, invoices and bills, and accurately records deposits, payouts, voids and refunds exactly as they exist in Bidsquare at that moment.

πŸ”Œ

Setup guide

Four steps: connect, map your data, configure key settings, then test before you enable.

CONFIGURATION

Step 1 β€” Connect to QuickBooks

1
Open the QuickBooks settings
In your Bidsquare Admin panel, go to Settings β€Ί QuickBooks.
2
Start the connection
Click the Configuration tab, then click Connect to QuickBooks.
3
Authorize with Intuit
An Intuit login window appears. Sign in and authorize Bidsquare to connect to your QuickBooks company file.

Step 2 β€” Map your data

You can enable Invoice syncing (for buyers), Settlement syncing (for consignors), or both. The goal is to tell the system where each type of financial data should land in QuickBooks.

Invoices β€” Accounts Receivable (buyer data)

Map each Bidsquare field to a Product or Service in QuickBooks:

Bidsquare fieldSuggested QuickBooks Product / Service
Auction Items (per lot)"Auction Sales" or "Auction Hammer"
Buyer's Premium"Buyer's Premium"
Charges & Fees"Other Charges"
ShippingYour designated Shipping item
⚠️
Map the Deposit Account to a holding or escrow account β€” not your live bank

Select the QuickBooks bank account where incoming buyer payments should be deposited, but point it at a dedicated Holding or Escrow account, not directly at Checking or Savings. Mapping to a live bank account records payments as immediate transactions, which creates duplicate entries when you later reconcile your bank feed.

ℹ️
Leave Tax Codes set to Auto

This passes the exact sales tax amount from Bidsquare straight to the invoice, bypassing QuickBooks' internal tax calculations.

Settlements β€” Accounts Payable (consignor data)

Map each Bidsquare field to an Expense Category in your QuickBooks Chart of Accounts:

Bidsquare fieldSuggested QuickBooks Expense Category
Auction Items"Consignor Auction Hammer"
Commission"Consignor Commission"
Charges & Fees"Consignor Other Deductions"

Payment Account: select the bank account from which consignor payouts are drawn.

Step 3 β€” Configure key settings

Display Name Suffix. QuickBooks requires unique display names for customer and vendor profiles. If the same person is both a buyer and a consignor, their names would conflict. Enter a suffix (such as (C) or Vendor) that Bidsquare automatically appends to all vendor profiles. The default is (C) for vendor records; you can add a similar configuration for customers if desired.

Sync Start Date. Choose a date to limit how far back the sync reaches. The system ignores any invoices or settlements generated before this date, protecting your historical records from being overwritten. You can set this up to 18 months in the past.

Step 4 β€” Test, then enable

1
Run a Test Sync first
Before full sync is enabled, the system requires a test. Enter a known Bidsquare invoice or settlement number and click Test Sync.
2
Verify in QuickBooks
Open QuickBooks and confirm all line items, addresses and amounts look correct.
3
Enable and sync
Once you're satisfied, check Enable Invoice Sync and/or Enable Settlement Sync, click Update Config, then use the Sync Invoices and Settlements button whenever you're ready to push finalized data.

βœ…

Best practices

Habits that keep your two systems clean and your reconciliations painless.

RECOMMENDED

Sync at the right time

The best time to sync is after you've closed out your auction, processed refunds and finalized all payments in Bidsquare. A clean Bidsquare record means clean QuickBooks data. There are no restrictions on the volume or frequency of syncing β€” use your best judgement for your business.

Let Bidsquare manage customer & vendor profiles

Once you start using the integration, stop manually creating customer or vendor profiles in QuickBooks. The sync creates and updates them automatically based on email-address matching. Manual entries can create duplicates with conflicting information.

ℹ️
How matching works

Bidsquare links records to QuickBooks by exact email address. If a consignor's QuickBooks profile uses admin@example.com but their Bidsquare profile uses info@example.com, the system won't match them and will create a duplicate. Keep email addresses consistent across both systems.

Use the Sync Summary for troubleshooting

If any records fail to sync, open Sync Summary in Bidsquare. You'll see the exact error message from QuickBooks (for example, "missing billing address") so you know precisely what to fix. Correct the issue in Bidsquare and re-run the sync. Errors are isolated β€” if 2 of 1,000 records fail, the other 998 sync successfully and no data is lost.

Bulk check printing (QuickBooks 3-up format)

If you prefer printing consignor checks in QuickBooks' 3-up format:

  • Generate settlements in Bidsquare without marking them as paid.
  • Sync them to QuickBooks β€” they appear as open bills.
  • Use QuickBooks' Pay Bills feature to print your checks in bulk.
  • Return to Bidsquare, use Bulk Payout, and record the check numbers to close the loop.
⚠️
Negative-balance settlements

QuickBooks cannot create bills with a negative balance (money due from the consignor). Any settlement with a negative balance returns a validation error until it's returned to a zero or positive balance.

Restrict access & use per-lot line items

Only authorized accounting staff should configure mappings or trigger a sync β€” use Bidsquare Staff Permissions to hide the QuickBooks tab for everyone else. Bidsquare also syncs invoices with each lot on its own line item rather than one combined total, which is especially useful for invoices with mixed taxability (e.g. a taxable item alongside a non-taxable coin lot).


⚠️

Important notes & limitations

The edge cases worth knowing before they surprise you.

READ BEFORE GO-LIVE

Buyers and consignors are separate

Even with the display-name suffix in place, QuickBooks keeps strict separation between Customers (buyers) and Vendors (consignors). If someone is both, their invoices and settlement payouts appear on two separate profiles β€” there is no combined view in QuickBooks.

"Other Charges" are grouped

Custom fees (credit-card surcharges, insurance, photography, etc.) are combined into a single Other Charges line item. The individual breakdown is included in that line item's description field for your reference.

Third-party marketplace invoices (e.g. LiveAuctioneers)

Bidsquare does not pass third-party invoice numbers to QuickBooks. The recommended approach:

  • Import the third-party end-of-auction data into Bidsquare.
  • Leave those invoices unsent to the buyer.
  • Once the marketplace's auto-pay clears, mark the invoices as Paid in Bidsquare.
  • Sync to QuickBooks β€” the records appear in a single, consolidated view.

You don't need QuickBooks open to sync

The integration uses an API token that stays active for roughly 100 days. As long as your Bidsquare dashboard shows Connected, you can trigger a sync any time without being logged into QuickBooks. Syncs run in the background β€” you don't need to stay on the page while they complete.

Voids are preserved, not deleted

If you delete an invoice or process a full refund in Bidsquare after it's been synced, the next sync will not delete the QuickBooks record. Instead the invoice is marked Voided and the payment is un-applied. All original line-item data is retained, giving you a complete audit trail.

The "Pull Vendors" button

If a vendor was manually created in QuickBooks first and isn't matching correctly, use Pull Vendors from QuickBooks. This forces Bidsquare to fetch the latest vendor list and re-establish email matches before the next sync.

Turn off "Custom Transaction Numbers"

When QuickBooks' Custom Transaction Numbers setting is On, QBO forces any new invoice you create manually to continue the numbering sequence of the last invoice entered β€” which, after a sync, is a Bidsquare invoice number. Your non-auction invoices (storage, service billing) would then adopt the Bidsquare scheme and cause duplicate-number errors in future syncs. Turn it Off under Settings β€Ί Account and Settings β€Ί Sales β€Ί Sales form content so QBO manages its own sequence independently.

Turn off automated invoice reminders

Because Bidsquare is the single source of truth for buyer invoicing, all invoice communication should originate from Bidsquare. QuickBooks' Automated Invoice Reminders would email buyers about open balances on synced invoices β€” buyers who have often already paid through Bidsquare. Turn reminders Off under Settings β€Ί Account and Settings β€Ί Sales β€Ί Reminders.

⚠️
Don't leave reminders on

Leaving automated reminders enabled means buyers can be contacted twice about the same balance β€” once by Bidsquare and again by QuickBooks β€” which confuses customers and undermines the single-source workflow.

β›”
Caution: don't use "Deactivate Connection" to cancel a sync

The Deactivate Connection button permanently severs the link between Bidsquare and QuickBooks. Reconnecting afterward may create duplicate customer and vendor profiles. Only use it if you're permanently migrating to a different QuickBooks company file β€” it is not a way to pause or cancel an active sync.

πŸ’¬
Still have questions?

Email support@bidsquare.com referencing "QuickBooks API" in the subject line, or call 1-800-657-0092.


πŸ› οΈ

Common problems

The issues that come up most during and after setup β€” with the root cause behind each.

!
Buyers are receiving payment reminder emails from QuickBooks for invoices they've already paid
This happens when invoices were synced to QuickBooks while still unpaid, but the payment update was never synced back. QuickBooks sees open invoices and fires its automated reminders. Fix: sync again to push the updated Paid status, then turn off QuickBooks' Automated Invoice Reminders permanently (Settings β€Ί Account and Settings β€Ί Sales β€Ί Reminders). Leaving reminders enabled means buyers can be contacted twice about the same balance.
!
The Settlement Sync button isn't available β€” only Invoice Sync appears
Settlement syncing is locked until you complete a test sync of at least one settlement. Go to Settings β€Ί QuickBooks β€Ί Configuration, run a test sync using a known settlement, verify the result in QuickBooks, then enable Settlement Sync. The button updates to Sync Invoices and Settlements once both are enabled.
!
Nothing is appearing in QuickBooks after a sync
Nothing ever flows to QuickBooks automatically β€” every sync must be manually triggered from Settings β€Ί QuickBooks. A second common cause: Invoice Sync and Settlement Sync must each be individually enabled after the test sync. Check that both toggles are on. If both are enabled and nothing is appearing, open Sync Summary for error detail.
!
Tax validation error: "Make sure all transactions have a GST/HST rate before you save"
QuickBooks requires every line item to carry a valid tax code β€” blank is not accepted. Root cause is usually a missing or deleted tax code in your QuickBooks Products/Services configuration, or a mapping that isn't carrying tax values across correctly. Fix: ensure every Product/Service in your mapping has a default tax code set (or explicitly marked as 0%/exempt). Re-run the sync after correcting the configuration.
!
Zero-value or negative-balance payments are failing or being silently skipped
QuickBooks does not accept $0 or negative bill payments β€” they either fail outright or are skipped without a clear error. For zero-value settlements (where charges equal the hammer), remove the payment entry before syncing and record it as an internal note instead. For negative-balance settlements (money owed back to you by the consignor), see the Negative-balance settlements note in the Limits section β€” these require manual handling before sync.
!
"One or more QuickBooks configuration settings are missing"
This error appears when the account or product/service mapping is incomplete. Common gaps: a Product/Service mapping is blank, the Deposit Account hasn't been set, or the tax configuration is missing. Go to Settings β€Ί QuickBooks β€Ί Configuration and work through every mapping field β€” any blank field is a potential cause. Run a test sync after completing the configuration to confirm.
!
Calculation mismatch β€” totals sent don't match what QuickBooks expects
This typically surfaces when there are rounding differences between Bidsquare's per-lot line items and QuickBooks' recalculated total. It can also happen when fees (shipping, credit card surcharge) are structured differently from what the mapping expects. Fix: open the specific failing record in Sync Summary, compare the line-item breakdown against the invoice total, and identify which item is causing the discrepancy. Correct in Bidsquare and re-sync.
!
Sync errors on specific records β€” most records synced but some failed
QuickBooks rejects individual records without stopping the batch β€” so a sync can show "complete" while silently skipping some. Open Sync Summary and filter to errors only to see the exact message from QuickBooks for each failing record. Common causes: missing billing address, incorrectly formatted State field (causes TaxJar error), or a duplicate transaction number conflict. Fix the specific issue in Bidsquare and re-sync β€” errors are isolated and don't affect the records that succeeded.
!
Duplicate customer or vendor profiles are being created in QuickBooks
Bidsquare matches records to QuickBooks by exact email address β€” a single character difference creates a duplicate. A second cause is the entity-type conflict: the same person as both a buyer (Customer) and a consignor (Vendor) requires the display-name suffix configured in Step 3 to keep them separate. Fix existing duplicates: use Pull Vendors from QuickBooks to force a fresh match, then ensure email addresses are consistent across both systems. Stop creating customer or vendor profiles manually in QuickBooks once the integration is active.
πŸ’‘
The real error detail is always in Sync Summary

When a sync fails or partially fails, the most useful place to start is always Settings β€Ί QuickBooks β€Ί Sync Summary. The exact error message returned from QuickBooks appears there β€” most issues are data completeness or configuration problems rather than connection failures, and the error message tells you exactly what to fix.