Cómo reconstruir los movimientos de stock

A veces puedes encontrarte con que la cantidad de stock que se muestra en la ficha de un producto o en el almacén no coincide con la suma de sus movimientos de stock. El plugin StockAvanzado incluye una herramienta para regenerar todos los movimientos a partir de tus documentos (albaranes y facturas de compra y venta, transferencias y conteos) y dejar el stock cuadrado.

🤔 ¿Por qué se produce un descuadre?

StockAvanzado mantiene un histórico de movimientos de stock (entradas y salidas) que se calcula a partir de tus documentos. La cantidad que ves en la previsualización del almacén y en la ficha del producto debería coincidir con el saldo de esos movimientos.

Pueden aparecer descuadres por distintos motivos:

Modificaciones manuales del stock hechas directamente sobre la ficha del producto o la variante.
Importaciones masivas de datos sin auditar las cantidades.
Activar y desactivar plugins relacionados con el stock mientras se procesaban documentos.
Errores corregidos en versiones antiguas del plugin. Actualizar el plugin evita que se sigan produciendo nuevos descuadres, pero no repara los datos que ya estaban mal: para eso hay que reconstruir los movimientos.

🔧 Cómo reconstruir todos los movimientos de stock

El plugin trae un trabajo programado (cronjob) llamado movements-rebuild que borra todos los movimientos y los vuelve a generar desde cero a partir de tus documentos. Este trabajo está configurado para ejecutarse una sola vez, por lo que para volver a lanzarlo basta con eliminarlo y dejar que el cron lo recree.

Sigue estos pasos:

Asegúrate de tener el plugin StockAvanzado actualizado a la última versión.
Comprueba que tienes el cron en funcionamiento (ejecución periódica de tareas). Puedes consultar cómo ejecutar el cron de FacturaScripts.
Ve al menú Panel de control → Trabajos programados.
Localiza el trabajo movements-rebuild y elimínalo.
En la siguiente ejecución del cron, el trabajo se volverá a crear y comenzará a regenerar automáticamente los movimientos de stock de cada producto.

ℹ️ El proceso trabaja producto a producto en segundo plano. En instalaciones con muchos productos puede tardar un rato en completarse; deja que el cron siga ejecutándose hasta el final.

🧰 Reconstruir un solo producto desde su ficha

Si solo necesitas cuadrar un producto concreto, no hace falta reconstruir toda la instalación. Cuando FacturaScripts está en modo depuración y accedes como administrador, en la ficha del producto (pestaña Movimientos) aparecen dos botones:

Reconstruir movimientos: regenera los movimientos de stock de ese producto a partir de sus documentos.
Reconstruir stock: recalcula la cantidad de stock de ese producto (ver el aviso del apartado siguiente antes de usarlo).

Es la forma más rápida de arreglar un caso puntual sin lanzar el proceso completo. Si no ves estos botones, es porque el modo depuración está desactivado o no estás usando un usuario administrador.

⚙️ Recalcular también la cantidad de stock (avanzado)

En la mayoría de los casos la cantidad de stock real es correcta y el descuadre está solo en el histórico de movimientos, por lo que reconstruir los movimientos es suficiente. Reconstruirlos regenera el histórico sin tocar la cantidad de stock.

El plugin ofrece además una opción para que, al regenerar los movimientos, se sobrescriba la cantidad de stock mostrada con el saldo calculado a partir de esos movimientos: la casilla Reconstruir stock tras los movimientos (menú Panel de control → Preferencias, apartado de productos).

⚠️ Úsala con cuidado. Esta opción reemplaza la cantidad de stock por la que resulte de los movimientos. Si tu cantidad de stock real ya es correcta, no la actives: podrías sustituir un dato bueno por uno calculado a partir de movimientos que todavía no están del todo cuadrados. Actívala únicamente si tu cantidad de stock también está mal y tienes el plugin actualizado a la última versión.

💡 Buenas prácticas para evitar descuadres

No modifiques nunca el stock a mano desde la pestaña de stock de la variante del producto.
Realiza cualquier ajuste, merma o regularización a través de los conteos de stock, para que quede registrado el movimiento correspondiente. Tienes más información en la guía de cómo hacer inventario del almacén.
Si quieres consultar el histórico de un producto, revisa la guía de cómo ver los movimientos de stock de un producto.