WooCommerce 11.0 restaura stock en órdenes fallidas

En pocas palabras: Sí. Desde WooCommerce 11.0, anunciado el 17 de julio de 2026, una orden que pasa al estado Failed y ya había descontado stock lo restaura automáticamente al inventario. Antes esto solo ocurría con órdenes canceladas; ahora WooCommerce engancha wc_maybe_increase_stock_levels() a woocommerce_order_status_failed.

WooCommerce 11.0 cambia cómo se maneja el inventario en órdenes fallidas: si una orden ya había descontado stock y después pasa al estado Failed, ahora WooCommerce restaura ese stock de forma automática. El cambio se hizo enganchando la función wc_maybe_increase_stock_levels() a la acción woocommerce_order_status_failed, según el anuncio oficial de WooCommerce del 17 de julio de 2026.

La restauración de stock en WooCommerce 11.0 es un comportamiento nuevo que devuelve al inventario las unidades de una orden que se marcó como Failed (fallida) después de haber reducido stock. Antes solo pasaba con órdenes canceladas. Es una función del core de WooCommerce, el plugin de comercio electrónico de Automattic, y aplica a cualquier tienda que actualice a la versión 11.0.

WooCommerce es un plugin de WordPress para e-commerce desarrollado por Automattic que permite crear tiendas en línea y gestionar productos, pagos e inventario. Es una solución de código abierto ampliamente utilizada en sitios de comercio electrónico.

¿Por qué antes el stock quedaba bloqueado en órdenes fallidas?

Porque hasta WooCommerce 10.x el core solo devolvía las unidades al inventario cuando una orden pasaba al estado Cancelled, nunca cuando terminaba en Failed. Resultado: una orden podía descontar stock, quedar en Failed y mantener ese stock reducido de forma indefinida. Nadie lo devolvía salvo que vos entraras a mano.

El caso típico son los métodos de pago asíncronos. Ponele que un cliente arranca una transferencia o un pago que la pasarela acepta «para procesar»: la orden pasa a Processing, descuenta las unidades y espera la confirmación. Si después el pago se rechaza, la orden termina en Failed. Con el comportamiento viejo, esas unidades seguían figurando como vendidas aunque no cobraste nada.

¿El efecto práctico? Sobre todo en tiendas con stock ajustado, terminabas mostrando «agotado» un producto que en realidad tenías. Perdías ventas por un fantasma en el inventario. Lo explicamos a fondo en mejorar la experiencia de compra.

¿Qué es una orden con estado «Failed» en WooCommerce?

Una orden Failed es una orden cuyo pago no se completó: la pasarela lo rechazó, hubo un error de procesamiento o la transacción quedó trunca. Es distinta de Cancelled (que suele cancelar el cliente o el admin) y de Processing (pago aceptado, pendiente de preparar). En términos de inventario, es el estado que más problemas daba antes de la 11.0.

• Failed (fallida): el intento de cobro no prosperó. Puede venir de una tarjeta rechazada o de un pago asíncrono que después se cae.
• Cancelled (cancelada): alguien la dio de baja a propósito. Acá el stock ya se restauraba desde antes.
• Processing (procesando): el pago entró y la orden está lista para preparar. Este estado sí descuenta stock.

El detalle fino: no toda orden fallida descontó stock antes. Y eso, como vas a ver, es justo lo que mira la función que hace la restauración.

¿Cómo funciona la restauración automática del stock en WooCommerce 11.0?

Funciona con una sola línea: WooCommerce 11.0 engancha la función wc_maybe_increase_stock_levels() a la acción woocommerce_order_status_failed. Cuando una orden entra en Failed, se dispara esa acción, la función revisa si la orden había reducido stock y, si es así, lo devuelve al inventario. Todo automático, sin que toques nada.

add_action( 'woocommerce_order_status_failed', 'wc_maybe_increase_stock_levels' );

La clave está en el «maybe» del nombre. La función no devuelve unidades a lo loco: primero chequea si esa orden en particular había descontado stock. Si nunca lo hizo, no cambia nada. Este guard es lo que evita que el inventario se infle por órdenes que jamás tocaron el stock. Cubrimos ese tema en detalle en usar plugins consolidados y ligeros.

En criollo: subís a la 11.0, una orden con pago asíncrono descuenta dos remeras, el pago se cae más tarde, la orden pasa a Failed y esas dos remeras vuelven solas al stock disponible, sin que un empleado tenga que acordarse de revisar la lista de órdenes rechazadas a fin de día.

¿En qué casos impacta más este cambio de inventario?

Impacta sobre todo en tiendas con métodos de pago asíncronos, donde el cobro se confirma después de crear la orden. Ahí es donde el stock quedaba trabado con más frecuencia. Si tu checkout depende de estos flujos, la 11.0 te saca un dolor de cabeza recurrente.

• Transferencias y pagos diferidos: la orden se crea y descuenta stock antes de que el dinero esté confirmado. Si el pago no llega, ahora el stock vuelve solo.
• Billeteras y pagos en revisión: cualquier pasarela que acepte «para procesar» y después pueda rechazar entra en este escenario.
• Tiendas con stock chico: si vendés unidades limitadas, un solo producto trabado te podía costar una venta. Acá el beneficio se nota rápido.

Para el ecommerce argentino esto suma, porque buena parte de las ventas locales pasa por medios que no confirman al instante. Y si estás moviendo tu tienda a un hosting WordPress como el de Donweb, actualizar a la 11.0 en el mismo movimiento te deja el manejo de inventario ya resuelto por defecto.

¿Qué pasa si mi tienda usa el estado «Failed» en extensiones personalizadas?

Si tenés extensiones o código propio que usa Failed para flujos que no son de pago, revisá tu lógica antes de actualizar. WooCommerce lo dice claro: la mayoría no necesita hacer nada, pero las tiendas que reutilizan ese estado para otra cosa deben chequear cómo manejan las órdenes y qué esperan del inventario.

Pensá en un caso raro: usás Failed como marca interna para órdenes que quedaron en espera de una validación manual, no porque falló un cobro. Con la 11.0, si esas órdenes habían descontado stock, ahora ese stock se restaura al pasar a Failed. Puede que no sea lo que querías. Esto se conecta con lo que analizamos en enriquecer tu catálogo con IA.

El tema es que el hook nuevo corre siempre que una orden entra en Failed. Si tu extensión hookeaba ese mismo estado con otra intención, ahora convive con la restauración del core. Probalo en staging y mirá el orden de ejecución de tus add_action. Un test rápido te ahorra una sorpresa en producción.

¿Cuáles son los requisitos para que la restauración de stock funcione?

La condición es una sola: la orden tiene que haber reducido stock antes de pasar a Failed. La función wc_maybe_increase_stock_levels() verifica ese dato en la orden y solo devuelve unidades si el descuento ocurrió. Órdenes que nunca tocaron el inventario no cambian nada al fallar.

• Orden que descontó stock y pasa a Failed: restaura el stock. Este es el escenario que el cambio vino a resolver.
• Orden que nunca descontó stock y pasa a Failed: no cambia. El guard interno la deja intacta.
• Gestión de inventario activa: el mecanismo aplica a productos con control de stock. Si no manejás inventario en un producto, no hay nada que restaurar.

Comparativa: manejo de stock antes y después de WooCommerce 11.0

Situación	WooCommerce 10.x y anteriores	WooCommerce 11.0
Orden pasa a Cancelled con stock descontado	Restaura stock	Restaura stock
Orden pasa a Failed con stock descontado	No restaura (queda bloqueado)	Restaura de forma automática
Orden pasa a Failed sin haber descontado stock	No cambia	No cambia
Pago asíncrono rechazado tras Processing	Stock reducido indefinidamente	Stock devuelto al inventario
Intervención manual requerida	Sí, a mano por cada orden fallida	No, corre solo

¿Conviene actualizar a WooCommerce 11.0 por esta mejora?

Para la mayoría de las tiendas, sí, y sin trámite: la función corre automática y no pide configuración. El propio anuncio aclara que «para la mayoría de las tiendas y extensiones, no se requiere ninguna acción». Si vendés con pagos asíncronos, el beneficio es directo. Si usás el estado Failed de forma custom, primero probá en staging.

• Hacé backup: antes de cualquier actualización de WooCommerce, respaldá base de datos y archivos.
• Probá en staging: replicá tu tienda, actualizá ahí y generá una orden de prueba que falle para ver la restauración en vivo.
• Revisá extensiones de stock: si tenés plugins de inventario o hooks propios sobre Failed, confirmá que conviven bien con el comportamiento nuevo.

Qué está confirmado y qué queda por ver

• Confirmado: WooCommerce 11.0 restaura stock en órdenes que pasan a Failed y habían descontado inventario, vía wc_maybe_increase_stock_levels() sobre la acción woocommerce_order_status_failed.
• Confirmado: el cambio solo afecta órdenes que reducieron stock; las que nunca lo hicieron quedan igual.
• Confirmado: la mayoría de tiendas no necesita hacer nada tras actualizar.
• Por ver: cómo reacciona cada extensión de terceros que hookea el estado Failed. El core recomienda revisar, no publica una lista de plugins afectados.
• Por ver: comportamientos borde en flujos donde Failed se usa fuera del contexto de pago. Ahí la recomendación es testear caso por caso.

Errores comunes al actualizar a WooCommerce 11.0

• Actualizar directo en producción: subir la 11.0 sin pasar por staging. Si tenés lógica custom sobre Failed, el orden de tus hooks puede cambiar. Corré una orden de prueba antes.
• Asumir que arregla el stock viejo: el cambio actúa de acá en adelante, sobre órdenes que pasan a Failed después de actualizar. El inventario que ya quedó trabado en órdenes fallidas viejas hay que ajustarlo a mano.
• Ignorar las extensiones de inventario: dar por hecho que todos tus plugins de stock siguen igual. Si alguno hookeaba Failed con otra intención, ahora convive con la restauración del core y puede duplicar o pisar acciones.
• No hacer backup: el clásico. Una actualización de WooCommerce toca la capa de comercio de tu sitio; sin respaldo, cualquier sorpresa se vuelve un problema serio.

Preguntas Frecuentes

¿Qué cambió en WooCommerce 11.0 con la gestión de stock?

WooCommerce 11.0 restaura automáticamente el stock de una orden cuando pasa al estado Failed, siempre que esa orden haya descontado inventario antes. Hasta la versión 10.x, el stock solo se devolvía en órdenes canceladas, así que las fallidas mantenían el inventario reducido de forma indefinida. Para más detalles técnicos, mirá actualizar WooCommerce a versión 11.0.

¿Cómo funciona la restauración automática de stock en órdenes fallidas?

Funciona con un add_action que engancha la función wc_maybe_increase_stock_levels() a la acción woocommerce_order_status_failed. Cuando una orden entra en Failed, esa función chequea si había reducido stock y, en caso afirmativo, devuelve las unidades al inventario sin intervención manual.

¿Necesito hacer algo en mi tienda si paso a WooCommerce 11.0?

Para la mayoría de las tiendas, no: el comportamiento es automático y no pide configuración. La excepción son las tiendas o extensiones que usan el estado Failed para flujos que no son de pago, que deberían revisar su lógica de órdenes e inventario antes de actualizar.

¿Por qué mi stock seguía reducido en órdenes fallidas antes de la 11.0?

Porque WooCommerce 10.x y versiones anteriores solo restauraban stock en el estado Cancelled, no en Failed. Una orden podía descontar stock, terminar fallida por un pago rechazado y mantener esas unidades como vendidas sin límite de tiempo, salvo que las devolvieras a mano.

¿La restauración aplica a órdenes que nunca descontaron stock?

No. La función wc_maybe_increase_stock_levels() verifica si la orden había reducido stock antes de tocar el inventario. Una orden que nunca descontó unidades y luego pasa a Failed no cambia: el guard interno evita inflar el stock por error.

Conclusión

WooCommerce 11.0 cierra un agujero viejo del manejo de inventario: ahora una orden que falla y había descontado stock devuelve esas unidades sola, sin que tengas que revisar la lista de fallidas a fin de día. Para las tiendas con pagos asíncronos, que en Argentina son moneda corriente, es un arreglo que se siente rápido.

Qué hacer: si tu tienda usa el estado Failed solo para pagos, actualizá con un backup y listo, el core hace el resto. Si lo reutilizás para flujos custom, montá un staging, generá una orden que falle y verificá que la restauración no pise tu lógica. Cinco minutos de prueba antes de subir a producción te evitan el susto.

Fuentes

• Developer Blog de WooCommerce – anuncio oficial del cambio de stock en órdenes fallidas (17/07/2026)
• Developer Blog de WooCommerce – documentación y novedades para desarrolladores
• WooCommerce – sitio oficial del plugin de comercio electrónico