QuickBooks Online Sync
What Landscapt sends to QuickBooks, when it sends it, and what to do when something doesn't show up.
On this page
What this integration does
The QuickBooks integration keeps your QuickBooks Online books current from Landscapt so you don't enter the same invoice or payment twice. Landscapt sends customers, invoices and payments (including refunds, voids and invoice edits) to QuickBooks automatically.
Only records created after you connect are sent. Invoices and payments that already existed in Landscapt are not backfilled, so QuickBooks never ends up with duplicates of work you already entered there by hand. A payment counts from when it is applied to an invoice, so a prepayment or deposit taken before you connected is sent once you apply it to an invoice afterwards.
Connecting, step by step
- Sign in to Landscapt as an admin (only admins can connect or disconnect QuickBooks).
- Go to Landscapt Settings → Integrations (the same card also appears under Settings → Accounting) and click Connect QuickBooks.
- Sign in to Intuit, choose the QuickBooks company to connect, and approve access. You're sent back to Landscapt, and the card shows Connected — your company name.
- That's all the setup there is. From here on, sending an invoice or taking a payment pushes it automatically.
How clients match QuickBooks customers
Every Landscapt client becomes one top-level QuickBooks customer. The first time a client needs to be sent, Landscapt looks the client up by display name:
| What QuickBooks has | What happens |
|---|---|
| A customer with exactly the same name | The client is linked to it automatically. |
| A customer with exactly the same name that is already linked to a different client | Two clients never share one QuickBooks customer. This client gets its own customer, named with its account number — for example "John Smith (acct #1042)" (a short reference code instead, for a client with no account number). |
| A customer with exactly the same name that is inactive in QuickBooks | The invoice shows "This client's QuickBooks customer is inactive". Make the customer active again in QuickBooks, or link the client to a different customer from its QuickBooks section, then Retry. |
| No similar customer at all | A new QuickBooks customer is created from the client's name, email, phone and billing address. If QuickBooks already uses that name for a vendor or employee, the customer is created as "Name (acct #number)" instead. |
| Only similar names (for example "Pam Trainor" vs "Pamela Trainor") | Landscapt won't guess. The invoice shows a sync error until you pick the right customer — open the client, find the QuickBooks section, click Sync to QuickBooks, and choose a match or None of these — create new. A customer already linked to another client can't be chosen. A new customer takes the client's plain name when QuickBooks has it free, otherwise "Name (acct #number)". |
Commercial parent/child client hierarchies are not mirrored: each client, parent or child, is its own top-level customer in QuickBooks.
Invoices
An invoice is sent to QuickBooks as soon as it leaves draft — emailed, printed, or marked Sent. Drafts are never sent.
| In Landscapt | In QuickBooks |
|---|---|
| Invoice number | Same number, so you can find it by the number on the invoice. |
| Line items | A line whose name matches one of your services uses a dedicated QuickBooks item for that service (created the first time it's needed). Any other line goes under a shared "Services" item. Lines you hide on the Landscapt invoice (the eye icon) still go to QuickBooks as their own lines, so QuickBooks shows every line. If you hide lines, send the customer's invoice from Landscapt (email, print or the online invoice), not from QuickBooks. |
| Terms and due date | The terms (for example Due on receipt or Net 30) pass through as the matching QuickBooks term, and the due date carries across. |
| Discounts | Sent as a single discount line. |
| Sales tax | QuickBooks calculates tax itself. Landscapt finds or creates a QuickBooks tax code at the invoice's rate (named "Landscapt 6.25%", for example), marks the taxable lines, and lets QuickBooks work out the amount. Landscapt then compares QuickBooks' total to its own and records any difference under Sync Status. |
| Already in QuickBooks | Before creating an invoice, Landscapt looks in QuickBooks for an open invoice with the same number for the same customer and links to it instead of creating a copy (for example after reconnecting, or an invoice you also entered there by hand). If its amounts differ it is updated to match Landscapt, the same as an edit. The same number on a different customer's invoice is treated as a different invoice. |
| Edits after sending | Saving the invoice, changing a line, the taxable flag, the number, the date or the terms updates the same QuickBooks invoice. It doesn't create a second one. |
| Voiding | Voiding the invoice in Landscapt voids it in QuickBooks. Void is final in both: to bill the work again, use Duplicate as draft on the void invoice, and the new invoice is sent to QuickBooks as its own invoice once it is issued. |
Payments, refunds and chargebacks
- Recorded and online payments. A payment you enter, and a card or ACH payment collected through Stripe (staff charge, autopay, client portal or invoice link), is sent to QuickBooks as a payment applied to the invoice. If the invoice isn't in QuickBooks yet it is sent first.
- Split payments. A payment applied across several invoices becomes one QuickBooks payment per invoice.
- Reference number. A check number or reference you enter appears in QuickBooks as the payment reference (QuickBooks shortens it to 21 characters).
- Refunds. Refunding a payment in Landscapt voids the matching QuickBooks payment when it is refunded in full, or reduces it for a partial refund.
- Editing a payment. Changing a payment's amount, date, reference or how it is split updates the matching QuickBooks payments. Moving it to a different invoice voids the QuickBooks payment on the old invoice and sends one for the new invoice, so the money is never counted twice.
- Lowering an invoice total. When an invoice's new total is less than what was paid on it, the extra moves to the client's credit in Landscapt, and the QuickBooks payment is reduced (or voided) to match before the QuickBooks invoice is updated.
- Applying credit. Applying a client's prepayment, deposit or account credit to an invoice sends it to QuickBooks as soon as it is applied.
- Merged clients. After Merge Clients, invoices that were already in QuickBooks stay on the QuickBooks customer they were created under, and payments on them are sent to that same customer — QuickBooks doesn't allow moving a paid invoice to another customer. New invoices go to the surviving client's customer.
- Write-offs. An AR write-off isn't money received, so it goes to QuickBooks as a credit memo applied to the invoice, not as a payment.
- Chargebacks. When a card dispute takes the money back, the QuickBooks payment is voided or reduced the same way.
See Online Payments & Stripe for how clients pay, and Invoicing for invoice statuses.
When things sync
| Event | Timing |
|---|---|
| Send, print or mark an invoice Sent | Immediately. |
| Edit or void a sent invoice | About two seconds after you stop editing. |
| Take, edit or refund a payment, or apply credit | Immediately. |
| Anything that was missed | A safety-net job runs every 15 minutes and catches invoices and payments created or changed outside the normal screens — for example by the API, Zapier, an automation, or a payment edit or invoice change that wasn't sent right away. It leaves anything touched in the last 10 minutes alone, and re-tries failed items about once an hour. |
Sync Status and retrying
Under Settings → Accounting, right below the QuickBooks connection, the Sync Status panel lists every invoice and payment that failed to sync, with the reason. It appears for users with the QB Reconciliation permission, and the Retry button needs the QuickBooks Resync permission.
| You see | What to do |
|---|---|
| Client match is ambiguous | Choose the right customer from the client's QuickBooks section (see above), then Retry. |
| QuickBooks totals $X but this invoice is $Y | QuickBooks calculated a different total than Landscapt, usually tax. Check the tax settings on the QuickBooks company and the invoice, then fix whichever is wrong. |
| This invoice was voided in QuickBooks and can't be reopened there | The invoice was voided in QuickBooks directly. Landscapt can't undo that — create a new invoice instead. |
| Changed in Landscapt — waiting to update the QuickBooks payment | The payment was edited (or its invoice total lowered) and the QuickBooks payment hasn't been updated yet. It usually clears within seconds; otherwise the 15-minute job or Retry updates it. |
| QuickBooks has more than one open invoice #N for this customer | Landscapt can't tell which one is this invoice. Void the extra one in QuickBooks, then Retry. |
| A payment's refund or chargeback didn't update in QuickBooks | Click Retry. Landscapt re-runs the void or the reduction on the QuickBooks payment and clears the error once it goes through. |
| QuickBooks error or connection expired | Retry. If it keeps failing, click Connect QuickBooks again (or disconnect and reconnect) and choose the same QuickBooks company. That refreshes the sign-in and keeps every link. |
What does not sync
- Anything entered or changed in QuickBooks — the sync is one-way.
- Invoices and payments created before you connected (no backfill).
- Prepayments, deposits and credits that aren't applied to an invoice yet. They are sent when you apply them.
- Estimates, contracts, jobs, purchase orders, and vendor bills.
- Per-service income accounts and class/location tracking — services map to QuickBooks items only.
Disconnecting or reconnecting
Click Disconnect on the QuickBooks card to stop syncing; Landscapt also revokes its access at Intuit. Nothing is deleted in either system, and Landscapt remembers which QuickBooks company it was connected to.
Reconnecting the same company picks up where it left off: every client, invoice and payment keeps its link, so nothing is sent twice, and invoices and payments created while you were disconnected are sent by the 15-minute job. An invoice QuickBooks already has is matched by number and customer rather than created again.
Connecting a different company starts fresh. Landscapt forgets the old links, because they only mean something in the old company, and only invoices and payments created from that moment on are sent, so the new company isn't filled with your whole history. Nothing in the new company is overwritten with data meant for the old one.
Good to know
- Account credits. A credit you record for a client and apply to an invoice is sent to QuickBooks as a credit memo applied to that invoice, the same way an AR write-off is, so the invoice closes in both places.
- Synced invoices are voided, not deleted. An invoice that has been sent to QuickBooks can't be deleted in Landscapt. Void it instead, and the void is sent to QuickBooks.
- “Name exists as a vendor or employee”. QuickBooks won't create a customer whose name already belongs to a vendor or employee, so Landscapt creates it as "Name (acct #number)" instead. Only if that name is taken too does the invoice show this message and stop retrying. Rename the client or link it to an existing QuickBooks customer, then edit and save the invoice to retry.
- Editing a payment. Changing a payment's amount, date, reference or split keeps its link to the QuickBooks payment, which is updated rather than sent a second time. An invoice taken out of the split has its QuickBooks payment voided.
- Plans without Landscapt. On the Equipt plan, the 15-minute safety-net sync of Landscapt invoices and payments is paused; it picks up again once the plan includes Landscapt.
- Several companies, one Landscapt. Each Landscapt company keeps its own QuickBooks links. Two companies connected to two different QuickBooks files never collide, even when QuickBooks gives their payments the same number.