QuickBooks Online Integration
Connect your project workspace to QuickBooks Online so clients, contracts, invoices, payments and purchase orders can be sent across without retyping them. This guide explains the connection, the mapping settings that prevent failed exports, and what happens to each record type.
Connecting to QuickBooks Online
Open Admin > Accounting, find the Integrations box, and choose Connect beside QuickBooks Online. Sign in with your QuickBooks Online credentials — these are separate from your project-system login — then confirm the company connection. You will return to the admin console, where a Disconnect option confirms the link is active. Admin privileges in QuickBooks Online are needed to manage that connection.
Settings, accounting codes and tax
After connecting, the QuickBooks Online Settings box lets you choose which transaction types to send and set a default Service/Product. That default is the fallback for estimate and invoice lines. If no Service/Product can be determined for a line, the transaction fails in the export queue. Use Accounting Codes to map your QuickBooks Services/Products: import them, then assign codes at line-item level first, then at project-type or work-order-type level, then rely on the overall default. This order matters — check it before blaming the connection when an export fails. General Ledger Accounts link purchase orders to the right inventory, sales and expense accounts. Sales tax rates can be imported from QuickBooks Online via Admin > Configure so tax flows through consistently.
Checking the Export Queue
The Export Queue has Pending and Complete tabs. Pending items are waiting or have an error shown in the Message column; completed items have been sent. Review that message first — most failures trace back to a missing Service/Product or accounting code.
Clients and customers
Clients in the project system become Customers in QuickBooks Online. A client can be created automatically when a transaction exports, or immediately from the Client Details screen if you have export permission and the client is not already linked. Matching first tries email address, then exact first and last name. Email is the more reliable match because it uniquely identifies a customer. Existing QuickBooks Customers are reused rather than duplicated. To bring customers the other way, use Import Customers in QuickBooks Online Settings and choose a lead status, typically Customer; large imports may take several minutes.
Contracts, invoices, payments and purchase orders
Contracts export as Estimates, but only after the proposal, estimate, contract or change order is marked sold. Task groups normally become estimate lines; subtasks appear only for Markup on Cost pricing when accounting codes differ within a group. The exported estimate links the customer, uses the contract number with -bp appended to the QuickBooks reference, and carries over tax rate, discounts, payment schedule in the message, class tracking where enabled, and the generated PDF as an attachment. Invoices queue on creation and reuse the contract's accounting codes when linked to a contract; otherwise each line needs its own code or a type-level default. Payments queue on creation and link to the exported invoice. Material and subcontractor purchase orders also queue on creation when those options are enabled, keeping inventory, supplier and expense data aligned.
| Record type | QuickBooks Online name | When it queues |
|---|---|---|
| Clients | Customers | On transaction export or manually from Client Details |
| Contracts | Estimates | After the contract is marked sold |
| Invoices | Invoices | As soon as created |
| Payments | Payments | As soon as created |
| Purchase orders | Purchase orders | As soon as created |
Enable each type in QuickBooks Online Settings; only selected types are attempted.
Frequently asked questions
How will integrating with QuickBooks help my business?
Once connected, clients, contracts, invoices and payments can move from the project system into QuickBooks Online so the same information does not need to be typed again. Enable only the transaction types you want to send.