Sales

Sales

Every completed sale, with the tools to find one, reprint it, correct it, return part of it or void it entirely.

Last updated 2026-10-13

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

Overview

The Sales screen is the record of what has actually been sold. A sale arrives here the moment it is completed in the POS, or when a sales order reaches completed.

Sales — Sales screen
Sales screen
Sales screen — The invoice list with its search, product, date, type and status filters, and the selected invoice open on the right.

Today's figures

The headline sales figures are shown on the Dashboard rather than above this list. They are net of returns.

GET /api/v1/sales/kpis/today
ParameterTypeRequiredDescription
today_salesdecimalOptionalValue sold today.
today_countintegerOptionalNumber of invoices today.
cash_salesdecimalOptionalValue taken as cash.
postpaid_salesdecimalOptionalValue sold on credit.
month_salesdecimalOptionalValue sold this calendar month.
total_outstandingdecimalOptionalStill unpaid across postpaid invoices.

What counts as a sale

A sale is a POS invoice (INV-…) or a completed sales order (SO-…) that has not been voided. A draft, pending or approved order is not a sale yet: it moves no stock and counts toward no revenue. Finance, reports and the dashboard all use this same rule, so their totals agree.

Edit, return or void?

Three different corrections exist and they are not interchangeable. Choosing the wrong one makes the books harder to read later.

 EditReturnVoid
Use whenThe invoice was keyed wronglyThe customer brings goods backThe sale should never have existed
ScopeLines, prices, customer, paymentSelected lines and quantitiesThe whole invoice
WhenCurrent month only, and before any returnAny timeAny time
WhoOwner, or staff given the edit permissionOwner, or staff with “Make a return” (on by default)Owner, or staff given “Void a sale”
Invoice afterwardsSame number and date, with an edit historyStays valid, with the return recorded against itMarked void, kept, restorable from the recycle bin
NoteA mistake on an invoice from an earlier month is corrected with a return, not an edit. A month that has been reported is never restated — the correction lands in the month it is made.

Notes and display currency

  • Note— an invoice's note can be added or changed after the sale from the invoice panel. It is printed on the invoice.
  • Currency — from the print preview, one invoice can be shown and printed in another currency at a rate you type. It is display only; see Main Currency.

In this section