Errores

`insufficient_stock`

HTTP HTTP 409.

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

{
  "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
    }
  ]
}

Cuándo ocurre

409. POST /api/v1/orders/{orderId}/reserve 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

Corregir y reenviar409 contact_in_use · address_in_use · insufficient_stock
No reintentes. errors[] dice qué bloquea la operación: corrígelo primero.

Campos de errors[]

errors[].pathstring

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

Opciones disponibles: items, spaces

errors[].itemIdstring

En insufficient_stock: el artículo, o el espacio cuando path es spaces, que está corto.

errors[].requestednumber

En insufficient_stock: unidades que necesita el pedido.

errors[].availablenumber

En insufficient_stock: unidades disponibles para las fechas del pedido.

errors[].shortfallnumber

En insufficient_stock: unidades que faltan (requested − available).

Lo devuelven

1 operaciones

POST /api/v1/orders/{orderId}/reserve — 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`.

¿Te ha resultado útil esta página?

Ejemplo