---
title: "Totalizar ventas por vendedor"
method: POST
path: "/tools/reports_get_sales_by_seller_totals"
tags: ["Reports"]
---

# Totalizar ventas por vendedor

`POST /tools/reports_get_sales_by_seller_totals`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/reports_get_sales_by_seller_totals`
- Auth: HTTP bearer

Herramienta MCP: `reports_get_sales_by_seller_totals`.

Devuelve el TOTAL de las ventas de los vendedores en un único objeto de resumen agregado, con `beforeTaxes`, `total`, `totalWithoutCreditNotes`, `creditNote`, `totalPayed`, `totalDocuments` y `totalSales`.

Úsala cuando el usuario pregunte por cuánto vendieron los vendedores en total en un periodo, sin necesitar cada vendedor ni cada documento. Para la lista de ventas por vendedor o el detalle documento por documento usa `reports_get_sales_by_seller` en su lugar.

Ejemplo de llamada JSON-RPC:

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

Solo lectura.

## Request body

- object
  - `from` string, required: Fecha inicial para el cálculo de los totales, en formato YYYY-MM-DD.
  - `to` string, required: Fecha final para el cálculo de los totales, en formato YYYY-MM-DD.
  - `sellerName` string: Filtra por nombre del vendedor. Si se envía, devuelve los totales solo de ese vendedor; si se omite, los totales de todos los vendedores. Solo aplica cuando no se envía `sellerId`.
  - `customerId` string: Filtra los documentos de venta por ID de cliente. Úsalo cuando el usuario pida los totales de las ventas asociadas a un cliente específico.
  - `sellerId` string: Filtra por ID de vendedor. Úsalo cuando el usuario pida los totales de un vendedor específico.
  - `warehouseId` string: Filtra por ID de bodega o punto de despacho. Acepta varios IDs separados por comas.
  - `number` string: Filtra por número de documento (coincidencia parcial). Úsalo cuando el usuario pida una factura o nota crédito concreta.

## Response `200`

Resumen agregado de las ventas de los vendedores

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)