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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

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

string
required

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

string
Defaults to 0

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

string
Defaults to 10

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

optionalParams
object

Filtros y ordenamiento opcionales. CRÍTICO: este parámetro debe ser un objeto JSON, NUNCA una cadena de texto. Envíalo como objeto: {"itemName": "Nombre del producto"}.

Responses

401

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

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json