Reports

Smart Reports

Reports built to prompt an action: what to stop stocking, and who to call before you lose them.

Last updated 2026-10-13

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

Requires subscriptionreports.smart_reports20,000 IQD / month

Overview

Standard reports tell you what happened. These four are framed around what to do next. All are available individually, and the combined smart view at GET /api/v1/reports/smart returns them together.

Reports — Smart reports
Smart reports
Smart reports — The combined smart view with top products, top customers, dead stock and at-risk customers.

Top products

Best sellers over the period, by revenue and by quantity — and the two do not always agree.

GET /api/v1/reports/top-products
ParameterTypeRequiredDescription
from_datedateOptionalStart of the period.
to_datedateOptionalEnd of the period.
TipA product high on quantity but low on revenue is a footfall driver; high on revenue but low on quantity is a margin product. Both are worth protecting, for different reasons.

Top customers

Who spends the most with you over the period.

GET /api/v1/reports/top-customers
ParameterTypeRequiredDescription
from_datedateOptionalStart of the period.
to_datedateOptionalEnd of the period.

Dead stock

Products that have not sold for a long time. This is money sitting on a shelf doing nothing, and it is usually the fastest cash to release.

GET /api/v1/reports/dead-stock
ParameterTypeRequiredDescription
from_datedateOptionalStart of the window used to judge whether an item has moved.
to_datedateOptionalEnd of that window.
WarningCheck dead stock against expiry dates before deciding what to do. Discounting something that will expire before it sells only converts a stock loss into a smaller stock loss — clearing it early is worth more than protecting the margin.

At-risk customers

Customers who used to buy regularly and have gone quiet. Reaching them before they settle somewhere else is far cheaper than replacing them.

GET /api/v1/reports/at-risk-customers
ParameterTypeRequiredDescription
from_datedateOptionalStart of the comparison period.
to_datedateOptionalEnd of the comparison period.
TipCross-reference this with the debt schedule. A customer who has stopped buying and owes money is the one to contact today.

Using them together

  1. Clear dead stock to release cash.
  2. Keep top products always in stock — a stockout on a best seller is expensive.
  3. Contact at-risk customers while they still remember you.
  4. Look after top customers before someone else does.

Related