msi-core: el MSI que Magento dejó a medias
En MSI las reservas pertenecen al stock, no al source, y dos stocks que comparten almacén venden la misma unidad dos veces. Qué falla, por qué nunca se terminó y cómo lo resuelve msi-core.
En varias tiendas Magento con las que trabajo se repetía el mismo patrón: el stock nunca cuadraba. A veces se vendía lo que no había. Otras veces había unidades en el almacén que la tienda no dejaba vender, retenidas por reservas que ya no correspondían a ningún pedido. Se corregía a mano y volvía a pasar.
Después de varias rondas dejé de tratarlo como un problema de cada tienda. El problema estaba en Multi-Source Inventory (MSI), el sistema de inventario que Magento trae desde la versión 2.3. Y la conclusión no fue reemplazarlo: MSI es una buena idea que quedó a medias. Así nació msi-core, un fork que continúa donde MSI se detuvo, con enfoques nuevos.
La idea de MSI es buena
Antes de MSI, Magento guardaba una cantidad por producto en cataloginventory_stock_item y la descontaba al hacer el pedido. MSI separa dos conceptos que ese modelo mezclaba: el source, un lugar físico donde hay mercancía, como un almacén o una tienda, y el stock, la vista de venta que un canal tiene sobre uno o varios sources.
Además, MSI no descuenta stock al hacer el pedido. Escribe una reserva, una fila con cantidad negativa en inventory_reservation, y la cantidad vendible es lo físico menos lo reservado. Cuando el pedido se envía, se descuenta el source y una compensación anula la reserva. Agregar filas en lugar de pisar un contador deja registrado cada movimiento y separa lo comprometido de lo que hay en el almacén.
Es un buen diseño. El problema está en dos decisiones que quedaron a mitad de camino.
Las reservas viven en el stock
Una reserva de MSI guarda el SKU, la cantidad y el stock. No guarda de qué source va a salir la mercancía. La cantidad vendible de un stock se calcula como la cantidad física de sus sources menos las reservas de ese stock.
Eso funciona mientras cada source pertenece a un solo stock. Deja de funcionar cuando dos stocks comparten un almacén, algo habitual cuando dos sitios web venden la misma mercancía física:
- Un almacén tiene 10 unidades y está asignado al stock A y al stock B.
- El stock A vende las 10. Sus reservas bajan su cantidad vendible a 0.
- El stock B no ve esas reservas. Para él quedan 10 unidades vendibles, y vende otras 10.
- Cuando llegan los envíos, hay 20 unidades vendidas sobre 10 físicas.
No es un bug que se corrija con configuración. Es el modelo de datos, y con varios stocks sobre los mismos sources la sobreventa crece con el tráfico de cada canal.
Las reservas que no se cierran
La otra mitad del síntoma era el stock bloqueado. Una reserva solo se anula si alguien escribe su compensación, y hay caminos donde eso no pasa o pasa de más:
- El pedido escribe su reserva antes de cobrar y de guardarse. Si el proceso muere en medio, por memoria agotada, un timeout de PHP-FPM o un contenedor reiniciado, la reserva queda para un pedido que no existe.
- Nada limita una liberación a lo que el pedido todavía tiene reservado. Dos liberaciones del mismo pedido que se cruzan, como un envío que se guarda mientras el pedido se cancela, pueden devolver la misma unidad dos veces, y esa unidad queda vendible para siempre.
MSI trae comandos para listar inconsistencias y crear compensaciones, pero se corren a mano, después de que alguien notó el descuadre.
El Default Stock no es un stock
El segundo hallazgo apareció al leer el código. En MSI, el stock 1, el Default Stock, no funciona como los demás:
inventory_stock_1es una vista MySQL sobrecataloginventory_stock_status, la tabla del sistema anterior.- El indexer de MSI se salta el stock 1 a propósito.
- La disponibilidad de los productos compuestos en ese stock la calcula el indexer legacy de CatalogInventory.
Unas cincuenta ramas if ($stockId === $defaultStockId) repartidas en veinte módulos mantienen separados los dos mundos. Dos caminos de datos significan que un bug arreglado de un lado del if sigue abierto del otro, y que cada funcionalidad nueva se escribe y se prueba dos veces. Tampoco hay stock realmente independiente del sistema anterior: manage_stock, backorders o min_qty viven en cataloginventory_stock_item para todos los stocks, no solo para el 1.
No es que nadie lo supiera
El roadmap de MSI tiene un Milestone 4: Remove dependencies to CatalogInventory module. Entre sus tareas están asignar más sources al Default Stock, hacerlo intercambiable y reemplazar del todo el índice de CatalogInventory. Ninguna está marcada como hecha, y la página no se edita desde febrero de 2020. “Reservation on the level of Source” aparece más abajo, en el backlog, sin milestone asignado.
Los issues cuentan lo mismo desde el lado de quien lo sufre. El #2727, abierto en noviembre de 2019, describe dos tiendas que comparten inventario y venden más de lo que hay. Sigue abierto, con 16 comentarios. El #3247, de 2020, pide pasar las reservas por source al Milestone 4, enlaza otros cinco issues con el mismo pedido y lo resume en una frase: “The link between product and source was suddenly lost when MSI added reservations”.
MSI no está abandonado. Adobe sigue integrando arreglos internos, el último el 22 de octubre de 2026. Lo que se detuvo fue su construcción: a finales de octubre de 2026, el repositorio tiene 38 pull requests abiertos, el más antiguo de marzo de 2020, y desde enero de 2025 se integraron cuatro. La parte que faltaba para que MSI fuera el único sistema de inventario de Magento nunca se hizo.
Qué hace msi-core
msi-core es un fork de magento/inventory basado en el MSI de Magento 2.4.9 y sincronizado con su rama develop. Conserva los nombres de módulo Magento_Inventory*, los namespaces y los service contracts, y reemplaza vía Composer los 73 módulos de MSI que trae Magento, también con los nombres de paquete de Mage-OS.
Reservas por source
Es opcional y viene apagado (cataloginventory/source_reservations/enabled). Cada reserva de venta se divide en una fila por source, repartida entre los sources habilitados del stock según su prioridad. Así la reserva baja la cantidad vendible de todos los stocks que comparten ese source, que es exactamente el hueco del ejemplo. Las compensaciones de envío, cancelación y nota de crédito caen en los sources donde se reservó, sin importar desde cuál se envíe.
El bloqueo también cambia. MSI serializa los pedidos por stock; msi-core lo hace por (sku, source). Dos pedidos en stocks distintos que comparten almacén se esperan entre sí, y los que no comparten ningún source corren en paralelo. El bloqueo dura solo lo que tarda en escribirse la reserva, entre 8 y 27 ms en las mediciones, no el cobro ni el guardado del pedido.
Un registro de reservas que se repara
- Cada liberación tiene un tope: lo que el pedido todavía reserva. Ese saldo se guarda por pedido, SKU y source, y se bloquea mientras dura la transacción, así que dos liberaciones del mismo pedido ya no pueden devolver la misma unidad.
- Una pasada de reconciliación, a mano o por cron, compensa los pedidos terminados que quedaron con reservas abiertas y libera las de pedidos que nunca llegaron a guardarse.
- La detección de sobreventa avisa cuando un source queda por debajo de lo que ya tiene comprometido. No bloquea ventas: el stock físico sigue mandando.
bin/magento inventory:reservation:reconcile --dry-run
bin/magento inventory:reservation:detect-oversell
Un solo sistema de inventario
El stock 1 se indexa, se configura, se edita y se borra como cualquier otro. La configuración de cada SKU pasa a inventory_stock_item_configuration, y MSI deja de leer y escribir cataloginventory_stock_item y cataloginventory_stock_status. Esas tablas se conservan congeladas, porque 42 módulos del core dependen de Magento_CatalogInventory, y los contratos de lectura heredados, como StockRegistryInterface, se sirven desde MSI. El código que pasa por ellos no cambia.
Lo que viene encima
Sobre ese único camino de código, msi-core suma la cantidad vendible desglosada por source en el admin, un historial de cada cambio de stock, un panel de disponibilidad en la tienda y la detección de escrituras que todavía apuntan a las tablas congeladas. También incluye cinco pull requests que siguen abiertos en magento/inventory, con el crédito a sus autores.
Lo que cuesta
msi-core no es cambiar un paquete por otro. Es una migración de esquema: agrega tablas, migra datos y deja de escribir dos tablas del core.
- Necesita una ventana de mantenimiento y no tiene vuelta atrás. Para regresar a MSI se restaura el backup.
- Rompe el código que lee
cataloginventory_stock_itemocataloginventory_stock_statuscon SQL directo. Los lectores de Magento ya están redirigidos; una extensión que haga eso tiene que pasar por los service contracts. - El consumer
inventory.reservations.updateSalabilityStatustiene que estar corriendo. Sin él, el índice se queda atrás y la tienda sigue vendiendo lo que ya está comprometido. - Soporta Magento 2.4.9 y Mage-OS 3.x, con PHP 8.3 a 8.5.
Es un derivado de magento/inventory distribuido bajo AFL-3.0, sin relación con Adobe.
Pruébalo
composer config repositories.msi-core vcs https://github.com/jeanmarcos-dev/msi-core
composer require "jeanmarcos/msi-core:^1.0"
Antes de correr setup:upgrade en una tienda con datos, lee Upgrade from Magento MSI. La documentación completa está en jeanmarcos-dev.github.io/msi-core, y los issues y pull requests son bienvenidos en el repositorio.
Cierre
MSI tenía la idea correcta: separar dónde está la mercancía de quién la vende, y registrar movimientos en lugar de pisar un contador. Su construcción se detuvo antes del último tramo, que la reserva supiera de qué source sale y que el Default Stock dejara de ser la excepción. msi-core retoma desde ahí, y suma enfoques que ese roadmap no tenía: un registro de reservas que se repara solo, la cantidad vendible desglosada por source y el historial de cada cambio de stock. Es una lástima dejar morir una buena idea; prefiero seguir construyéndola.