ALalegra
Reports

Totalizar ventas por cliente

Herramienta MCP: reports_get_sales_by_client_totals.

Devuelve el TOTAL de las compras o transacciones de los clientes en un único objeto de resumen agregado, con subTotal, total y totalDiscount.

Úsala cuando el usuario pregunte por cuánto compraron los clientes en total en un periodo, sin necesitar cada cliente. Para la lista de clientes con sus métricas de compra usa reports_get_sales_by_client en su lugar.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_sales_by_client_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 clientName, sellerId y warehouseId son parámetros de primer nivel y opcionales.

Solo lectura.

post/tools/reports_get_sales_by_client_totals

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/reports_get_sales_by_client_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.

clientNamestring

Filtra por nombre del cliente. Si se envía, devuelve los totales solo de ese cliente; si se omite, los totales de todos los clientes.

sellerIdstring

Filtra por ID del vendedor asignado a los documentos. Úsalo cuando el usuario pida los totales de las ventas de un vendedor específico.

warehouseIdstring

Filtra por ID de bodega o punto de despacho. Úsalo cuando el usuario pida los totales filtrados por una bodega específica.

Response

Resumen agregado de las compras de los clientes

Changes

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