Export Payments to QuickBooks¶
Customer payments become QuickBooks Payments, and vendor payments become QuickBooks Bill Payments. In both cases the payment is linked to the QuickBooks invoice or bill it settles, so the document is marked paid on the QuickBooks side too.
Before you export¶
The payment must be in state Paid or In Process.
The invoice or bill it settles must already exist in QuickBooks. If it does not, the connector exports it first and then links the payment to it.
For bill payments, the payment journal must resolve to a QuickBooks bank account — see Map QuickBooks Accounts and Journals in Odoo.
How payments are exported¶
Automatically — registering a payment in Odoo exports it as soon as it is posted and reconciled. Payments created through Register Payment on an invoice are exported after reconciliation, so the link to the right document is already known.
Manually — go to , set Direction to Export, pick Payments & Bill Payments, choose a Period matched on the payment date, and click Start Sync. Customer payments and bill payments are both exported in one run.
How the payment is linked¶
The connector reads the reconciliation behind the payment and builds one QuickBooks line per document it settles, each carrying the amount applied to that document. A payment spread across three invoices arrives in QuickBooks as three linked lines, not one lump sum.
If no reconciliation is found — for example a payment recorded but not yet matched — the connector falls back to the document you are working from, and applies the full payment amount to it.
Note
A payment that settles nothing the connector can identify is skipped, not exported as an unapplied balance. Reconcile it against an invoice or bill first.
Bank and deposit accounts¶
Customer payments are deposited to the QuickBooks account resolved from the payment journal, sent as the deposit account. If none resolves, QuickBooks applies its own default undeposited-funds behaviour.
Bill payments are sent as a Check drawn on the resolved QuickBooks bank account.
Warning
A bill payment with no resolvable QuickBooks bank account is skipped and logged. Map the journal’s bank account under Account Mappings, or set a Default Payment Journal on the connection whose account is mapped.
Check the result¶
The payment form carries a QuickBooks Sync section with the read-only QuickBooks ID and Exported to QBO flag, and the chatter records the QuickBooks ID on success. Failures are logged under the Payment (Export) operation at .
Note
Payment export failures do not roll back the Odoo payment — unlike invoices, the payment stays posted and the failure is logged for retry. Nothing is lost, but check the log after a bulk payment run.