v1

latestOpenAPI 3.0.32026-07-24398641.3 MB

Items

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.

post/tools/itemStock__get_item_stock_summary

Request body

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.

stockThresholdnumber

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».

limitinteger

Cantidad máxima de registros a retornar. Por defecto 30, máximo 100.

startinteger

Índice del primer registro a retornar (base cero). Para paginación.

Example request

{
  "stockCondition": "ZERO_STOCK",
  "stockThreshold": 10,
  "limit": 30
}

Response

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