Review QuickBooks Logs¶
Every call the connector makes to QuickBooks is recorded. When a document does not appear where you expect it, the log is the first place to look — it holds the message, the full error detail, the request that was sent, and a one-click retry for failed exports.
Open it at . The list opens filtered on Errors.
Reading a log entry¶
Date — when the call was made.
Direction — Import (from QuickBooks) or Export (to QuickBooks).
Operation — what was being done, e.g. Invoice (Export), Chart of Accounts, Tax Fallback (Export).
Reference — the document number or partner name involved.
Status — Success, Error, Warning or Skipped.
Message — the plain-language summary.
Open an entry for the rest: the full Error / Detail returned by QuickBooks, the related Odoo record, and the Request and Response tabs holding the raw JSON.
Filters and grouping¶
The search panel gives you the usual cuts:
Errors, Success, Warnings — by status.
Import, Export — by direction.
Can Retry — failed operations the connector can attempt again.
Group by Status, Operation or Config.
Tip
Grouping by Operation on the Errors filter is the quickest way to spot a systemic problem — twenty failures under one operation is a configuration issue, twenty spread across all of them is usually a connection or credentials problem.
Act on a log entry¶
Open — jumps to the Odoo record the entry refers to, when it has one.
Retry — re-runs the failed export. Available on Error entries flagged as retryable, for invoice, bill and credit note exports.
Note
Retry re-runs the export from scratch. Because the connector checks QuickBooks for the document number first, a retry after a partial failure links to the existing record rather than creating a duplicate.
Warnings worth watching¶
Warnings do not stop a sync, but they mean something was exported differently than you may expect:
Operation |
What it means |
|---|---|
Tax Fallback (Export) |
A document was exported with lines marked non-taxable because its Odoo taxes have no QuickBooks tax code, or it mixed inclusive and exclusive taxes. See Map Odoo Taxes to QuickBooks Tax Codes. |
Products |
A product was skipped because it has no SKU. |
Other |
A temporary QuickBooks invoice created by Quick Calc Taxes could not be deleted, or a record’s sync token could not be read. |
Other places to look¶
The document chatter — every export, link and failure is posted on the invoice, bill, credit note, payment, partner or product itself.
The import queue — for anything coming from QuickBooks, the per-document error lives on the queue line. See Process the Items Import Queue.
Activities — with failure notifications enabled, failures also raise a To Do for the responsible users.
Note
Logs are company-scoped and read-only. Users with the Billing Administrator access right can delete them, everyone else can only read.