Reports

Consultar ventas por producto

Herramienta MCP: reports_get_sales_by_item.

Devuelve una LISTA de productos con sus datos de venta en un periodo: cantidad vendida, monto antes de impuestos y monto con impuestos. Es una muestra limitada de hasta 10 productos. Se puede filtrar por nombre o referencia de un producto concreto para ver sus ventas.

Úsala cuando el usuario pregunte qué productos se vendieron en un periodo o las ventas de un producto específico. Para los totales agregados, del tipo "¿cuánto se vendió de cada cosa en total?" o "¿cuál fue el monto total de ventas de productos?", usa reports_get_sales_by_item_totals en su lugar. Para preguntas del tipo "qué productos" o "cuántas unidades", usa esta herramienta.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_sales_by_item",
    "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 y el ordenamiento van dentro de optionalParams, que debe enviarse como objeto JSON, nunca como cadena de texto.

Solo lectura.

post/tools/reports_get_sales_by_item

Request

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

Máximo de registros a devolver, máximo 10. Por defecto "10". Envíalo como texto, no como número.

Response

Lista limitada de productos con sus datos de venta

Changes

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