Totalizar ventas por vendedor

post

https://mcp.alegra.com/tools/reports_get_sales_by_seller_totals

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:

{
  "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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

from

string

required

Fecha inicial para el cálculo de los totales, en formato YYYY-MM-DD.

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.

Responses

401

No autorizado (token de Alegra inválido o expirado).

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Resumen agregado de las ventas de los vendedores