Reports
AI Business Insights
A short set of marketing recommendations generated from your own trading figures.
Last updated 2026-10-13
DigitalKey ERP — Docs · digital-key.co/docs/reports/ai-insights
Requires subscription
reports.ai_analysis20,000 IQD / monthHow it works
- The system summarises your recent trading — totals, top products, top customers.
- That summary is sent to Anthropic's Claude API with a prompt in your chosen language.
- Claude returns exactly five recommendations, one per line.
- They are parsed and displayed as a numbered list.
Reports — AI insights panel

What is sent
Only an aggregated business summary leaves the system — sales totals for the period, your top five products and your top five customers.
WarningCustomer names form part of the summary that is sent to the AI provider. If that is a concern for your business, do not subscribe to this feature — there is no setting that anonymises the summary before it is sent.
NoteNothing is sent unless you ask for insights. The request is made only when you generate them, not on a schedule.
Language
POST /api/v1/reports/ai-insights
| Parameter | Type | Required | Description |
|---|---|---|---|
language | string= ku | Required | One of ku, ar or en. Anything else falls back to ku. |
The prompt itself is written in the requested language, so the recommendations come back in Kurdish, Arabic or English natively rather than being translated after the fact.
What comes back
| Parameter | Type | Required | Description |
|---|---|---|---|
ok | boolean | Optional | Whether generation succeeded. |
insights[] | array | Optional | The five recommendations, one string each. |
error | string | Optional | Why it failed, when ok is false. |
language | string | Optional | The language actually used. |
generated_at | timestamp | Optional | When the analysis was produced. |
Example response
{
"ok": true,
"data": {
"ok": true,
"insights": [
"Bundle your two best-selling products at a small discount to raise average order value.",
"Contact the eight customers who have not purchased in 60 days with a returning-customer offer.",
"Move slow-moving stock to a visible front-of-shop position before discounting it.",
"Introduce a wholesale price level for your five largest customers to protect volume.",
"Review purchase costs on your top product — its margin is below the shop average."
],
"language": "en",
"generated_at": "2026-08-06T09:14:22Z"
},
"error": null
}When it fails
Generation can fail without breaking anything else. Common causes:
- No API key configured on the server.
- The AI provider is unreachable or rate-limiting.
- Not enough trading data yet to summarise usefully.
NoteA failure returns
ok: false with a reason and changes nothing in your data. It is always safe to try again.How much to trust it
ImportantThese are suggestions generated from a short summary of your figures. They carry no knowledge of your market, your suppliers, your staff or your obligations. Treat them as prompts for a conversation, not instructions — and never act on one that contradicts what you know about your own business.
TipThe most useful way to read the output is as a checklist of things to verify. Anything that surprises you is worth confirming in Smart Reports, where the underlying numbers are visible.
Related
- Smart Reports — the data behind the recommendations.
- Feature Store — subscribing.
- Finance — checking a suggestion against the numbers.