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 subscriptionreports.ai_analysis20,000 IQD / month

How it works

  1. The system summarises your recent trading — totals, top products, top customers.
  2. That summary is sent to Anthropic's Claude API with a prompt in your chosen language.
  3. Claude returns exactly five recommendations, one per line.
  4. They are parsed and displayed as a numbered list.
Reports — AI insights panel
AI insights panel
AI insights panel — The generated recommendations with the language selector and the regenerate control.

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
ParameterTypeRequiredDescription
languagestring= kuRequiredOne 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

ParameterTypeRequiredDescription
okbooleanOptionalWhether generation succeeded.
insights[]arrayOptionalThe five recommendations, one string each.
errorstringOptionalWhy it failed, when ok is false.
languagestringOptionalThe language actually used.
generated_attimestampOptionalWhen 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