---
title: "Listar ajustes de inventario"
method: POST
path: "/tools/inventoryAdjustments_getInventoryAdjustments"
tags: ["Items"]
---

# Listar ajustes de inventario

`POST /tools/inventoryAdjustments_getInventoryAdjustments`

## Request

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

Herramienta MCP: `inventoryAdjustments_getInventoryAdjustments`.

Devuelve la lista de ajustes de inventario, con filtros opcionales por fecha, bodega, número y observaciones.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "inventoryAdjustments_getInventoryAdjustments",
    "arguments": { "start": 0, "limit": 30 }
  }
}
```

Úsala para listar ajustes, buscar uno por número o fecha, o verificar con `fields` (`editable`, `deletable`, `totalCostOnlyAdjustment`) el estado de gestión de un ajuste. Si ya conoces el ID, prefiere `inventoryAdjustments_getInventoryAdjustment`: es más rápida y devuelve datos más completos.

`order_field` ordena por `date` (por defecto), `number` o `id`; `order_direction` acepta `ASC` o `DESC` (por defecto `DESC`). Envíalos solo cuando el usuario pide explícitamente un orden. `number` filtra por número de ajuste, `date` por fecha en formato `YYYY-MM-DD`, `warehouse_id` por ID de bodega y `observations` por texto de las observaciones.

`mode` acepta `simple` y devuelve una versión ligera de cada ajuste, útil para listados cuando no se necesita el detalle completo.

`fields` admite valores separados por comas: `editable`, `deletable`, `totalCostOnlyAdjustment`.

Paginación con `start` (desplazamiento desde 0) y `limit` (cantidad de resultados por página; no la superes por encima de 30, que es el máximo permitido). Con `metadata: true` la respuesta se envuelve como `{ data: [...], metadata: { total, hasMore } }`.

Solo lectura.

## Request body

- object
  - `metadata` boolean: Si es true, la respuesta se envuelve como { data: [...], metadata: { total, hasMore } }.
  - `limit` integer: Cantidad de resultados por página. No la superes por encima de 30: es el máximo permitido.
  - `start` integer: Desplazamiento de paginación (desde 0).
  - `order_field` 'date' | 'number' | 'id': Campo por el que ordenar. Por defecto `date`.
  - `order_direction` 'ASC' | 'DESC': Dirección del orden. Por defecto `DESC`.
  - `number` string: Filtra por número del ajuste.
  - `date` string: Filtra por fecha en formato `YYYY-MM-DD`.
  - `warehouse_id` union: Filtra por ID de bodega.
    - string
    - number
  - `observations` string: Filtra por texto de las observaciones.
  - `mode` 'simple': Devuelve campos mínimos cuando se envía como `simple`, útil para listados ligeros.
  - `fields` string: Campos extra separados por comas (por ejemplo `editable,deletable,totalCostOnlyAdjustment`).

## Response `200`

Lista de ajustes de inventario

## 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)