Manual de usuario — EasyPurchase

EasyPurchase es un generador de pedidos a proveedor (MRP ligero) para FacturaScripts. Calcula qué comprar, a quién y cuánto a partir del stock mínimo y de los pedidos de venta pendientes, y propone niveles de stock (mínimo/máximo) basados en el consumo histórico. Todo se revisa antes de aplicarse: nada se pide ni se modifica automáticamente.

Versión del plugin documentada: 0.1

Si esta versión no coincide con la del plugin instalado (Admin → Plugins), el manual podría estar desactualizado.

Índice

1. Instalación
2. Configuración previa: reglas de compra
3. Propuesta de compra
4. Propuesta de niveles de stock
5. Historial de niveles de stock
6. Generación programada (Cron)

1. Instalación

1. En Admin → Plugins → Subir, selecciona el fichero EasyPurchase.zip.
2. Activa el plugin. Al activarse se crean automáticamente sus tablas

(easypurchase_*).

1. Requisitos: FacturaScripts 2025+ y PHP 8.0 o superior.

Tras la activación tendrás tres pantallas nuevas en el menú Almacén: Propuesta de compra, Propuesta de niveles de stock e Historial de niveles de stock; y una pestaña Reglas de compra en las fichas de proveedor y de producto.

2. Configuración previa: reglas de compra

Las reglas son opcionales pero mejoran mucho las propuestas.

Reglas por producto

En la ficha del producto, pestaña Reglas de compra, defines por variante:

• Proveedor preferente: a quién comprar esa referencia (aunque no tenga precio de proveedor todavía).
• Múltiplo de compra: redondea la cantidad hacia arriba a este múltiplo.
• Cantidad mínima de compra: suelo de unidades por línea.

Reglas por proveedor

En la ficha del proveedor, pestaña Reglas de compra:

• Importe / unidades mínimas de pedido: si el pedido no las alcanza, se avisa (no se bloquea).
• Días de entrega (lead time): se usa para calcular los niveles de stock.
• Stock de seguridad (%): colchón que se aplica a las líneas de ese proveedor.

3. Propuesta de compra

Almacén → Propuesta de compra. Calcula la necesidad, la muestra agrupada por proveedor y, tras tu revisión, genera los pedidos a proveedor en borrador.

Opciones de cálculo

| Opción | Qué hace |

|---|---|

| Usar stock mínimo | Repone hasta el nivel objetivo (mínimo o máximo) de cada producto. |

| Usar pedidos de venta | Añade la demanda de ventas pendientes que el stock no cubre. |

| Reponer hasta | Objetivo: stock mínimo (lo justo) o máximo (más colchón). |

| Almacén | Limita el cálculo a un almacén; Todos lo calcula en cada uno por separado. |

| Cálculo | Por almacén (una necesidad por producto y almacén) o Global por referencia (suma todos los almacenes en una sola necesidad). |

La fórmula de la necesidad neta y cada opción están explicadas en el desplegable «Ayuda: ¿qué significa cada opción?» de la propia pantalla.

Resultado y generación

• Las líneas se agrupan por proveedor (con su nombre) y muestran avisos de mínimo de pedido (verde/rojo).
• El almacén es editable en cada línea: pon el mismo almacén en varias líneas para consolidarlas en un único pedido.
• Líneas ya pedidas en otro almacén: si una referencia ya tiene un pedido a proveedor pendiente de recibir en otro almacén, la línea aparece resaltada y desmarcada (con el almacén, la cantidad y el código del pedido). Solo se genera si la marcas a propósito, evitando pedir dos veces lo mismo.
• Al pulsar Generar pedidos se crea un PedidoProveedor en borrador por cada proveedor y almacén. Cada propuesta queda en el histórico.

Las variantes con necesidad pero sin proveedor se listan aparte (nunca se descartan). Asígnales un proveedor preferente para incluirlas.

4. Propuesta de niveles de stock

Almacén → Propuesta de niveles de stock. Sugiere el stock mínimo y máximo de cada producto por almacén a partir de su consumo histórico de ventas. Revisa, ajusta y aplica solo las filas que marques.

Opciones

| Opción | Qué hace |

|---|---|

| Fuente de consumo | De dónde se mide: facturas, albaranes o pedidos de venta. |

| Método | Cobertura por días (simple) o Stock de seguridad estadístico. |

| Nivel de servicio | Solo en el método estadístico (90/95/97,5/99 %): a mayor nivel, mayor stock de seguridad. |

| Ventana (días) | Histórico analizado (365 = 12 meses). |

| Lead time / Días de seguridad / Periodo de reposición | Parámetros del cálculo (el lead time se afina por proveedor si hay regla). |

| Solo con consumo / Solo los que cambian | Filtros para acotar la lista. |

Métodos:

• Cobertura por días: mín = consumo_diario × (lead time + seguridad);

máx = consumo_diario × (lead time + reposición + seguridad).

• Estadístico: mín = consumo_diario × lead time + z × σ × √lead time;

añade un stock de seguridad según la variabilidad de la demanda.

Aplicar

Cada fila muestra actual vs sugerido (editable). Marca las que quieras y pulsa Aplicar niveles seleccionados: se escriben en el stock y queda registro del cambio. Las filas que no cambian aparecen atenuadas y desmarcadas.

5. Historial de niveles de stock

Almacén → Historial de niveles de stock. Registro de auditoría (solo lectura) de cada cambio de nivel aplicado: fecha, referencia, almacén, valores antes y después, y usuario. Con búsqueda y filtros por fecha y almacén.

6. Generación programada (Cron)

EasyPurchase incluye dos tareas diarias (6:00) que nunca generan pedidos ni modifican el stock automáticamente:

• Propuesta de compra: calcula y deja una propuesta pendiente de revisión en el histórico.
• Revisión de niveles de stock: calcula y avisa de cuántos niveles convendría revisar.

En ambos casos, un humano debe entrar en la pantalla correspondiente y confirmar.