Skip to main content
QuickBooks setup should happen after the workspace can run clean operational flows. If items, customers, suppliers, lots, and shipments are not reliable yet, fix setup, imports, and reports before connecting.

​
Setup order

  1. Confirm the workspace has clean customers and suppliers.
  2. Confirm item SKUs and finished goods are correct in Inventory.
  3. Confirm receiving, production, and shipment flows create the movement history finance expects.
  4. Connect QuickBooks from the QuickBooks surface.
  5. Run an initial sync to create or match customer and item mappings.
  6. Review sync issues before treating reports as ready for close.

​
What gets mapped

Batchlane recordQuickBooks target
CustomerQuickBooks customer
SupplierQuickBooks vendor
ItemQuickBooks item or configured accounting target
Movement summariesAccounting handoff context
The exact accounting workflow depends on the workspace’s finance process. Batchlane should provide operational truth, not replace the accounting ledger.

​
Connection states

  • Connected: OAuth tokens are present and sync can run.
  • Action required: QuickBooks needs reconnect or token refresh recovery.
  • Disconnected: Sync will not run until the workspace reconnects.
See Common errors for reconnect and configuration failures.

​
Configuration notes

  • OAuth credentials are stored server-side and refreshed before sync calls.
  • If QuickBooks says reconnect is required, reconnect before retrying sync.
  • If sync reports mapping issues, resolve them before month-end review.
  • If default income or expense account configuration is missing, item sync cannot finish until those settings exist.
Related pages: QuickBooks handoff, Reports, Address book, FAQ.