Resumir stock por condición

Herramienta MCP: itemsStock_get_item_stock_summary.

Devuelve el stock de varios ítems según una condición de existencias (stock negativo, en cero, bajo o actual).

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "itemsStock_get_item_stock_summary",
    "arguments": { "stockCondition": "LOW_STOCK", "stockThreshold": 10 }
  }
}

Úsala para preguntas de stock sobre varios ítems ("¿qué productos tienen stock negativo?", "¿cuáles están en cero?"). Para el stock de un solo ítem, usa itemsStock_get_item_stock.

stockCondition es obligatorio. stockThreshold aplica solo con la condición LOW_STOCK y se usa cuando el usuario menciona un umbral (por ejemplo, "stock bajo menor de 10").

Paginación con start (desplazamiento desde 0) y limit (máximo 30 registros, por defecto 30). Ten en cuenta que metadata.total refleja el conteo sin filtrar y puede ser mayor que los resultados devueltos; las entradas sin nombre de ítem (ítems eliminados o categorías contables) se excluyen automáticamente. Si una página viene vacía pero metadata.total es mayor que cero, continúa con la siguiente página incrementando start en limit; no intentes recorrer todas las páginas: consulta como máximo dos y comunica al usuario que puede haber más resultados.

En la respuesta se muestra siempre el nombre de la bodega (nunca su ID); usa las demás herramientas para resolver nombres a partir de IDs de ítems.

Solo lectura.

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

Condición para filtrar el resumen de stock.

Allowed:
number
≥ 0

Umbral de stock, excluyente para la condición LOW_STOCK. Úsalo solo cuando stockCondition es LOW_STOCK y el usuario menciona un umbral (por ejemplo, "stock de ítems con stock bajo menor de 10").

integer
1 to 30
Defaults to 30

Cantidad máxima de registros a devolver (entre 1 y 30).

integer
≥ 0

Índice del primer registro devuelto (desde 0).

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