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.

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

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

string
required

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

string
Defaults to 0

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

string
Defaults to 10

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

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.

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