Sales

Void a Sale

Cancelling an invoice that should never have been raised, and everything that unwinds with it.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/sales/void-sale

Who can void

Permission by role
ParameterTypeRequiredDescription
ownerroleRequiredCan void POS sales and sales orders, always.
staffroleOptionalOnly if the owner switched the matching permission on. Otherwise the request is refused with a 403.
WarningThe two are separate permissions. Void a sale covers the counter; Void orders covers sales orders. A staff member who has one does not automatically have the other, and a new staff account starts with both switched off. The owner turns them on in My Account → Team → Permissions.

What gets reversed

Voiding a completed sale unwinds every effect it had:

  • Stock— every line goes back on the shelf, at the quantity sold (a carton line goes back as its pieces) and at the cost it left at, not today's cost.
  • Customer balance — for a postpaid sale, the debt it created is removed.
  • Sales totals — the invoice stops counting toward revenue in reports and KPIs.
  • The invoice itself — kept, marked is_void, with the reason, who did it and when.
  1. 1

    Open the invoice

    Find it in the sales list and open it.

  2. 2

    Choose Void

    The option only appears for someone allowed to void, on an invoice that is not already void.

    Sales — Invoice with the void action
    Invoice with the void action
    Invoice with the void action — An open invoice showing where the void action sits.
  3. 3

    Enter a reason

    The reason is optional but worth typing. It is stored on the invoice permanently and is what makes the void explainable months later.

  4. 4

    Confirm

    Stock and balances are reversed together in a single transaction — either all of it applies or none of it does.

POST /api/v1/sales/{id}/void
ParameterTypeRequiredDescription
reasonstringOptionalWhy the sale is being voided. Stored on the invoice.

Undoing a void

A voided sale goes to the recycle bin (My Account → Recycle Bin), where the owner can restore it. Restoring is a real transaction, not a flag: the stock is taken out again and the debt is put back on the customer.

WarningA restore is refused when the goods are no longer in stock, or when putting the debt back would take the customer past their credit limit. See Recycle Bin & Activity Log.

What cannot be voided

  • An invoice that is already void — the request is refused.
  • An invoice that does not belong to your business.

Voiding a sales order

A sales order can be voided from any status except void, by the owner or a staff member given Void orders. What that does depends on how far the order had progressed:

NoteStock and balances are only reversed if the order had reached completed. Voiding a draft, pending or approved order simply closes it — nothing had moved yet, so there is nothing to unwind.

Void, return or edit?

TipIf the customer is bringing goods back, record a return rather than voiding. A return handles part of an invoice and leaves the original sale standing, which is the honest record of what happened. If the invoice was simply keyed wrongly this month, edit it. Void is for sales that should never have existed — a duplicate, a test.

Related