¿Qué es el error 'Requested quantities exceed availability' en Magento?
El error 'Requested quantities exceed availability' en Magento (Adobe Commerce) es uno de los problemas más frustrantes para los administradores de tiendas online y sus clientes. Este mensaje aparece en el carrito de compras o durante el proceso de pago (checkout), impidiendo que la transacción se complete con éxito. Ocurre fundamentalmente cuando la cantidad de productos que un cliente intenta comprar supera el stock disponible registrado en el inventario del sistema.
Aunque a simple vista parece un problema básico de inventario, en muchas ocasiones se trata de un fallo de sincronización en las fuentes de stock (Multi-Source Inventory - MSI), problemas con la indexación o discrepancias causadas por pedidos cancelados previamente que no liberaron las cantidades correctamente.
Causas principales de este error en Adobe Commerce
Para solucionar el problema de raíz, es importante comprender qué lo provoca. Las causas más comunes incluyen:
- Desincronización entre el stock total y las fuentes asignadas en el módulo MSI.
- Índices de inventario bloqueados o desactualizados en la base de datos.
- Problemas de caché en Redis o Varnish que muestran información de stock obsoleta al usuario.
- Pedidos anteriores cancelados o fallidos que no devolvieron los artículos al inventario.
Método 1: Reindexar el inventario desde la línea de comandos
La causa más frecuente de este error es que las tablas de índices de Magento no reflejan la cantidad real de productos disponibles. La forma más rápida y efectiva de solucionarlo es forzar la reindexación mediante la terminal SSH.
- Accede a tu servidor mediante SSH utilizando tus credenciales de acceso.
- Navega hasta el directorio raíz de tu instalación de Magento (por ejemplo,
cd /var/www/html/tu-tienda-magento). - Ejecuta el siguiente comando para actualizar específicamente los índices de stock y catálogo:
php bin/magento indexer:reindex cataloginventory_stock catalog_product_index - Limpiar la caché del sistema para asegurarte de que los cambios surtan efecto inmediatamente con:
php bin/magento cache:clean
Método 2: Verificar la configuración de fuentes de inventario (MSI)
Si utilizas el sistema de inventario multi-fuente de Magento, es posible que el producto tenga stock global pero no esté asignado correctamente a la página web o canal de venta activo.
- Inicia sesión en el panel de administración (Backoffice) de tu Magento.
- Dirígete al menú lateral y haz clic en Catalog (Catálogo) > Products (Productos).
- Busca y edita el producto que está generando el error.
- Desplázate hasta la sección Assign Sources (Asignar fuentes) y verifica que el stock sea mayor a cero en la fuente física o almacén correspondiente.
- Asegúrate de que la cantidad en el campo Quantity sea correcta y guarda los cambios realizados.
Método 3: Limpiar y reiniciar las colas de mensajes (Consumer Queue)
A veces, las reservas de stock se quedan atascadas en las colas de procesamiento asíncrono, lo que impide que el inventario se libere o se actualice correctamente tras una compra o cancelación.
- Accede a la terminal SSH de tu servidor Magento.
- Verifica el estado de las colas ejecutando:
php bin/magento queue:consumers:list - Reinicia los consumidores de inventario o procesa las reservas pendientes utilizando el comando correspondiente a tu configuración de cron o colas.
- Como medida preventiva, limpia la caché de reservas ejecutando consultas SQL directas solo si tienes experiencia, o simplemente limpia la caché general de la aplicación con
php bin/magento cache:flush.
