Skip to main content

Problems

Archived Cliniko invoice is still open in Xero

Archiving is a Cliniko action. It removes the invoice in Cliniko and archives any payments attached to it, and nothing about that reaches Xero, so the Xero invoice stands exactly as it was. The correction happens in Xero: take the payment off first, because Xero blocks changes while a payment is applied, then void.

Key facts

What archiving does in Cliniko
Removes the invoice from the invoice list, and archives any payments attached to it at the same time1
What reaches Xero
No archive message. The bookkeeper source that documents this says the integration does not carry the archive across, so the invoice has to be voided in Xero by hand7
What a void does to the invoice number
It keeps it. Xero's instruction is to change the number on the invoice before voiding where the practice means to issue that number again9
How the Xero invoice came to be paid
When an invoice is marked as paid in Cliniko, that paid status also gets sent to Xero, so the invoice gets marked as paid in Xero too4
Who can archive an invoice
Administrators, power receptionists and bookkeepers1
Why the correction happens in Xero
Cliniko's own article says Xero locks it out of making changes to an invoice once that invoice is paid2
The constraint behind the order
Once payment is applied, no further changes to that invoice are permitted6
The error an edit in Cliniko produces instead
Payments can only be made against Authorised documents2
What the ledger carries meanwhile
Revenue for the month that includes an invoice the practice system no longer holds, and a settlement balance that will not come back to zero7
Where the synced payment sits
One of the clearing accounts in the canonical template, such as 100, Medicare clearing, which is a bank type account posted BAS excluded8

What archiving actually does

Archiving an invoice in Cliniko is a tidy up inside Cliniko. The article that tells you how to do it opens by finding the invoice you need to remove, and it says that any payments attached to that invoice are archived with it. It does not mention Xero anywhere. That absence is the whole problem: a reader following those steps correctly is not told that the other half of their ledger is untouched.

So the practice ends the day with two systems that disagree and nothing that looks like a failure. Cliniko no longer holds the invoice. Xero holds it, the payment against it, and every posting the two made on the way through.

  • In Cliniko the invoice leaves the invoice list, and any payment attached to it is archived at the same time.
  • In Xero the invoice keeps the status it already had. An unpaid one stays authorised and keeps ageing in accounts receivable. A paid one stays paid.
  • No sync error arrives, so nothing on either screen says the two sides have parted company.
  • Only administrators, power receptionists and bookkeepers can archive an invoice, so the person who did it can usually be found and asked what they meant to happen.

Why nothing reaches Xero

The integration pushes invoices to Xero as they are created in Cliniko and payments once they are allocated. It is a one direction feed of things that happened, not a mirror of the invoice list, and removing something from that list is a different kind of event the feed has no message for.

You may assume that when you archive an invoice in Cliniko, that action results in the invoice being removed in Xero also. But that's not the case. The integration doesn't have this funcationality, so you will need to manually "void" the invoice in Xero so that your Accounts Receivable figures are correct.7

That is a bookkeeper describing what they find in client files, and it is the only source read for this page that states the behaviour directly. Cliniko's own integration article lists several things that do not travel to Xero, including unallocated payments and credit allocations, and archiving is named in neither the list of what travels nor the list of what does not. So the behaviour is attributed here rather than quoted from the vendor, and that gap is worth knowing about before an argument with a support desk.

The archive that does travel runs the other way. Cliniko's failed sync article says that where the patient has been archived in Xero, Xero treats them as no longer active and will not accept the invoice, which is a different problem with the same word on it: duplicate patient contacts in Xero works through that one.

What it leaves in the ledger

An archived invoice that was never paid leaves an authorised invoice in Xero that ages quietly in accounts receivable, so the practice appears to be owed money nobody is chasing. An archived invoice that was paid is worse, because it touches two legs at once. The revenue leg keeps the sale: in the canonical allied health template a private clinic invoice sits in account 400, Clinical services, private patients. The settlement leg keeps the receipt against a clearing account, and that balance no longer represents anything a funder is going to pay.

The bookkeeper source lists the same three consequences from the other end: accounts receivable that overstates what is owed, clearing accounts that do not return to zero, and a larger bill when the accountant has to unpick both before a BAS or a tax return. None of the three announces itself; they surface when somebody is trying to close a period.

Decide what actually happened before you touch anything

A void is right for two of the four cases below, and reaching for it first is how a real deposit ends up unmatched. The question to answer is not what Cliniko now shows. It is whether money moved, and whether the practice kept it.

The correcting document, by what the archive was actually for17
What the archive was forWhat Xero still holdsThe correcting document
An invoice raised in error, never paidAn authorised invoice ageing in accounts receivableVoid the invoice
An invoice raised in error, marked paid in Cliniko but no money arrivedA paid invoice and a payment sitting against a clearing accountRemove the payment, then void the invoice
A real session that was paid, then refunded to the payerA paid invoice matched to a real depositA credit note on the same account and tax rate, then a refund against it
A real session that was paid, and the money was keptA paid invoice that agrees with the bankNothing in Xero. The archive was a Cliniko housekeeping choice

The refund case has its own document set and its own page: a refund recorded in the practice system needs a credit note rather than a void, because the sale did happen and reversing it is a separate event the ledger has to show.

The order of operations in Xero

Where the answer is a void, the order is not optional. Xero refuses changes to an invoice while a payment is applied to it: Zanda's export article states it as no further changes being permitted once payment is applied, and Cliniko's failed sync article says the same thing from its own side, that Xero locks it out of sending any changes over once the invoice is marked paid. So the payment comes off first, and the invoice will accept the void only after it does. Where the invoice falls in a period that has been locked or a quarter whose BAS has been lodged, the correction is a larger question than the order below, and a document date before the lock date covers what Xero will still take.

  1. Find the invoice in Xero by the number Cliniko gave it, not by the patient, who may have other invoices that are fine.
  2. Check the payment on it before removing anything, and note which account it was paid into and whether its bank statement line has been reconciled.
  3. Remove the payment. The invoice returns to awaiting payment and the clearing or bank account it was paid into gives back the amount.
  4. Void the invoice. Voiding reverses the accounting and keeps the record, and the number stays taken with it. To reissue that number, change it on the invoice before voiding: Xero refuses the second write on a number a voided invoice still holds.
  5. Post what really happened, if anything did, and match the bank line to that document instead.
  6. Leave a note against the void naming the Cliniko invoice, so the next person reading the file is not solving this again.
After the Cliniko archive beside After the Xero correctionOne Medicare invoice marked paid in Cliniko before the money arrived, shown twice: the state the Cliniko archive leaves in Xero, with the Cliniko invoice archived, the Xero invoice still paid, the payment still applied, revenue account 401, Clinical services, Medicare, still carrying the sale and clearing account 100 still holding the receipt, and the state after the payment is removed and the invoice is voided.After theClinikoarchiveAfter theXerocorrectionCliniko invoiceArchived, withits paymentArchived,with itspaymentXero invoicestatusPaidVoidedXero paymentStill appliedRemovedRevenue account401Carries thesaleSalereversedClearingaccount 100Holds areceipt formoney that didnot arriveReceiptreversedwith thepayment
Plate 1One funder invoice marked paid before the money arrived, as the archive leaves it and as the correction leaves it.

The bank line you already reconciled

This is the step the short answers skip. Cliniko's own reconciling article sends practices to Find and Match, where one bank statement line is matched against several Cliniko payments at once, so the payment being removed is often one line inside a deposit that was reconciled weeks ago. Plan for that match to need doing again with one payment fewer in it. That is not a reason to leave the invoice standing. It is a reason to do the whole sequence in one sitting, with the deposit in front of you, rather than removing a payment on a Tuesday and coming back to the bank on a Friday.

What it does to the settlement balance

A funder invoice that was marked paid in Cliniko before the money arrived posts a receipt into a clearing account, and the canonical allied health template gives each rail its own: account 100, Medicare clearing, is one of ten. Each is a bank type account, posted at the BAS excluded tax type, so the movement is a settlement movement and not a sale. The tax treatment lives on the revenue leg instead. Which account the receipt lands in is a Cliniko setting: a payment type can be pointed at a specific clearing account in Xero, and anything left unmapped goes to the default payment account on the integration.

Which is why an archived funder invoice shows up as a clearing balance that will not come back to zero. The receipt is sitting there waiting for a deposit that will not include it, and every later reconciliation of that rail is out by the same amount until somebody removes the payment. A balance that will not clear has its own page: what to check when a clearing account will not clear.

Catching it before the BAS

Nothing flags an archive, so the check has to be a standing one. Two counts and one balance are enough to catch it monthly, and all three take less time than unpicking a quarter at the end of it.

  • Count the invoices Cliniko raised for the month and the invoices Xero holds for the month. A gap of one or two is usually an archive.
  • Read the aged receivables list for invoices with no patient activity behind them. An archived unpaid invoice keeps ageing and nobody is chasing it.
  • Read each clearing balance against what the funder still owes. A balance that stays put through a payment run is holding a receipt for something that no longer exists.
  • Ask the person who archived it what they meant to happen, before choosing the correcting document.

What Ledger Map does with it

Ledger Map holds one standing map for the practice, approved before anything syncs, and posts one balanced document set per deposit so there is one exact match left in the bank feed. An invoice that stops appearing on the practice system side is a difference rather than a silent gap: it becomes a question with the invoice, the payment and the deposit it belongs to shown together, and the practice decides whether it is a void, a credit note or a housekeeping change that needs nothing.

The account codes on this page are read from the canonical template the practice starts from, the same one behind the chart of accounts a practice approves at setup. The Cliniko integration page covers the rest of what does and does not travel between the two systems.

Questions

  • Does archiving an invoice in Cliniko void it in Xero?

    No. Archiving removes the invoice inside Cliniko and archives any payments attached to it, and the bookkeeper source that documents this says the integration does not carry the archive across. The Xero invoice keeps whatever status it had, so an unpaid one keeps ageing and a paid one stays paid.

  • Can I reverse an invoice in Xero once it has been paid?

    Yes, by voiding it, and the payment comes off first. Both Cliniko and Zanda state the same constraint from their own sides: Xero will not accept changes to an invoice while a payment is applied to it, and an attempt made from Cliniko returns the error that payments can only be made against Authorised documents. Once the payment is off, the invoice returns to awaiting payment and will take the void.

  • Will removing the payment break my bank reconciliation?

    If that payment was part of a deposit you had already matched, expect the match to come apart and the statement line to need reconciling again. Note which deposit it belongs to before you start, then remove, void and re-match in one sitting.

  • Should I void the Xero invoice or raise a credit note?

    It depends on whether the session happened and whether the money was kept. An invoice raised in error is a void. A real session that was paid and then refunded is a credit note on the same account and tax rate, with a refund against it. A real session that was paid and kept needs nothing in Xero at all.

  • Can you restore a deleted invoice in Xero?

    This is why the correcting document here is a void rather than a delete. Voiding reverses the accounting and keeps the document, so the record of what happened survives and the invoice number stays taken. Xero's own article says to change the number before voiding where you want it back, and a deleted draft is the one case where the number comes free on its own. Cliniko's advice on a missing invoice is to search Xero with voided invoices included, which only works because the voided document is still there.

  • How do I stop it happening again?

    Agree who archives invoices and what they do in Xero afterwards, since the permission sits with administrators, power receptionists and bookkeepers rather than with everyone. Then run a monthly count of invoices raised against invoices held, so an archive shows up as a difference of one rather than as a clearing balance nobody can explain.

Sources

Open questions

  • Xero's article covers deleting and voiding an invoice and what happens to its number. What it does not cover is a payment already matched to a bank statement line, so the behaviour when that payment is removed is written here as a check to make rather than as a stated outcome.
  • Cliniko's own documentation does not say whether archiving triggers any call to Xero, or whether restoring an archived invoice pushes it back. Only the bookkeeper source describes the outcome, so this page attributes the behaviour rather than asserting it as documented vendor behaviour.
  • Whether a given archive needs a void, a credit note or nothing is a judgement about the practice's own facts. The page lays the cases out and leaves the choice with the practice and its bookkeeper.
  1. Archive an invoice

    Cliniko. Retrieved 3 Sep 2026. Source updated 5 Oct 2023.

    primary

  2. An invoice failed to sync with Xero

    Cliniko. Retrieved 3 Sep 2026.

    primary

  3. Integrate Cliniko with your Xero account

    Cliniko. Retrieved 3 Sep 2026. Source updated 28 Jul 2026.

    primary

  4. Reconcile in Xero when using the Cliniko integration

    Cliniko. Retrieved 3 Sep 2026. Source updated 28 Jul 2026.

    primary

  5. Sync payment types in Cliniko to specific clearing accounts in Xero

    Cliniko. Retrieved 3 Sep 2026. Source updated 18 May 2026.

    primary

  6. Exporting to Xero

    Zanda. Retrieved 3 Sep 2026.

    primary

  7. Xero and Cliniko, four common problems

    Festival Bookkeeping. Retrieved 3 Sep 2026.

    secondary

  8. Allied health by funding source, the canonical template

    Ledger Map. Retrieved 3 Sep 2026.

    primary

  9. Delete or void a sales invoice

    Xero Central. Retrieved 4 Sep 2026.

    primary

Review

Last reviewed 4 Sep 2026 by Shane

General information for Australian allied health practices, not tax advice. Confirm a treatment with your BAS agent or accountant before you post it.

Guided onboarding

Run one real month before you go live.

Sign up, connect Zanda and Xero, and replay a month you already closed. The map is reviewed with whoever owns the books, and nothing posts until you approve it.

Every practice starts from a template. Nothing posts until the map is approved.