---
title: "Resumir stock por condición"
method: POST
path: "/tools/itemsStock_get_item_stock_summary"
tags: ["Items"]
---

# Resumir stock por condición

`POST /tools/itemsStock_get_item_stock_summary`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/itemsStock_get_item_stock_summary`
- Auth: HTTP bearer

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:

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

## Request body

- object
  - `stockCondition` 'NEGATIVE_STOCK' | 'ZERO_STOCK' | 'LOW_STOCK' | 'CURRENT_STOCK', required: Condición para filtrar el resumen de stock.
  - `stockThreshold` number: 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").
  - `limit` integer: Cantidad máxima de registros a devolver (entre 1 y 30).
  - `start` integer: Índice del primer registro devuelto (desde 0).

## Response `200`

Resumen de stock por condición

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)