Test and troubleshoot the Xero Zaps
Test every Zap with a fictional quote before a real client signs, then use this list when a draft is missing, a line is wrong or a payment didn't land.
- 5/5 on G2
- 4.2 on Capterra
- Building QuoteCloud since 2013
Test with a template, an @example.com signer and, ideally, a test Xero organisation. Sign the test quote, pay a test deposit, then check the draft, the lines, the attachment and the payment in Xero. Most problems are a contact found by the wrong name, a line without an account, or a payment sent to a draft.
Last reviewed by the QuoteCloud team
How do I test the Xero Zaps?
- 1
Use test data
A test Xero organisation if you can, and a QuoteCloud quote from your real template sent to an @example.com address.
- 2
Sign it fully
Every signer signs, with an optional row ticked and one left unticked, so the line items show both cases.
- 3
Pay a test deposit
A small real payment on the test quote that you refund afterwards, so Document Part Paid has data to load.
- 4
Load and check the data
Load each trigger's test data in Zapier and check the fields you map: number, signer, lines, SKUs, amount.
- 5
Check Xero
The contact (no twin), the draft's lines and totals against the quote, the attachment opens, the payment or note is there.
The usual problems, and the fix
A second contact appeared
Find or Create Contact searched a name that differs slightly. Search by account number with the QuoteCloud contact ID, or use the business name the invoice goes to. Contacts.
A line was rejected
Xero needs an Item Code, or a Description and a Unit Price, and every line needs an account. Map Item Code, or set a fixed Account in the Zap.
Unexpected lines
Heading rows or unticked options in the line items? Look at the trigger's test data, and check how rows arrive before you go live.
The payment step failed
Xero records payments on approved invoices, not drafts. Use Paths: Create Payment when approved, Add Note to Invoice on a draft. Deposits.
No invoice found for the deposit
The deposit Zap ran before the invoice Zap finished. Add Delay by Zapier at the start, or create a separate deposit invoice.
The attachment is missing
The PDF link is short-lived, so it must be mapped in the next steps of the same Zap. Files over 3 MB won't attach: file them in OneDrive or Google Drive instead.
What a good test leaves behind
One draft on the right contact, with the quote number in Reference, the same lines and total as the signed quote, the signed PDF attached, and a note or a payment for the deposit.
Compare it line by line with the quote before you switch the Zap on, then delete the test invoice and contact in Xero, or void it if it was approved.
The draft-invoice recipeSales invoice · INV-1186Hannah Whitfieldhannah.whitfield@example.com
Draft- Reference
- RT-4127
- Date
- 14 Oct 2026
- Due
- Not set
- Amounts are
- Tax exclusive
| Item | Description | Qty | Price | Account | Amount |
|---|---|---|---|---|---|
CALL-STD | Call-out & site assessment | 1 | $95.00 | 210 · LabourTax on sales 10% | $95.00 |
LAB-PLMB | Licensed plumber | 3.5 | $118.00 | 210 · LabourTax on sales 10% | $413.00 |
LAB-ELEC | Licensed electrician | 1 | $125.00 | 210 · LabourTax on sales 10% | $125.00 |
HWP-270 | Heat pump, 270 L | 1 | $3,480.00 | 200 · SalesTax on sales 10% | $3,480.00 |
| + 4 more lines | |||||
- Subtotal
- $4,618.00
- Total tax 10%
- $461.80
- Total
- $5,079.80
- Amount due
- $5,079.80
Attachments
- PDFRT-4127 signed.pdf1.4 MB
History & notes
- Note: deposit $1,523.94 paid by card through Stripe on RT-4127Wed 14 Oct, 9:33 am · Added by a Zap
- Attachment added: RT-4127 signed.pdfWed 14 Oct, 9:32 am · Added by a Zap
- Draft invoice created, reference RT-4127Wed 14 Oct, 9:32 am · Added by a Zap
Illustration with sample data, not Xero’s screen.
Test it with a free trial
Start a free 14-day trial of QuoteCloud and run every Xero Zap with fictional data before a real client signs.
Why keep test data fictional?
Because a Zap does exactly what it's told. A test quote sent to a real client's address is a real quote, and an invoice in your live Xero file appears in your reports until someone removes it.
Use @example.com addresses, names you'd never invoice, and a test organisation in Xero where you can. When you switch to the live organisation, run one more test and remove what it creates.
- Leave new Zaps creating drafts until you trust the mapping.
- Zapier's run history shows what each step sent: the quickest way to see why a field was empty.
Troubleshooting questions
Why did the Zap create a second contact in Xero?
Because the search didn't match. Xero's Find or Create Contact searches by name or account number and creates a contact when nothing matches, so a slightly different name makes a twin. Keep the QuoteCloud contact ID in Xero's account number and search on that.
Why didn't the deposit show on the invoice?
Usually because the invoice was a draft. Xero records payments against approved invoices, so Create Payment fails on a draft. Add Paths so a draft gets a note instead, or create the invoice as Awaiting Payment. If no invoice was found at all, add a short delay.
Why is the attachment missing from the invoice?
Either the PDF link expired or the file was too big. Generate or Fetch Document PDF Link returns a short-lived link, so map it in a later step of the same Zap. Xero takes attachments up to 3 MB; larger PDFs belong in OneDrive or Google Drive.
How do I replay a run after fixing the Zap?
In Zapier's history, find the halted or failed run and replay it once the Zap is fixed. Check Xero first, so the replay doesn't create a second invoice or payment for a run that partly worked, and remove anything the first attempt left behind.
More on QuoteCloud and Xero
Five use cases with the exact Zapier steps, a page for bookkeepers, then how to connect and what it costs.
- Turn signed quotes into Xero draft invoicesWhen the last signer signs, a Zap creates a draft Xero invoice with the quote number as its reference.
- Price-table lines and Xero itemsThe chosen price-table rows as invoice lines, and your QuoteCloud product library kept in step with Xero items.
- Record QuoteCloud deposits in XeroDeposits paid on the quote through Stripe or PayPal, recorded against the Xero invoice by its reference.
- Attach the signed PDF to the Xero invoiceThe signed quote goes on the invoice as an attachment, in the same Zap, as the record of what was agreed.
- Find or create Xero contactsEvery invoice lands on the right Xero contact, and new contacts reach the other app without duplicates.
- QuoteCloud and Xero for accountants and bookkeepersWhat to set up in Xero, the controls that stay with you, month-end matching, and fee proposals to repeating invoices.
- Connect Xero to QuoteCloud, step by stepCheck the plan, connect QuoteCloud and Xero in Zapier, build the invoice Zap and test it.
- QuoteCloud to Xero field mapEvery field the Xero Zaps on this site pass, which way it travels and a sample value.
- What QuoteCloud with Xero can and can't doWhat the Zaps do, where they stop, Zapier or Make, and what we haven't confirmed yet.
- What the Xero connection costsEssentials and up for Zapier; Zaps that create Xero invoices, contacts or payments carry no QuoteCloud document fee.
- FAQAnswers to the questions finance teams ask before connecting QuoteCloud and Xero.
Tested, then trusted.
Start a free 14-day trial and test your Xero Zaps with fictional quotes before you switch them on.
Test & troubleshootFree 14 days · no card
Start free trial