Manual de Usuario - Plugin ActualizarListas

ActualizarListas es un plugin profesional para FacturaScripts que permite actualizar precios de productos de forma masiva por familias, aplicando porcentajes de aumento de manera rápida y segura.

🎯 ¿Para qué sirve?

Este plugin es ideal para empresas que necesitan:

Actualizar precios por inflación o cambios de costos
Aplicar aumentos estacionales a categorías específicas
Ajustar precios de familias completas de productos
Mantener márgenes de ganancia consistentes

💼 Casos de Uso Comunes

Ejemplo 1: Aumento por Inflación

Una ferretería necesita aumentar 15% los precios de toda la familia "Herramientas Eléctricas" debido a la inflación.

Ejemplo 2: Ajuste Estacional

Una tienda de ropa quiere aumentar 25% los precios de la familia "Abrigos" antes del invierno.

Ejemplo 3: Actualización de Costos

Un distribuidor recibe nuevas listas de precios de proveedores y necesita actualizar la familia "Electrónicos" con un aumento del 8.5%.

🚀 Instalación

Requisitos Previos

FacturaScripts 2025.61
PHP 7.4 o superior
Permisos de administrador en FacturaScripts

Pasos de Instalación

Descomprimir el archivo del plugin
Copiar la carpeta ActualizarListas a la carpeta Plugins de FacturaScripts
Ir al panel de administración de FacturaScripts
Navegar a Administración → Plugins
Buscar "ActualizarListas" y hacer clic en Activar
El plugin aparecerá automáticamente en el menú Almacén

📖 Guía de Uso Paso a Paso

Acceso al Plugin

Iniciar sesión en FacturaScripts
Ir al menú Almacén → Cambiar precios por familia
Se abrirá la interfaz del plugin

Proceso de Actualización de Precios

Paso 1: Seleccionar Familia

![Selector de Familia]

En el desplegable "Lista de Familias", seleccionar la familia a actualizar
El desplegable muestra: CÓDIGO - DESCRIPCIÓN de cada familia
Solo aparecen las familias que existen en su sistema

Paso 2: Ingresar Porcentaje

![Campo Porcentaje]

En el campo "Porcentaje de Aumento", ingresar el porcentaje deseado
Ejemplos válidos:
- 10 (para 10%)
- 15.5 (para 15.5%)
- 0.75 (para 0.75%)
Rango permitido: 0% a 1000%

Paso 3: Aplicar Cambios

Hacer clic en el botón "Actualizar Precios"
El sistema procesará automáticamente todos los productos
Se mostrará un mensaje de confirmación al completar

⚠️ Importante: ¿Qué se Actualiza?

El plugin actualiza específicamente:

Campo objetivo: coste (costo) de las variantes de producto
Fórmula: nuevo_costo = costo_actual × (1 + porcentaje/100)
Alcance: Todas las variantes de todos los productos de la familia seleccionada

📊 Ejemplos Prácticos

Ejemplo 1: Aumento del 10%

Situación: Familia "Electrónicos" con productos de $100 y $250 Acción: Aplicar 10% de aumento Resultado:

Producto A: $100 → $110
Producto B: $250 → $275

Ejemplo 2: Aumento del 15.5%

Situación: Familia "Ropa" con productos de $50 y $80 Acción: Aplicar 15.5% de aumento Resultado:

Producto A: $50 → $57.75
Producto B: $80 → $92.40

🔍 Verificación de Resultados

Revisar Logs del Sistema

Ir a Administración → Logs del sistema
Buscar entradas con "AUMENTO DE COSTE EN VARIANTES"
Verificar el resumen de la operación:
- Familia procesada
- Porcentaje aplicado
- Cantidad de productos actualizados
- Cantidad de variantes modificadas

Verificar Productos Actualizados

Ir a Almacén → Productos
Filtrar por la familia actualizada
Revisar que los costos se hayan actualizado correctamente

⚡ Características Técnicas

Precisión de Cálculos

Los resultados se redondean a 4 decimales
Garantiza precisión en cálculos monetarios
Evita errores de redondeo acumulativos

Seguridad

Validación de datos de entrada
Manejo de errores robusto
Logs detallados para auditoría
No afecta otros campos del producto

Rendimiento

Procesamiento optimizado por lotes
Manejo eficiente de grandes volúmenes
Mínimo impacto en el rendimiento del sistema

🛡️ Medidas de Seguridad

Antes de Usar el Plugin

Realizar backup de la base de datos
Probar en ambiente de desarrollo antes de producción
Verificar familias y productos a actualizar
Confirmar porcentajes antes de aplicar

Recomendaciones de Uso

Aplicar aumentos en horarios de baja actividad
Verificar resultados inmediatamente después
Mantener registro de los cambios aplicados
Informar al equipo sobre las actualizaciones

🔧 Solución de Problemas

Problema: No aparecen familias en el desplegable

Causa: No hay familias creadas en el sistema Solución: Crear familias en Almacén → Familias antes de usar el plugin

Problema: El porcentaje no se aplica

Causa: Los productos no tienen variantes o el campo costo está vacío Solución: Verificar que los productos tengan variantes con valores de costo

Problema: Error al guardar cambios

Causa: Permisos insuficientes o problemas de base de datos Solución: Verificar permisos de usuario y revisar logs del sistema

📞 Soporte Técnico

Información de Logs

Para solicitar soporte, incluir:

Versión de FacturaScripts
Versión del plugin (1.0)
Logs del sistema relacionados con el error
Descripción detallada del problema

Compatibilidad

FacturaScripts: 2024.1+
PHP: 7.4+
Base de datos: MySQL 5.7+ / MariaDB

📈 Beneficios del Plugin

Ahorro de Tiempo

Actualización masiva en segundos
Elimina la necesidad de editar productos uno por uno
Reduce errores manuales

Precisión

Cálculos automáticos exactos
Aplicación consistente de porcentajes
Logs detallados para verificación

Flexibilidad

Funciona con cualquier familia de productos
Acepta porcentajes decimales
Interfaz intuitiva y fácil de usar

🎓 Mejores Prácticas

Planificación

Identificar las familias a actualizar
Calcular los porcentajes necesarios
Programar la actualización en horarios apropiados
Comunicar los cambios al equipo

Ejecución

Realizar backup antes de comenzar
Aplicar cambios familia por familia
Verificar resultados inmediatamente
Documentar los cambios realizados

Seguimiento

Revisar logs del sistema
Verificar precios en el catálogo
Monitorear impacto en ventas
Ajustar estrategia según resultados