Skip to main content

Accounting: Invoice export

Xero integration: export invoices from InvoiceQuickly as drafts

On the Business plan ($19/month), an owner or admin connects one Xero organisation through Xero's own sign-in, chooses a revenue account with a code and a Xero tax rate for each tax rate the invoices use, and then exports the invoices they pick: up to 25 at a time from the Accounting page, or one at a time with Export to Xero on an invoice. Each export creates the client as a Xero contact if needed, then a draft sales invoice with its number, dates, currency, lines, discount and tax, ready for you to approve in Xero. Exporting the same invoice again updates it. InvoiceQuickly never emails the invoice, never charges your client and never records payments in Xero, and nothing changes in Xero until you choose Export.

How it works

Connecting Xero to InvoiceQuickly, step by step

  1. Step 1: Connect Xero as an owner or admin

    On Business, open Integrations, then Accounting, and choose Connect Xero. You sign in on Xero's page and approve access for an organisation. InvoiceQuickly asks only for invoices, contacts and read access to settings, plus offline access so the connection lasts; it requests no payments access, never sees your Xero password and stores the tokens encrypted. Team members without the owner or admin role cannot connect, map or export.

  2. Step 2: Choose the revenue account and tax rates

    Set up mapping lists the active revenue accounts in your chart of accounts that have a code; pick the one exported lines post to. Choose Prices exclude tax, then map each tax rate that appears on your invoices to an active Xero tax rate that applies to revenue. If you never charge tax, choose No tax, and only invoices without tax can be exported. Every choice is checked against Xero's current lists before it is saved.

  3. Step 3: Select the invoices to export

    The Accounting page lists your 50 most recent invoices, leaving out estimates and cancelled invoices, with each one's state in Xero. Tick up to 25 and choose Export. Each invoice is sent on its own, so one refusal does not stop the others. For a single invoice, open it and choose Export to Xero from its actions menu.

  4. Step 4: Review and approve the drafts in Xero

    New invoices arrive in Xero as drafts under Sales, Invoices. Check each against the invoice in InvoiceQuickly and approve it when it is right. If Xero calculates a different total, for example a cent of rounding because Xero works out tax line by line, the export result shows both totals.

  5. Step 5: Export again to update, and record payments in Xero

    Exporting an invoice again replaces the contact, number, invoice date, currency, lines, discount and tax in Xero, plus the due date when it is set. The status you set in Xero and everything else stays as it is. An invoice that already has a payment, credit note, prepayment or overpayment in Xero is left unchanged. Payments your clients make, including through Stripe or PayPal links, are recorded or matched in Xero by you.

Why connect it

What connecting Xero gives you

What you get

  • Each exported invoice keeps its InvoiceQuickly number, dates, currency, line descriptions, quantities, rates, discount and tax rate in Xero, instead of being copied by hand
  • New invoices land as drafts, so nothing posts to your ledger until you or your bookkeeper approve it in Xero
  • The client becomes a Xero contact with email, phone and street address, and a contact code that lets InvoiceQuickly find the same contact again
  • An export history of the latest 50 results, with Xero's own message when an export is refused
  • A safe retry: after a timeout, InvoiceQuickly looks for the invoice in Xero before creating it again, so a lost response does not leave a duplicate

Best for

  • Freelancers and consultants who invoice from InvoiceQuickly while they or their accountant keep the books in Xero
  • UK, Australian and New Zealand businesses that report VAT or GST from Xero and want each invoice checked as a draft before it posts
  • Bookkeepers who want the real invoice lines and tax in Xero without copying them from PDFs
  • Not a fit if you need payments to flow into Xero, invoices to arrive with no one choosing Export, or tax-inclusive prices: InvoiceQuickly prices exclude tax, so only tax-exclusive or no-tax exports are offered

Reference

What InvoiceQuickly sends to Xero

Field names on the right are Xero's. Only the invoices you export are sent, and only these fields.

InvoiceQuicklyXeroNotes
Client company name, or name if there is no companyContact nameIf another Xero contact already has that name, the first 8 characters of the client's ID are added in brackets, because Xero contact names must be unique. An existing contact is never taken over by name alone.
Client IDContact code (ContactNumber)Set to IQ- followed by the client's ID when the contact is created. InvoiceQuickly looks for this code before creating a contact, so a client keeps one Xero contact.
Client email, phone and addressEmail, phone and street addressSent when the contact is created. A contact that was already exported is reused as it is.
Invoice numberInvoice numberSent as it is, for example INV-0042.
Issue date and due dateDate and due dateThe due date is only sent when the invoice has one.
CurrencyCurrencyMust be your base currency or a currency added to the organisation in Xero.
Each line: description, quantity, unit priceLine item description, quantity, unit amountEvery line uses your mapped revenue account code, in the order shown on the invoice.
Discount percentageDiscount rate on each lineThe same percentage on every line, as InvoiceQuickly applies one discount to the invoice.
Tax rateThe Xero tax rate you mapped, tax exclusiveXero calculates the tax amount. With the No tax mapping, lines are sent without tax.
StatusDraft on new invoicesUpdates keep the status you set in Xero.
Notes, terms, payments, payment links, PDF and brandingNot sentRecord payments in Xero yourself.

Scroll sideways to see every column.

Reference

When an export is refused, and what to do

SituationWhat InvoiceQuickly doesWhat to do
Mapping not saved yetRefuses every exportChoose the revenue account and tax rates under Set up mapping.
The invoice's tax rate has no Xero tax rateRefuses that invoice and names the rateEdit the mapping and choose a Xero tax rate for it.
The invoice has tax but the mapping is No taxRefuses that invoiceSwitch the mapping to Prices exclude tax and map the rate.
The invoice currency is not in the organisationRefuses that invoice; the checkbox is disabledAdd the currency in Xero (it needs a Xero plan with multicurrency) or export base-currency invoices only.
The Xero invoice is paid, part paid or creditedLeaves it unchangedMake any change in Xero.
Estimate, credit note or cancelled invoiceNot offered or refusedOnly invoices are exported.
No lines, or no clientRefuses that invoiceAdd a line or a client to the invoice.
An earlier export was not confirmed and Xero has more than one invoice with that numberStops instead of guessingDelete, void or renumber the extra invoice in Xero, then export again.
Xero refuses the change, for example in a locked periodShows Xero's messageFix it in Xero, then export again.

Scroll sideways to see every column.

Setup

Setting it up

You need the InvoiceQuickly Business plan ($19/month or $190/year) and the owner or admin role in your InvoiceQuickly organization. Prepare Xero first. Make sure the revenue account you want has a code in the chart of accounts, and that each tax rate you charge exists in Xero's tax rates and can be used on sales. If you invoice in more than one currency, add those currencies in Xero; that needs a Xero plan with multicurrency, and without it only base-currency invoices export. Then connect from Integrations, Accounting, approve access on Xero's page for the organisation you want and choose the mapping. Export one invoice first, open the draft in Xero and compare its total with the invoice in InvoiceQuickly; when they match, export the rest and approve the drafts. Connecting a different Xero organisation later clears the mapping, while the export history of each organisation is kept.

Good practice

Best practices

Approve in Xero, but do not send from Xero

Your client already has the invoice and its payment link from InvoiceQuickly. Approving the draft records the sale; emailing the Xero copy would give the client two invoices with the same number and two ways to pay.

Avoid number clashes with Xero's own invoices

If Xero already numbers invoices INV-0001 onward, an exported INV-0042 can collide with one of them. Change the invoice prefix or next invoice number in InvoiceQuickly's Settings before your first export.

Match payments and fees in Xero

Payments recorded in InvoiceQuickly, including Stripe and PayPal link payments, are not sent. In Xero, record the payment on the approved invoice or use Find & Match during bank reconciliation, and add the Stripe or PayPal fee as a bank fee adjustment.

Map every tax rate before a batch

The mapping form lists each tax rate found on your invoices and warns about rates still unmapped. Map them all first, so a 25-invoice batch does not stop on one rate.

Troubleshooting

Common issues

"Choose the Xero tax rate for the 20% rate before exporting"

The invoice uses a tax rate that has no Xero tax rate in the mapping. Choose Edit mapping, pick the matching Xero rate, for example 20% (VAT on Income), save, then export the invoice again.

"Invoice INV-0042 already has payments in Xero, so InvoiceQuickly won't change it"

The Xero invoice is paid, part paid, or has a credit note, prepayment or overpayment applied, and Xero refuses most changes to such invoices. Make the correction in Xero, or issue a credit note in InvoiceQuickly and record the same credit in Xero.

The row says Not confirmed by Xero

The connection timed out or the response was lost, so InvoiceQuickly cannot tell whether Xero created the invoice. Export it again: InvoiceQuickly first searches Xero for that invoice number and contact, ignoring deleted and voided invoices, and updates the match instead of creating a second one. If it finds more than one, it stops and asks you to remove the extra one.

Xero's total is a cent away from InvoiceQuickly's

Xero calculates tax on each line, while InvoiceQuickly calculates it once on the discounted subtotal, so odd amounts can round differently. The export result shows both totals. Adjust the draft in Xero before you approve it if the client's copy must match to the cent.

The card says Reconnect needed

Xero no longer accepts the saved connection, for example after InvoiceQuickly was removed from the connected apps in Xero. Choose Reconnect Xero and approve access again for the same organisation; the mapping and history stay.

Scope

What the Xero connection does not do

  • It never sends invoices: InvoiceQuickly does not email your client, and new invoices stay drafts in Xero until you approve them.
  • It never charges your client and never records, matches or syncs payments in either direction. It does not request Xero payments access.
  • It is one-way and manual. Invoices go to Xero only when you choose Export, and payments, edits and statuses in Xero are not copied back into InvoiceQuickly.
  • The Accounting page offers your 50 most recent invoices, up to 25 per export; older invoices are exported one at a time from the invoice page.
  • Estimates, credit notes and cancelled invoices are not exported. Every line uses one revenue account, and notes and terms are not sent.
  • One Xero organisation per InvoiceQuickly organization, and prices are sent tax exclusive or without tax.
  • Business plan only. After a downgrade, owners and admins can still see the connection and history and disconnect, but cannot export.

Questions

Xero and InvoiceQuickly: questions

Does InvoiceQuickly integrate with Xero?

Yes, on the Business plan. An owner or admin connects a Xero organisation, chooses the revenue account and tax rate mapping, and exports selected invoices and their clients. Invoices arrive as drafts. It is a manual export of invoices you pick, not a payment or bank connection.

Are exported invoices approved or sent in Xero?

No. New invoices arrive as drafts, and InvoiceQuickly never approves, emails or sends them. You approve each one in Xero. Exporting again later keeps whatever status you set there.

Are payments synced between InvoiceQuickly and Xero?

No. The connection has no payments access, payments are not sent to Xero and nothing is read back. Record or match each payment in Xero, and mark payments in InvoiceQuickly as you do today.

What happens if I change an invoice after exporting it?

Export it again and InvoiceQuickly updates the same Xero invoice: contact, number, date, currency, lines, discount and tax, plus the due date when set. If the invoice is paid, part paid or credited in Xero, it is left unchanged and you make the change in Xero.

What if I am on Pro or use other accounting software?

Use the invoice CSV. On Pro, the CSV button on the Invoices page downloads every document with 13 columns, including number, client, dates, currency, subtotal, tax, discount and total, but no line items. You can copy those details into Xero's customer invoice template and import it under Sales, Invoices, Import.

Who can connect and export?

Owners and admins of the InvoiceQuickly organization. Members cannot see the Accounting page actions or the Export to Xero button.

What happens when I disconnect Xero?

An owner or admin chooses Disconnect on the Accounting page. InvoiceQuickly asks Xero to revoke its access and deletes the saved sign-in. The contacts and invoices already exported stay in Xero, and the export history stays in InvoiceQuickly. If Xero does not confirm the revocation, remove InvoiceQuickly from the connected apps in Xero as well.

Sources

Official documentation

The Xero steps on this page follow these official pages. Menus and plan limits change, so check them before you rely on a detail.

Create your first invoice

The Xero connection needs Business: $19/month or $190/year, with everything in Pro plus QuickBooks Online and Xero export and work imports from Clockify, Toggl Track, Harvest and ClickUp. Want to try invoicing first? The Free plan covers 5 invoices in total with PDF download.

Start with Business

Last verified: October 2026