Sales

Sales History

Finding a specific invoice among everything you have ever sold.

Last updated 2026-10-13

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

Requires subscriptionreport.sales2,000 IQD / month

Filters

Filters combine — set several and only invoices matching all of them are listed. The list is paged, newest first.

Filter bar
ParameterTypeRequiredDescription
SearchtextOptionalInvoice number or customer name.
ProducttextOptionalProduct name or barcode — lists every invoice that product was sold on.
From / TodateOptionalSales on or between the two dates.
TypechoiceOptionalAll, Cash or Postpaid.
StatuschoiceOptionalAll, Open or Returned.
GET /api/v1/sales
ParameterTypeRequiredDescription
from_datedateOptionalInclude sales on or after this date.
to_datedateOptionalInclude sales on or before this date.
customer_idintegerOptionalRestrict to one customer.
payment_typestringOptionalRestrict to cash or postpaid.
is_voidbooleanOptionalShow only voided, or only live, invoices.
returnedbooleanOptionalShow only invoices with a return against them.
invoice_nostringOptionalFind by invoice number or customer.
productstringOptionalFind invoices containing a product, by name or barcode.
pageinteger= 1OptionalPage number for long result sets.
page_sizeinteger= 50OptionalRows per page, 100 at most.
Sales — Sales list with an invoice open
Sales list with an invoice open
Sales list with an invoice open — The invoice list on the left and the selected invoice with its lines, totals and actions on the right.
TipChasing an unpaid balance? Filter Type to Postpaid and compare each invoice's total against what was paid to see what is still outstanding.

Columns

Invoice list
ParameterTypeRequiredDescription
invoice_nostringOptionalThe number shown to the customer. INV-… for a POS sale, SO-… for a completed sales order.
sale_datetimestampOptionalWhen the sale was completed.
customer_namestringOptionalCustomer, or General Customer for an anonymous sale.
payment_typestringOptionalCash or postpaid.
totaldecimalOptionalInvoice total after all discounts.
paiddecimalOptionalAmount actually received.
remainingdecimalOptionalStill owed on this invoice — total minus paid.
statusbadgeOptionalVoid, Part Returned, Fully Returned, and “Edited n×” when the invoice has been changed.

Opening an invoice

Selecting a row opens the full invoice, from which you can:

  • See every line with its quantity, price, discount and what has been returned.
  • Reprint it on A4 or thermal — the print preview is also where one invoice can be shown in another currency.
  • Add or change its note.
  • Edit it, if it is from this month and you are allowed.
  • Record a return against it.
  • Void it, if you are allowed.
  • Open its edit history and return history.
Requires subscriptionpos.invoice_print5,000 IQD / month

Voided invoices

NoteVoided invoices are kept and remain visible — they are marked rather than removed, so the numbering stays unbroken and an auditor can see that a void happened. They are excluded from sales totals and reports. The owner can bring one back from the recycle bin.

Exporting

NoteThe sales list itself has no export button. To take sales out of the system, use the Advanced Dynamic Report, which prints and exports to Excel (CSV) with every invoice line behind it, or the other reports under Reports.

Related