Totalizar ventas por producto

Herramienta MCP: reports_get_sales_by_item_totals.

Devuelve el TOTAL de las ventas de productos en un único objeto de resumen agregado, con los montos monetarios totales totalAmountBeforeTaxes y totalAmount. Se puede filtrar por nombre o referencia de un producto concreto para obtener sus totales.

Úsala cuando el usuario pregunte por cuánto se vendió en total en un periodo (monto agregado), sin necesitar el listado por producto. Para el listado de productos con sus ventas usa reports_get_sales_by_item en su lugar.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_sales_by_item_totals",
    "arguments": { "from": "2026-09-01", "to": "2026-09-30" }
  }
}

Las fechas from y to son obligatorias y van en formato YYYY-MM-DD. Los filtros y el ordenamiento van dentro de optionalParams, que debe enviarse como objeto JSON, nunca como cadena de texto. Si se envía itemName o reference, devuelve los totales solo de ese producto; si se omiten, los totales de todos los productos.

Solo lectura.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Fecha inicial para el cálculo de los totales, en formato YYYY-MM-DD.

string
required

Fecha final para el cálculo de los totales, en formato YYYY-MM-DD.

optionalParams
object

Filtros y ordenamiento opcionales. CRÍTICO: este parámetro debe ser un objeto JSON, NUNCA una cadena de texto; no lo envíes como texto. Envíalo como objeto: {"itemName": "Nombre del producto"}. Si se envía itemName o reference, devuelve los totales solo de ese producto; si se omiten, los totales de todos los productos.

Responses

401

No autorizado (token de Alegra inválido o expirado).

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json