*MCP › Referencia › Catálogo e inventario › Disponibilidad*

# Comprobar la disponibilidad de artículos

> Comprueba la disponibilidad de un lote de artículos (1-100) en un rango de fechas común, cada uno con la cantidad que piensas reservar (1 por defecto).

Consulta idempotente (POST por el cuerpo estructurado). Comparte la cuota de disponibilidad de 30 req/min. Una entrada por artículo solicitado, en el orden de la petición: su disponibilidad (`available`, `shortfall`, `conflictingPeriods` para esa cantidad, y `commitments`: los pedidos que retienen unidades de él en la ventana, con su número, cantidad máxima y fechas) o un `error` por elemento cuando el artículo no existe en la cuenta.

HERRAMIENTA `filmo_availability_check` · `availability:read` · 120/min · + 30/min de disponibilidad · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente

## Argumentos

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `items` | object[] | Sí | Lote de artículos que comprobar (entre 1 y 100). |
| `items.itemId` | string | Sí | Identificador del artículo que se comprueba. Obligatorio. |
| `items.variantId` | string | No | Identificador de la variante concreta que se comprueba; omítelo para el artículo base. |
| `items.transactionType` | string | No | Tipo de transacción que comprobar: rental o sale. Por defecto, rental. `rental`, `sale` |
| `items.quantity` | integer | No | Unidades que piensas reservar. Determina `available`, `shortfall`, `status` y `conflictingPeriods`. Por defecto es 1. |
| `startDate` | string<date-time> | Sí | Inicio del rango a comprobar (ISO 8601 con desplazamiento), compartido por todo el lote. |
| `endDate` | string<date-time> | Sí | Fin del rango a comprobar (ISO 8601 con desplazamiento), compartido por todo el lote; debe ser posterior a startDate. |

## Resultado

En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`.

*Llamada · filmo_availability_check*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_availability_check",
    "arguments": {
      "items": [
        {
          "itemId": "item_8f2a1c",
          "variantId": "vari_8f2a1c",
          "transactionType": "rental",
          "quantity": 1
        }
      ],
      "startDate": "2026-09-01T08:00:00Z",
      "endDate": "2026-09-01T08:00:00Z"
    }
  }
}
```

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": [
      {
        "itemId": "item_8f2a1c",
        "variantId": "vari_8f2a1c",
        "itemName": "Example",
        "quantity": 1,
        "available": true,
        "status": "ok",
        "totalStock": 1,
        "reserved": 1,
        "minRemaining": 1,
        "shortfall": 1,
        "temporaryAvailable": 1,
        "conflictingPeriods": [
          "<conflictingPeriods>"
        ],
        "commitments": [
          {
            "orderId": "orde_8f2a1c",
            "orderNumber": "<orderNumber>",
            "quantity": 1,
            "startDate": "2026-09-01T08:00:00Z",
            "endDate": "2026-09-01T08:00:00Z"
          }
        ],
        "checkedAt": "2026-09-01T08:00:00Z"
      }
    ],
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}
```

## Prompts de ejemplo

*Prompt*

```text
¿Hay dos unidades de esta óptica libres del 15 al 17 de enero?
```

## La misma operación por REST

Esta herramienta ejecuta [`POST /api/v1/availability/check`](https://docs.filmo.io/es/rest-api/endpoint-reference/availability/check-item-availability).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/availability/filmo-availability-check  
Última actualización: 2026-10-25