QuickBooks & Xero Two-Way Sync
How DocuClipper validates required fields before export, keeps later edits in sync with QuickBooks Online and Xero, and lets you pick contacts, items, accounts, and tax codes straight from your connected company.
Last updated
DocuClipper doesn't just push invoices and bills into QuickBooks Online (QBO) and Xero once — it keeps them aligned. Before anything is sent it checks that the required fields are present, while you work it lets you pick contacts, items, accounts, and tax codes directly from your connected company, and after a record has been synced it pushes your later classification edits back automatically.
This article explains those three behaviors. For the step-by-step first export, see Import invoices and receipts into QuickBooks Online and Export invoices to Xero.
Pre-flight required-field validation
When you click sync, DocuClipper validates the invoice against the target accounting system before it makes any API call. If a field that QuickBooks or Xero requires is missing, the sync is blocked and you get a specific message telling you exactly what to fix — including the line number for line-level problems — instead of a cryptic error coming back from the accounting system.
What's required depends on the document type and the target:
| Target & document type | Header requirement | Per-line requirement |
|---|---|---|
| QBO — Invoice (receivable) | Customer | A numeric amount on each line |
| QBO — Bill (payable) | Vendor | A category/account or a product/service item, plus a numeric amount |
| QBO — Expense / Purchase | Payment account | A category/account, plus a numeric amount |
| Xero — Bill (ACCPAY) | Contact (supplier) | An account code, plus an amount |
| Xero — Sales Invoice (ACCREC) | Contact (customer) | An account code, plus an amount |
A blocked sync reads, for example:
Cannot sync to QuickBooks Online: this bill is missing a required Vendor. Please set it before syncing.
or, for a line-level gap:
Cannot sync to Xero: line 2 (Office Supplies) is missing a category/account. Please set it before syncing.
Fix the flagged field on the invoice detail page and sync again. The invoice rules and per-project default account features exist largely to fill these required fields in for you so validation passes on the first try.
Pick contacts, items, accounts, and tax codes from your connected company
Once a project is linked to QuickBooks or Xero, the mapping fields on the invoice detail page become searchable dropdowns that pull live from your connected company — so you map to records that actually exist instead of typing free text that might not match.
- Contact — start typing to search your QBO customers/vendors or Xero contacts.
- Item / product-service — start typing to search the items and products defined in QBO or Xero. (Previously only the contact field was a connected dropdown; the item/product field now works the same way.)
- Category / account — pick from your chart of accounts.
- Tax code / tax rate — pick from the tax codes (QBO) or tax rates (Xero) configured in your company.
Each dropdown searches as you type. If the record you need doesn't exist yet, you can create it inline — type the new name and choose the "create" option, and DocuClipper creates it in QuickBooks or Xero on export.
Automatic re-sync of later edits
If you edit an invoice or bill after it has already been synced, DocuClipper pushes the change back to QuickBooks or Xero automatically — you don't have to remember to re-export it.
How it behaves:
- Update, never duplicate. Re-sync only updates the record that already exists in the accounting system (matched by its stored ID). It never creates a second copy.
- Classification fields only. Re-sync covers the fields you typically correct after the fact: category/account, product/service item, and tax code. Identity and amount fields (quantity, unit price, line description) are not re-pushed — change those before the first sync.
- Both systems. Works for QBO invoices, bills, and expenses, and for Xero bills and sales invoices. (Purchase orders are not re-synced.)
- Best-effort. Your edit always saves in DocuClipper immediately. The re-sync runs in the background; if the accounting system rejects it (for example a bill that's already locked or paid), the edit still sticks in DocuClipper and the failure is recorded so you can retry. The sync status badge and its timestamp update when the push succeeds.
This is what makes a bulk-apply of a category to every line, or a single corrected GL code, flow through to QuickBooks or Xero without a manual re-export.