· 8 min

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.

magentoinventarioarquitecturaopen-source

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:

  1. Un almacén tiene 10 unidades y está asignado al stock A y al stock B.
  2. El stock A vende las 10. Sus reservas bajan su cantidad vendible a 0.
  3. El stock B no ve esas reservas. Para él quedan 10 unidades vendibles, y vende otras 10.
  4. Cuando llegan los envíos, hay 20 unidades vendidas sobre 10 físicas.
MSI · RESERVA POR STOCKMSI-CORE · RESERVA POR SOURCE pedido en A10 unidades reservastock A · −10 stock Avendible: 0 stock Bvendible: 10 almacénfísico: 10 pedido en A10 unidades reservaalmacén · −10 stock Avendible: 0 stock Bvendible: 0 almacénfísico: 10
En MSI la reserva pertenece al stock: el pedido en A baja lo que A puede vender, pero B sigue viendo las 10 unidades del almacén que comparten. En msi-core la reserva pertenece al almacén y baja lo que puede vender cada stock que lo usa.

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_1 es una vista MySQL sobre cataloginventory_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.
MSI · DOS CAMINOSMSI-CORE · UN CAMINO stock 1Default Stock tablas legacycataloginventory_* inventory_stock_1vista MySQL stocks 2..N indexer MSI inventory_stock_Ntabla de índice stocks 1..N indexer MSI inventory_stock_*tablas de índice
En MSI, inventory_stock_1 es una vista MySQL sobre las tablas legacy de CatalogInventory, el indexer de MSI se salta el stock 1 y unas cincuenta ramas if separan los dos caminos. En msi-core todos los stocks, el 1 incluido, pasan por el mismo indexer.

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_item o cataloginventory_stock_status con 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.updateSalabilityStatus tiene 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.