WooCommerce’s analytics tables can be empty or part-way through an import, and a report built on them gives a confidently wrong answer.
store/get-sales-summary calculates the numbers from the orders themselves, and says which source it used.
At a glance
| Ability | store/get-sales-summary |
| Toolset | WooCommerce — toolset/woocommerce |
| Group | WooCommerce › Sales Insight |
| Requires | WooCommerce, active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
Pass from and to as YYYY-MM-DD. Omit from for all time; to defaults to today.
It counts processing and completed orders only — pending and failed orders are not revenue.
The result includes gross and net revenue, refunds, tax, shipping, average order value, distinct customers and the currency.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
from | string | No | Start date, YYYY-MM-DD. Omit for all time. |
to | string | No | End date, YYYY-MM-DD. Defaults to today. |
What comes back
| Name | Type | What it is |
|---|---|---|
orders | integer | Orders counted. |
gross_revenue | string | Revenue before refunds. |
refunded | string | Total refunded. |
net_revenue | string | Revenue after refunds. |
tax | string | Tax collected. |
shipping | string | Shipping charged. |
average_order | string | Average order value. |
distinct_customers | integer | How many different customers bought. |
currency | string | Store currency. |
counted_statuses | array | The order statuses counted as revenue. |
source | string | Where the figures were calculated from. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
How much did we sell last month, after refunds?
It resolves to one call:
{
"ability": "store/get-sales-summary",
"parameters": {
"from": "2026-08-01",
"to": "2026-08-31"
}
}Worth knowing
- Figures come from the orders, so they stay right even when WooCommerce Analytics hasn’t caught up.
- Pending and failed orders are excluded on purpose.
Related abilities
- List Top Products — what drove the revenue
- Get Store Status — whether derived data is current
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category