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
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.
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.
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.
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.
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.
| InvoiceQuickly | Xero | Notes |
|---|---|---|
| Client company name, or name if there is no company | Contact name | If 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 ID | Contact 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 address | Email, phone and street address | Sent when the contact is created. A contact that was already exported is reused as it is. |
| Invoice number | Invoice number | Sent as it is, for example INV-0042. |
| Issue date and due date | Date and due date | The due date is only sent when the invoice has one. |
| Currency | Currency | Must be your base currency or a currency added to the organisation in Xero. |
| Each line: description, quantity, unit price | Line item description, quantity, unit amount | Every line uses your mapped revenue account code, in the order shown on the invoice. |
| Discount percentage | Discount rate on each line | The same percentage on every line, as InvoiceQuickly applies one discount to the invoice. |
| Tax rate | The Xero tax rate you mapped, tax exclusive | Xero calculates the tax amount. With the No tax mapping, lines are sent without tax. |
| Status | Draft on new invoices | Updates keep the status you set in Xero. |
| Notes, terms, payments, payment links, PDF and branding | Not sent | Record payments in Xero yourself. |
Scroll sideways to see every column.
Reference
When an export is refused, and what to do
| Situation | What InvoiceQuickly does | What to do |
|---|---|---|
| Mapping not saved yet | Refuses every export | Choose the revenue account and tax rates under Set up mapping. |
| The invoice's tax rate has no Xero tax rate | Refuses that invoice and names the rate | Edit the mapping and choose a Xero tax rate for it. |
| The invoice has tax but the mapping is No tax | Refuses that invoice | Switch the mapping to Prices exclude tax and map the rate. |
| The invoice currency is not in the organisation | Refuses that invoice; the checkbox is disabled | Add 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 credited | Leaves it unchanged | Make any change in Xero. |
| Estimate, credit note or cancelled invoice | Not offered or refused | Only invoices are exported. |
| No lines, or no client | Refuses that invoice | Add a line or a client to the invoice. |
| An earlier export was not confirmed and Xero has more than one invoice with that number | Stops instead of guessing | Delete, void or renumber the extra invoice in Xero, then export again. |
| Xero refuses the change, for example in a locked period | Shows Xero's message | Fix 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.
- Xero Developer: Accounting API, Invoices (checked 2026-10-29)
- Xero Developer: Accounting API, Contacts (checked 2026-10-29)
- Xero Developer: The standard authorization code flow (checked 2026-10-29)
- Xero Developer: Scopes (checked 2026-10-29)
- Xero Central: Import customer invoices (checked 2026-10-29)
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 BusinessLast verified: October 2026