Unapproveby Atesen Software

Guides → Void an invoice that has a credit note allocated: a guide for Xero users

Void an invoice that has a credit note allocated: a guide for Xero users

You want to void an invoice, but a credit note is allocated to it, and sometimes a prepayment or overpayment too. The allocation has to come off first. This guide covers why, how to do it by hand, what to decide about the credit note afterwards, where the manual way stops being practical, and what Unapprove does with these documents.

Checked against Xero Central on 23 October 2026.

Why the void will not go through

Xero's rule is that you can only void an invoice that is awaiting payment (Delete or void an invoice). A credit note that covers what is owing leaves the invoice fully paid (Common scenarios for credit notes), and Xero says that removing the allocation puts the credit note and the invoice back to awaiting payment (Remove a customer credit note allocation). Xero's pages quote no error message for this, so read it as the documented rule. A part-credited invoice follows the same route: allocation off, then void.

Is a void what you need?

If the credit note was raised to cancel this invoice, it has already done the job. For an invoice you have sent, Xero's advice is a credit note, so there is an audit trail. Voiding as well means taking the credit off, leaving the credit note nothing to cancel. If it covered only part of the invoice, the invoice is probably right and should stay. Void only when the invoice should not exist at all, and ask your accountant first if it has gone to the customer or sits in a reported period.

The native way, step by step

  1. Look at what is applied. Open the invoice and note every credit note, prepayment, overpayment and payment against it. One credit note can be spread over several invoices, so note the amount for this one.
  2. Check the lock date. After a lock date is set, users can't add or edit transactions dated on or before it. Compare the invoice and credit note dates with it first. An administrator can remove the lock date temporarily, but that is a decision about your books (Set up or remove lock dates).
  3. Remove the credit note allocation. Open the credit note from the Awaiting Payment or Paid tab, click the remove icon next to the amount allocated to this invoice, then click Delete. Only an approved credit note can be allocated (Create and approve a customer credit note).
  4. Remove any prepayment, overpayment or payment. For a prepayment, open it and click the remove icon next to the amount credited to the invoice (Edit or void a customer prepayment). For an overpayment, open the invoice, click Overpayment and use the remove icon. For a payment use Remove and Redo (Delete an invoice or bill payment).
  5. Void the invoice. It should now read awaiting payment. Open it, click the menu icon, select Void and confirm. Xero says to change the number before you void if you want to reuse it.
  6. Decide about the credit note. It is available again. Apply it to another invoice, leave it as credit for the customer, or void it if it only existed to cancel this invoice (Delete or void a customer's credit note).

Bills follow the same order: remove the allocation on the supplier credit note (Remove a supplier credit note allocation), then void. Xero lets you void several awaiting payment bills at a time (Delete or void a bill).

Where the native way runs out

The faster way: Unapprove

Unapprove is a web app that works with Xero. Its plain unapprove and void runs skip an invoice or bill that has a credit note or prepayment allocated. The preview lists each one with the reason, and nothing is written to it (why, which explains the same family of skips for payments).

Remove payments and void. This separate run does the steps above for a selection. Choose it, set the status filter to Paid or Any status (a fully credited invoice reads as paid), select the documents and preview. For each document it:

What it leaves alone, and tells you why: reconciled payments, batch payments and prepayment or overpayment allocations. A document with one is skipped whole, not half done. The credit note itself is not voided, so step six above is yours. You confirm by typing the count, for example VOID PAID 40. The guide to voiding many invoices with payments covers the payment side.

Documents dated on or before your lock date (why) and documents for an archived contact (why) are skipped too.

What access it asks for: your name and email to sign you in, read and write on invoices and bills, read and write on attachments, and read-only on organisation settings and contacts. The payments permission is requested only when you choose "Remove payments and void".

Price: free for 14 days, with unlimited previews and three documents processed in total. After that, $29 per month per connected organisation, or a one-off $49 Clean-up Pass for 7 days and up to 500 documents. Prices are in US dollars and exclude VAT and sales tax (added at checkout); the pricing page has the details.

Connect and preview free See pricing

Questions

Why won't Xero void an invoice with a credit note on it?
Xero's rule is that only an invoice awaiting payment can be voided, and an allocated credit note settles some or all of it. Remove the allocation first; Xero says the credit note and invoice then go back to awaiting payment.
Does removing the allocation delete the credit note?
No. The credit note stays and is available again. Apply it to another invoice, leave it as credit for the customer or void it.
Does the same apply to a prepayment or an overpayment?
Yes. Take the allocation off in Xero first. Unapprove leaves prepayment and overpayment allocations alone in every run, so a document with one is skipped and listed.
Should I void the invoice or let the credit note cancel it?
If the invoice was sent and the credit note already cancels it, leaving both keeps the audit trail Xero recommends. Void when the invoice should not exist at all, and ask your accountant if the period has been reported.
Who makes Unapprove?
Atesen Software, an independent developer. Unapprove works with Xero through Xero's public API; Xero does not make it and has not endorsed it.

Related guides