Listar ventas por cliente
Herramienta MCP: reports_get_sales_by_client.
Devuelve una LISTA paginada de clientes con sus métricas de compra en un periodo: qué compró cada uno, cuántos documentos emitió y cuánto gastó.
Úsala cuando el usuario pregunte qué clientes compraron en un periodo o el detalle de las compras de un cliente concreto. Para los totales agregados, del tipo "¿cuánto compraron los clientes en total?", usa reports_get_sales_by_client_totals en su lugar. Para preguntas del tipo "qué clientes" o "quiénes compraron", usa esta herramienta.
Ejemplo de llamada JSON-RPC:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "reports_get_sales_by_client",
"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 clientName, sellerId y warehouseId son parámetros de primer nivel, y el ordenamiento usa order_field junto con order_direction.
Solo lectura.
Request
- Base URLhttps://mcp.alegra.com
- URLhttps://mcp.alegra.com/tools/reports_get_sales_by_client
- AuthHTTP bearer
Request body
Response
Lista paginada de clientes con sus métricas de compra
Changes
No recorded changes to this operation across all 1 revision of this API.