Reports

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.

post/tools/reports_get_sales_by_item_totals

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/reports_get_sales_by_item_totals
  • Auth
    HTTP bearer

Request body

fromstring required

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

tostring required

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

Response

Resumen agregado de las ventas de productos

Changes

No recorded changes to this operation across all 1 revision of this API.