Reports

Consultar rentabilidad por producto

Herramienta MCP: reports_get_profitability_by_product.

Devuelve una LISTA de productos con sus datos de rentabilidad en un periodo: ingresos (totalSold), costo (totalCost), ganancia (profit) y porcentaje de margen (profitPercentage). Devuelve hasta 10 productos. Se puede filtrar por nombre o referencia de un producto concreto.

Úsala cuando el usuario pregunte por la rentabilidad o el margen de los productos en un periodo: qué productos dejan más margen, cuánto costó y cuánto se ganó con cada uno. Para los totales agregados de rentabilidad, del tipo "¿cuál fue la ganancia total en productos?", usa reports_get_profitability_by_product_totals en su lugar. Para preguntas del tipo "qué productos" son más rentables, usa esta herramienta.

Ejemplo de llamada JSON-RPC:

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

Las fechas from y to son obligatorias y van en formato YYYY-MM-DD. La paginación start y limit son cadenas de texto: envíalas como texto (por ejemplo "0" y "10"), no como números; limit acepta como máximo 10. Los filtros y el ordenamiento van dentro de optionalParams, que debe enviarse como objeto JSON, nunca como cadena de texto.

Solo lectura.

post/tools/reports_get_profitability_by_product

Request

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

Request body

fromstring required

Fecha inicial del periodo, en formato YYYY-MM-DD.

tostring required

Fecha final del periodo, en formato YYYY-MM-DD.

startstring

Desplazamiento de paginación. Por defecto "0". Envíalo como texto, no como número.

limitstring

Máximo de registros a devolver, máximo 10. Por defecto "10". Envíalo como texto, no como número.

Response

Lista limitada de productos con sus datos de rentabilidad

Changes

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