---
title: "itemStock__get_item_stock_summary"
method: POST
path: "/tools/itemStock__get_item_stock_summary"
tags: ["Items"]
---

# itemStock__get_item_stock_summary

`POST /tools/itemStock__get_item_stock_summary`

Obtiene un resumen del stock de múltiples ítems filtrado por condición de stock. Requiere stockCondition para determinar qué ítems incluir en el resultado. Condiciones disponibles: NEGATIVE_STOCK (stock negativo), ZERO_STOCK (stock en cero), LOW_STOCK (stock por debajo de un umbral — usar con stockThreshold), CURRENT_STOCK (ítems con stock disponible). SIEMPRE usar otras herramientas para resolver nombres de ítems a partir de sus IDs. SIEMPRE mostrar el nombre de la bodega — NUNCA mostrar el ID de la bodega al usuario.

## Request body

- object
  - `stockCondition` 'NEGATIVE_STOCK' | 'ZERO_STOCK' | 'LOW_STOCK' | 'CURRENT_STOCK', required — Condición para filtrar el resumen de stock. NEGATIVE_STOCK: ítems con stock negativo. ZERO_STOCK: ítems con stock en cero. LOW_STOCK: ítems con stock por debajo del umbral (usar con stockThreshold). CURRENT_STOCK: ítems con stock disponible actual.
  - `stockThreshold` number — Umbral de stock exclusivo para la condición LOW_STOCK. Solo usar cuando stockCondition es LOW_STOCK y el usuario menciona un límite, e.g. «ítems con stock menor a 10».
  - `limit` integer — Cantidad máxima de registros a retornar. Por defecto 30, máximo 100.
  - `start` integer — Índice del primer registro a retornar (base cero). Para paginación.

## Response `200`

Resumen de stock de ítems filtrado por condición.

## Other responses

- `401` — No autorizado

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/versions/cd52d3f68f1b/schema)