*API REST › Errores*

# `insufficient_stock`

> HTTP HTTP 409.

Estado HTTP: `409` · Tipo del problema: `https://docs.filmo.io/errors/insufficient_stock`

## Cuándo ocurre

409. [`POST /api/v1/orders/{orderId}/reserve`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/reserve-an-order) rechazado porque no hay stock suficiente para las fechas del pedido. `errors` tiene una entrada por cada artículo o espacio con faltante, con `itemId`, `requested`, `available` y `shortfall`; `path` es `items` o `spaces`.

## Qué hacer

Usa las entradas de `errors[]` para reducir las cantidades, cambiar las fechas o liberar stock en otro sitio, y vuelve a reservar. Comprueba la disponibilidad antes de reservar para evitar el viaje de ida y vuelta.

## Reintento

| Condición | Qué hacer | Nota |
| --- | --- | --- |
| 409 contact_in_use · address_in_use · insufficient_stock | Corregir y reenviar | No reintentes. `errors[]` dice qué bloquea la operación: corrígelo primero. |

## Campos de errors[]

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `errors[].path` | string | Ruta del campo erróneo en notación de puntos y corchetes (`lines[0].itemId`); vacía si afecta a todo el cuerpo. En `contact_in_use`, `address_in_use` e `insufficient_stock` es uno de un conjunto cerrado, listado por código en `x-path-values`: el tipo de registro que usa el contacto o la dirección, o la clase de recurso que escasea (`items` o `spaces`). `items`, `spaces` |
| `errors[].itemId` | string | En `insufficient_stock`: el artículo, o el espacio cuando `path` es `spaces`, que está corto. |
| `errors[].requested` | number | En `insufficient_stock`: unidades que necesita el pedido. |
| `errors[].available` | number | En `insufficient_stock`: unidades disponibles para las fechas del pedido. |
| `errors[].shortfall` | number | En `insufficient_stock`: unidades que faltan (`requested` − `available`). |

## Ejemplo

*insufficient_stock*

```json
{
  "type": "https://docs.filmo.io/errors/insufficient_stock",
  "title": "Insufficient stock",
  "status": 409,
  "code": "insufficient_stock",
  "detail": "1 item does not have enough stock for the dates of the order; nothing was reserved. The detail is in errors",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "errors": [
    {
      "path": "items",
      "code": "insufficient_stock",
      "message": "Short by 2 of 5 units for the dates of the order",
      "itemId": "itm_9f3a2b",
      "requested": 5,
      "available": 3,
      "shortfall": 2
    }
  ]
}
```

## Lo devuelven

- [`POST /api/v1/orders/{orderId}/reserve`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/reserve-an-order) — Reservar un pedido

## Por MCP

Una llamada a una herramienta que falla vuelve con `isError` y el problema como contenido estructurado, con el mismo `code`.

---

URL canónica: https://docs.filmo.io/es/rest-api/errors/insufficient_stock  
Última actualización: 2026-10-25