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

Herramienta
filmo_availability_check
Acceso: Lectura

Resultado

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

generado desde el esquema

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.

Argumentos

itemsobject[]Obligatorio

Lote de artículos que comprobar (entre 1 y 100).

Límites: mín. 1 elementos, máx. 100 elementos

Mostrar atributos hijos
items.itemIdstringObligatorio

Identificador del artículo que se comprueba. Obligatorio.

Límites: longitud mín. 1, longitud máx. 100

items.variantIdstring

Identificador de la variante concreta que se comprueba; omítelo para el artículo base.

Límites: longitud mín. 1, longitud máx. 100

items.transactionTypestring

Tipo de transacción que comprobar: rental o sale. Por defecto, rental.

Opciones disponibles: rental, sale

items.quantityinteger

Unidades que piensas reservar. Determina available, shortfall, status y conflictingPeriods. Por defecto es 1.

Límites: mín. 1, máx. 100000

startDatestring<date-time>Obligatorio

Inicio del rango a comprobar (ISO 8601 con desplazamiento), compartido por todo el lote.

endDatestring<date-time>Obligatorio

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.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

Prompts de ejemplo

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

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

  • Guías

    Escrituras seguras

    Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.

  • Guías

    Errores

    Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.