Test and troubleshoot the QuickBooks Online Zaps
Test each Zap with a sample customer before it touches your books, then use this list when an invoice is missing, a customer appears twice or a total is a few cents out.
- 5/5 on G2
- 4.2 on Capterra
- Building QuoteCloud since 2013
Test with a test customer, a test quote sent to @example.com signers and a small test payment. Zapier tests run against your real QuickBooks company, so void test invoices afterwards. Most problems come from four things: a customer search that misses, tax set differently, an invoice number the payment Zap can't find, and line items that arrive as text.
Last reviewed by the QuoteCloud team
How do I test the QuickBooks Zaps?
- 1
Make test records
A customer named so it's obviously a test, a test quote template and signers at @example.com addresses.
- 2
Sign a test quote
Send it to your @example.com address, tick an option, sign it and check the invoice's lines and total in QuickBooks.
- 3
Pay a small deposit
Pay a small test deposit through Stripe or PayPal and check the payment lands on the right invoice.
- 4
Test each Zap step
Zapier tests each step against the real apps: a test of Create Invoice creates a real invoice in your company.
- 5
Tidy up
Void or delete test invoices and payments with your bookkeeper, then switch the Zaps on.
The usual problems, and the fix
The customer appears twice
Use Find or Create Customer, not Create Customer, and search on the same value every time: email for households, company name for businesses.
The total is out by the tax
Rate must be before tax, and the tax code must be the one you charge. Compare the test invoice's tax line with the quote's.
Find Invoice finds nothing
The deposit Zap searches on the invoice number. Use the QuoteCloud reference as the Invoice Number, with Auto Generate off.
All the lines land in one
If the line items arrive as text, map them with Formatter by Zapier's line-item tools, or use one summary line with the total.
The PDF won't attach
Generate or Fetch Document PDF Link is short-lived. Run it right before Attach File(s) or Note, in the same Zap.
An invoice for half a signature
Use Document Signing Complete, which waits for every signer. Recipient Signed Document fires for each one.
What a good test leaves behind
After a test of the invoice and deposit Zaps, the test invoice should show the signed lines, the quote's total, the signed PDF and the deposit applied, with the right balance due.
If anything is missing, open the Zap's run in Zapier's history: each step shows the data it received and what it sent.
Check every field against the field mapInvoice · No. WP-2214Leah & Marcus Odellleah.odell@example.com
Partly paidCustomer found by a Zap
| Product/service | Qty | Rate | Amount |
|---|---|---|---|
| Heat pump, 270 LHW-HP-270 | 1 | $4,360.00 | $4,360.00 |
| Remove & dispose of old unitHW-REMOVE | 1 | $260.00 | $260.00 |
| Plumber & apprenticeLAB-PL | 5 | $145.00 | $725.00 |
| Tempering valve & fittingsFIT-TMV-15 | 1 | $210.00 | $210.00 |
| Isolation valve & connectionsFIT-ISO | 1 | $168.00 | $168.00 |
| Safe tray & overflowFIT-ST | 1 | $185.00 | $185.00 |
Lines added by a Zap from the signed quote
- Subtotal
- $5,908.00
- Tax
- $590.80
- Total
- $6,498.80
- Deposit paid in QuoteCloudTue 20 Oct · card through Stripe · Added by a Zap
- −$1,299.76
- Balance due
- $5,199.04
Attachments
- WP-2214 signed.pdf
Illustration with sample data: a generic accounting record, not QuickBooks Online’s screen.
Test it with a free trial
Start a free 14-day trial of QuoteCloud and test your QuickBooks Zaps with a sample customer before they touch a real one.
Why keep test data out of your real totals?
Tests talk to the real apps. A test of Create Invoice makes a real invoice in your QuickBooks company, and a test of Create Payment records a real payment, so test with a customer made for testing and tell your bookkeeper what you're doing.
Void or delete test invoices and payments afterwards, the way your bookkeeper prefers. QuickBooks' Zapier app has a Void Invoice action if you'd rather tidy up with a Zap of its own.
- None of these Zaps creates a QuoteCloud document, so testing them carries no QuoteCloud per-document fee.
- What the connection costs in Zapier tasks.
Troubleshooting questions
Why did the Zap create a second customer?
Because the search didn't match. Find or Create Customer creates a customer only when its search finds nothing, so search on a value both apps share exactly: the email for households, the company name for business customers. Check spelling and spaces in both apps.
Why is the invoice total a few cents different from the quote?
Usually tax. QuickBooks applies tax through its own settings, so check the tax code on the lines and whether tax is calculated per line or on the total. Map rates before tax, as QuoteCloud's prices are, then compare a test invoice with the signed quote.
Why didn't the deposit land on the invoice?
Usually Find Invoice found nothing. It searches by invoice number, so the invoice Zap must use the QuoteCloud reference as the Invoice Number. Also check the invoice Zap ran first: a deposit paid seconds after signing can arrive before the invoice exists, so add a short Delay by Zapier step before Find Invoice.
Do test runs cost anything in QuoteCloud?
Not for these Zaps. None of them creates a QuoteCloud document, so they carry no per-document fee. Each Zap step that runs uses tasks on your Zapier plan, which Zapier bills separately.
More on QuoteCloud and QuickBooks Online
Five use cases with the exact Zapier steps, then how to connect, test and what it costs.
- Turn signed quotes into QuickBooks invoicesWhen every signer has signed, a Zap finds the customer and creates the QuickBooks invoice, with the signed PDF attached.
- Accepted quotes as QuickBooks estimatesFor staged jobs: the signed proposal becomes an accepted QuickBooks estimate, ready to invoice stage by stage.
- Record QuoteCloud payments in QuickBooksDeposits paid in QuoteCloud become payments on the invoice; jobs paid in full become sales receipts.
- Keep QuickBooks customers and QuoteCloud contacts matchedNew QuoteCloud contacts found or created as QuickBooks customers, and new customers added to QuoteCloud.
- QuickBooks Products and Services and the QuoteCloud product libraryAdd new QuickBooks items to the QuoteCloud product library by SKU, and know where the two lists differ.
- Connect QuickBooks Online to QuoteCloud, step by stepCheck the plans, connect QuoteCloud and QuickBooks Online in Zapier, build the invoice Zap and test it.
- QuoteCloud to QuickBooks Online field mapEvery field the QuickBooks Zaps on this site pass, which way it travels and a sample value.
- What QuoteCloud with QuickBooks Online can and can't doWhat the Zaps do, where they stop, Zapier or Make, and what we haven't confirmed yet.
- What the QuickBooks Online connection costsEssentials and up for Zapier. None of the recipes here creates a QuoteCloud document, so none carries the per-document fee.
- FAQAnswers to the questions bookkeepers and owners ask before connecting QuoteCloud and QuickBooks Online.
Tested, then trusted.
Start a free 14-day trial and test QuoteCloud's QuickBooks Online Zaps with a sample customer.
Test & troubleshootFree 14 days · no card
Start free trial