QuickBooks Online
Send accepted quotes to QuickBooks Online as invoices, map customers, products and tax rates, and review every export in the sync log.
Connect QuickBooks Online and XODASH turns accepted quotes into QuickBooks invoices for you. You decide which QuickBooks customer, product or service and tax code each one uses, and every export is listed in a sync log where it can be held for approval.
Who can do what
QuickBooks has its own role for each user, separate from their workspace role. A QuickBooks Admin sets it on the Team tab in Settings.
| Role | What they can do |
|---|---|
| QuickBooks Admin | Connect and disconnect, change settings and mappings, pause and resume sync, approve or reject exports, request an export |
| QuickBooks View | See the connection's status and the sync log |
| No QuickBooks | QuickBooks is hidden, including on quotes |
A workspace Admin invited by a QuickBooks Admin starts as a QuickBooks Admin. Everyone else starts with No QuickBooks, and a QuickBooks Admin can change it.
Connect QuickBooks Online
There is one QuickBooks connection for the whole workspace.
Open the QuickBooks Online card
Choose Marketplace in the sidebar and find QuickBooks Online.
Enter your app keys if asked
The first time, a workspace Admin may be asked for the QuickBooks app's Client ID and Client Secret. Enter them and choose Save & connect.
Sign in to QuickBooks
Sign in to Intuit and choose the QuickBooks company to connect.
Choose a default product or service
Open Settings → Integrations, find QuickBooks Online and choose Configure. On the General tab, pick a Default product/service. Invoices can't be exported until you do.
Once connected, the Marketplace card shows Connected · Manage, which takes you to the QuickBooks settings.
Configure the connection
Configure opens these tabs. QuickBooks View users see only the sync log.
- General: the Default product/service, used for quote lines with no product or service of their own, and payment terms. Each invoice uses the QuickBooks term whose name matches the quote's payment terms; otherwise XODASH sends a due date.
- Tax rates: which QuickBooks tax code each XODASH tax rate is booked under.
- Customers: which QuickBooks customer each XODASH company is invoiced as.
- Products/services: which QuickBooks product or service each catalog item is invoiced as.
- Exports & sync log: every export, with approvals.
Link customers to companies
On the Customers tab, search or filter (All customers, Linked, Not linked) and pick the XODASH company for each QuickBooks customer. Auto-match by name proposes links for customers whose name matches one company; only the matches you tick are linked.
When a company has no linked customer, the first export uses a QuickBooks customer with the same name, or creates one, and links it.
- Unlink a customer before moving it to another company.
- QuickBooks projects, sub-customers and inactive customers can't be linked.
- You can also link a customer from the company itself, in its Sources section.
Map products and services
On the Products/services tab, choose the QuickBooks product or service for each catalog item, or use Auto-match by name. For each quote line, XODASH uses, in order: a product or service a QuickBooks Admin chose for that line on the quote, the catalog item's mapping, an active product or service with the line's name, then the default.
A QuickBooks Admin can change the product or service for a single line from the quote's QuickBooks products/services section, until the quote is invoiced.
Map tax rates
XODASH calculates sales tax on the quote, and QuickBooks records the same amounts instead of recalculating them. On the Tax rates tab, choose a QuickBooks tax code for each XODASH rate and choose Save tax mapping. A quote that uses an unmapped rate can't be exported until the rate is mapped.
Import from QuickBooks adds your QuickBooks sales tax codes to XODASH's tax rates, one rate per code, or maps rates you already have. Your rates are listed in CRM settings → Tax Rates.
How invoices are sent
When a quote is accepted or signed, XODASH creates the invoice in QuickBooks. A payment taken through Stripe is recorded in QuickBooks too.
The quote shows its QuickBooks state: Awaiting approval, being sent, failed, or Not in QuickBooks yet. A QuickBooks Admin can choose Sync to QuickBooks… on a quote to request an export by hand; a requested export always waits for approval.
XODASH never exports the same quote twice, even if it is accepted again.
Pause sync and approve exports
Turn Automatic invoice sync off with Pause sync. While paused, accepted quotes are held for approval instead of being sent.
Resuming doesn't send held exports. A QuickBooks Admin approves each one in Configure → Exports & sync log.
Open the sync log
In Configure, open Exports & sync log and choose Pending approval.
Review an export
Open an export to see exactly what will be sent: the customer, each line with its product or service and tax code, the terms and due date, and the total. Nothing is written until you approve.
Approve or reject
Approve to send it to QuickBooks, or reject it with an optional reason. Rejected exports are never sent.
The sync log lists every export with its time, quote, company, operation, trigger, status, QuickBooks ID, details and approver. Filter it by All, Pending approval or Failed.
Disconnect
Disconnect stops quotes exporting to QuickBooks for everyone in the workspace. Invoices already in QuickBooks are not changed.