ALalegra
Reports

Listar ventas por vendedor

Herramienta MCP: reports_get_sales_by_seller.

Devuelve las ventas por vendedor con dos vistas según el uso de sellerId:

  • Sin sellerId: vista RESUMEN paginada, con una fila por vendedor y sus métricas agregadas.
  • Con sellerId: vista DETALLE, con una fila por documento de ese vendedor.

Úsala cuando el usuario pregunte por las ventas de los vendedores o de un vendedor específico: cuánto vendió cada uno, cuántos documentos emitió o qué documentos tiene asignados. Para los totales agregados, del tipo "¿cuánto vendieron los vendedores en total?", usa reports_get_sales_by_seller_totals en su lugar. Para preguntas del tipo "qué vendedores" o "qué documentos", usa esta herramienta.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_sales_by_seller",
    "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. Los filtros sellerName, customerId, sellerId, warehouseId y number son parámetros de primer nivel, y el ordenamiento usa order_field junto con order_direction.

Solo lectura.

post/tools/reports_get_sales_by_seller

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/reports_get_sales_by_seller
  • Auth
    HTTP bearer

Request body

fromstring required

Fecha inicial para filtrar las ventas, en formato YYYY-MM-DD.

tostring required

Fecha final para filtrar las ventas, en formato YYYY-MM-DD.

startstring

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

limitstring

Límite de registros a devolver. Por defecto "10". Envíalo como texto, no como número.

sellerNamestring

Filtra por nombre del vendedor. Úsalo cuando el usuario pida las ventas de un vendedor concreto; extrae el nombre de la consulta. Si se omite, devuelve las ventas de todos los vendedores. Solo aplica cuando no se envía sellerId.

customerIdstring

Filtra los documentos de venta por ID de cliente. Úsalo cuando el usuario pida las ventas de los vendedores asociadas a un cliente específico.

sellerIdstring

Filtra por ID de vendedor. Cuando se envía, cambia la respuesta a la vista DETALLE (una fila por documento de ese vendedor) en lugar del resumen (una fila por vendedor).

warehouseIdstring

Filtra por ID de bodega o punto de despacho. Acepta varios IDs separados por comas.

numberstring

Filtra por número de documento (coincidencia parcial). Úsalo cuando el usuario pida una factura o nota crédito concreta.

order_direction'ASC' | 'DESC'

Dirección del ordenamiento: ASC ascendente (menor primero), DESC descendente (mayor primero). Debe usarse junto con order_field.

order_field'totalDocuments' | 'totalPayed' | 'beforeTaxes' | 'total'

Campo de ordenamiento: totalDocuments (número de documentos), totalPayed (total pagado), beforeTaxes (base gravable) o total (monto con impuestos). Debe usarse junto con order_direction.

Response

Lista paginada de ventas por vendedor (resumen) o por documento (detalle)

Changes

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