Reports

Reports

Analysis over a period you choose, rather than the fixed windows on the dashboard.

Last updated 2026-10-13

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

Overview

Reports answer questions the dashboard cannot: what sold best last quarter, which customers are worth keeping, what has not moved in months. Every report takes a date range.

Reports — Reports screen
Reports screen
Reports screen — The sales summary with its date range, grouping control and the resulting chart and totals.

The reporting features

Reports module — monthly price in IQD
ParameterTypeRequiredDescription
report.sales2,000 IQDOptionalThe Sales History screen, the sales report and the discounts report.
report.advanced_dynamic2,000 IQDOptionalWho bought what, and from whom — with every invoice line behind it.
reports.smart_reports20,000 IQDOptionalDead stock, at-risk customers and the combined smart view. Includes the sales and discounts reports.
reports.ai_analysis20,000 IQDOptionalAI-generated marketing recommendations.
Features that are no longer soldThe separate stock, customer, expense and discount report subscriptions (report.stock, report.customer, report.expense, report.discount) have been withdrawn. Businesses that already hold one keep it. The discounts report now opens with the Sales Report or Smart Reports.

The tabs

Reports screen
ParameterTypeRequiredDescription
Sales Reportsreport.salesOptionalRevenue, cost, profit and the chart over a period, with top products and top customers.
Discountsreport.salesOptionalItem-level and invoice-level discounts given.
Smart Reportsreports.smart_reportsOptionalBest sellers, dead stock and customers at risk.
AI Insightsreports.ai_analysisOptionalGenerated recommendations in your language.
Advancedreport.advanced_dynamicOptionalThe Advanced Dynamic Report. Its own product — not included in Smart Reports.

Sales summary

GET /api/v1/reports/sales-summary
ParameterTypeRequiredDescription
from_datedateRequiredStart of the period.
to_datedateRequiredEnd of the period.
group_bystring= dayRequiredHow data points are grouped along the period.
category_idintegerOptionalRestrict to one product category.
payment_typestringOptionalRestrict to cash or postpaid sales.
What it returns
ParameterTypeRequiredDescription
total_revenuedecimalOptionalTotal sold in the period, net of returns made in the period.
total_costdecimalOptionalWhat those goods cost you when they were sold.
gross_profitdecimalOptionalRevenue less cost.
profit_margindecimalOptionalGross profit as a percentage of revenue.
total_invoicesintegerOptionalNumber of invoices.
total_itemsintegerOptionalNumber of items sold.
average_order_valuedecimalOptionalRevenue divided by invoice count.
data_points[]arrayOptionalThe series behind the chart, grouped as requested.
TipAverage order value is one of the most actionable figures here. Raising it through bundling or upselling is usually cheaper than finding new customers to raise revenue by the same amount.

Standard reports

  • Top products — best sellers by revenue or quantity, so you know what to keep in stock.
  • Top customers — who spends the most, so you know who to look after.
Requires subscriptionreport.sales2,000 IQD / month
NoteVoided invoices are excluded from every report, and so are sales orders that have not been completed. A report run today for a past period can therefore differ from the same report printed earlier if something has been voided since.
The breakdowns are gross, the total is netThe headline revenue is net of returns. The grouped breakdowns — per day, top products, top customers — show what was sold before returns. When there are returns in the period, the breakdowns add up to more than the headline. Quantity columns count line units: a carton line counts as 1.

In this section