Documentación CC Actualización masiva de productos
Documentación completa para el módulo de actualización masiva de cantidades y precios de productos de PrestaShop con soporte para importaciones de archivos, tareas CRON y actualizaciones por criterios (cc_ps_mass_update_product).Índice
- Introducción
- Instalación
- Activación de la licencia
- Panel de gestión
- Importación de archivos
- Actualización masiva por criterios
- Tareas CRON
- Sistema de inicio de sesión
- Tipos de identificadores de productos
- Asignación de columnas
- Resolución de problemas
- PREGUNTAS FRECUENTES
1. introducción
CC Mass Product Updater es un módulo avanzado para la actualización masiva de cantidades y precios de productos en PrestaShop. El módulo permite importar datos desde archivos CSV, Excel y XLS, actualizar según criterios y automatizar procesos mediante tareas CRON.El módulo ofrece:
- Importación desde archivos CSV, XLS, XLSX de varias fuentes (carga, servidor, URL)
- Actualización masiva de productos según criterios (categorías, rango de precios, fabricante)
- Compatibilidad con tareas CRON de modo dual (parámetros de configuración y URL)
- Compatibilidad con varios tipos de identificadores de producto (ID, EAN, UPC, ISBN, MPN, Reference, GTIN)
- Sistema avanzado de registro de operaciones
- Asignación intuitiva de columnas con previsualización de archivos
- Validación y control de errores
- Sistema de gestión de licencias
- Almacenamiento de la configuración del usuario
2. instalación
Requisitos del sistema- PrestaShop 1.7 o posterior
- PHP 7.1 o posterior
- Extensión PHP: PhpSpreadsheet (para archivos Excel)
- Memoria mínima: 128 MB
- Permiso para crear directorios temporales
- Descargue el archivo ZIP del módulo de la tienda oficial códigos.cocos
- Inicie sesión en el panel de administración de PrestaShop
- Vaya a: Módulos → Gestor de módulos → Añadir nuevo módulo.
- Haga clic en "Añadir módulo" y seleccione el archivo ZIP descargado.
- Una vez finalizada la instalación, haga clic en "Configurar".
- El módulo creará automáticamente directorios temporales e instalará la configuración necesaria.
Información
Tras la instalación, el módulo creará automáticamente una pestaña "Actualizador masivo" en el menú "Mejoras" del panel de administración y los directorios de trabajo necesarios en la carpeta del módulo.
3. activación de la licencia
Antes de poder utilizar todas las funciones del módulo, es necesario activar la licencia:- Tras la instalación, proceda a la configuración del módulo
- Seleccione la pestaña "Licencia
- Introduzca la clave de licencia recibida tras la compra
- Haga clic en "Activar licencia".
- Tras la activación, aparecerá un mensaje de confirmación y se desbloquearán todas las funciones.
Advertencia
Sin una licencia activa, el módulo funcionará en modo restringido. Aparecerá un mensaje de licencia inactiva en la parte superior del panel de administración y se bloquearán todas las operaciones de actualización.
4 Panel de gestión
El panel de gestión del módulo está disponible en el menú "Mejoras" → "Actualizador masivo" y consta de las siguientes pestañas:Pestañas principales:
- Importación de archivos - Importación de datos desde archivos CSV/Excel
- Actualización masiva - actualización de productos por criterios
- Tareas CRON - configuración de la automatización
- Registros - visualización y gestión de los registros de operaciones
Pestañas de configuración del módulo:
- Ajustes - configuración general del módulo
- Documentación - enlace al manual en línea
- Ayuda - acceso a la asistencia técnica
- Plug-ins - información sobre ampliaciones adicionales
- Licencia - gestión de licencias de módulos
Consejo
El módulo recuerda automáticamente la configuración del usuario (asignaciones de columnas, fuentes de archivos, tipos de ID) en el localStorage del navegador, lo que acelera significativamente el trabajo con operaciones repetidas.
5. importación de ficheros
La pestaña "Importación de archivos" permite importar datos de productos desde diversas fuentes y formatos.Fuentes de archivos compatibles:
- Carga de archivos - cargar un archivo directamente desde su ordenador
- Ruta en el servidor - indicación del archivo ubicado en el servidor
- URL al archivo - descargar un archivo de una URL externa
- CSV (con detección automática de separadores: , ; | tabulador)
- XLS (archivos Excel antiguos)
- XLSX (archivos Excel más recientes)
- Seleccione la fuente del archivo
- Indicar el archivo (upload, ruta o URL)
- Seleccione el tipo de identificador de producto
- Determinar si el archivo contiene cabeceras
- Haz clic en "Vista previa y asignación"
- Asignar las columnas de datos (identificador, cantidad, precio)
- Haga clic en "Realizar importación".
- Tamaño máximo del archivo: 10 MB (configurable)
- Comprobación del formato y la integridad de los archivos
- Validación de estructuras de datos
- Control de disponibilidad de archivos externos
Nota
El módulo detecta automáticamente el separador en los archivos CSV y admite diferentes codificaciones de caracteres. Los archivos temporales se eliminan automáticamente cuando finaliza la operación de importación.
6. Actualización masiva por criterios
La pestaña "Actualización masiva" permite actualizar productos en función de criterios específicos sin tener que importar un archivo.Criterios de selección disponibles:
- Categorías - selección de productos de categorías específicas
- Gama ID del producto - de un ID específico a un ID específico
- Precios - productos con precios dentro de un rango especificado
- Fabricante - productos de un fabricante concreto
- Estado - productos activos o inactivos
- Nueva cantidad - fijar una cantidad específica para todos los productos seleccionados
- Precio nuevo - fijar un precio específico para todos los productos seleccionados
- Es posible actualizar la cantidad y el precio al mismo tiempo o sólo uno de los parámetros
- Seleccione los criterios de selección de productos
- Definir nuevos valores (cantidad y/o precio)
- Haga clic en "Actualizar productos".
- El sistema mostrará el número de productos actualizados y los posibles errores
Advertencia
Una actualización masiva por criterios modifica los datos de todos los productos que cumplen las condiciones especificadas. Se recomienda hacer una copia de seguridad de la base de datos antes de realizar operaciones masivas.
7 Tareas de CRON
La pestaña "Tareas CRON" permite configurar tareas de actualización automática de productos. El módulo ofrece dos modos de funcionamiento con CRON:Modo de configuración (plantilla única)
- Guardar la configuración en la base de datos
- Una tarea CRON para todas las actualizaciones automáticas
- Fácil configuración mediante interfaz web
- URL de la tarea: /modules/cc_ps_mass_update_product/controllers/front/cron.php?token=...
- Pasar todos los parámetros directamente en la URL
- Posibilidad de crear muchas tareas CRON diferentes
- Configuración flexible para usuarios avanzados
- Cada tarea puede tener diferentes ajustes
- Habilitar "Tareas CRON"
- Seleccione la fuente del archivo (servidor o URL)
- Indique la ruta o URL del archivo
- Configurar el tipo de identificador y la asignación de columnas
- Guardar la configuración
- Añadir URL al crontab del servidor
- ficha - token de seguridad (obligatorio)
- fuente - fuente del archivo (servidor|url)
- ruta_archivo - ruta al archivo en el servidor
- URL_archivo - URL al archivo
- tipo_identificador - tipo de identificador del producto
- has_header - si el archivo contiene cabeceras (1|0)
- identificador_mapeo - identificador número de columna
- cantidad_de_mapeo - número de columna con cantidad
- precio_mapeo - número de columna de precios
# Todos los días a las 2:00 - modo de configuración
0 2 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123"
Todos los días a las 3:00 - actualización de cantidades desde el servidor
0 3 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123&source=server&file_path=/var/www/files/quantities.csv&identifier_type=ean&has_header=1&mapping_identifier=0&mapping_quantity=1"
Diariamente a las 4:00 - actualización de precios desde la URL
0 4 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123&source=url&file_url=https://dostawca.pl/prices.csv&identifier_type=reference&has_header=1&mapping_identifier=0&mapping_price=2"Información
Las tareas CRON devuelven una respuesta en formato JSON con información sobre el éxito de la operación, el número de productos actualizados y el tiempo de ejecución. Todas las operaciones se registran en el sistema de registro del módulo.
8 Sistema de inicio de sesión
La pestaña "Registros" ofrece un sistema avanzado de seguimiento de todas las operaciones del módulo.Funciones del sistema de acceso:
- Registro automático de todas las operaciones de actualización
- Diferentes niveles de registro (INFO, ADVERTENCIA, ERROR)
- Archivos de registro separados para cada día
- Visualización de los registros directamente en el panel de administración
- Posibilidad de descargar archivos de registro completos
- Limpieza automática de troncos viejos
- Estado de la conexión - activar/desactivar el guardado de registros
- Lista de archivos de registro - resumen de todos los archivos con fechas y tamaños
- Vista previa de los registros - visualización de las últimas 200 líneas con coloreado por nivel
- Descarga de registros - descargar archivos de registro completos
- Limpieza de troncos viejos - eliminación de registros de más de 30 días
[2025-01-15 14:30:22] [INFO] Iniciando actualización masiva desde fichero: /var/www/files/products.csv
[2025-01-15 14:30:23] [INFO] Cantidad de productos actualizada: ID 123, Cantidad: 50
[2025-01-15 14:30:23] [ADVERTENCIA] Producto no encontrado por código EAN: 1234567890123
[2025-01-15 14:30:25] [INFO] Actualización masiva completada | Contexto: {"success":45, "failed":2}Consejo
Los registros se guardan tanto en el sistema de registro del módulo como en los registros estándar de PrestaShop. Por lo tanto, las operaciones también se pueden rastrear a través de herramientas estándar de análisis de registros del servidor.
9 Tipos de identificadores de productos
El módulo admite distintas formas de identificar los productos, lo que garantiza la máxima flexibilidad a la hora de importar datos.Tipos de identificadores admitidos:
| Tipo | Descripción | Ejemplo |
| Identificación del producto | ID interno de PrestaShop | 123, 456, 789 |
| Referencia (SKU) | Código del producto/SKU | PROD-001, ABC-123 |
| EAN | Código europeo del producto (8-13 dígitos) | 1234567890123 |
| UPC | Código de producto universal | 123456789012 |
| ISBN | Número del libro | 978-3-16-148410-0 |
| MPN | Número de pieza del fabricante | AB-12345 |
| ÍNDICE | Índice de productos (utiliza el campo Referencia) | IND-001 |
| GTIN | Código comercial global (comprueba EAN, UPC, ISBN) | Cualquiera de los anteriores |
Elegir el identificador adecuado:
- Identificación del producto - el más rápido, pero que requiere conocer los ID internos
- Referencia/SKU - más utilizados en las tiendas en línea
- EAN - norma para productos físicos
- GTIN - universal, comprueba todos los códigos de barras posibles
Nota
La selección del tipo de identificador correcto es crucial para el éxito de la importación. El módulo valida automáticamente los formatos de los identificadores y notifica los valores incorrectos en los registros.
10. asignación de columnas
El sistema de asignación de columnas permite asignar de forma flexible los datos del fichero a los campos correspondientes del producto.Proceso de mapeo:
- Tras seleccionar el fichero, el sistema muestra una vista previa de las 5 primeras líneas
- El usuario indica qué columna contiene el identificador del producto
- Indica opcionalmente columnas con cantidad y/o precio
- El sistema valida la corrección de la asignación
- Una vez aprobados, los datos se importan
- Columna de identificadores - siempre necesario
- Columna Cantidad - opcional (enteros ≥ 0)
- Columna de precios - opcional (números reales ≥ 0, máximo 2 decimales)
- Al menos una de las columnas (cantidad o precio) debe estar asignada
- Las columnas no deben ser idénticas
- El módulo guarda automáticamente las últimas asignaciones en el localStorage
- Las asignaciones se restauran para los archivos con estructura idéntica
- Cada asignación contiene información sobre el tipo de identificador y las cabeceras
- Las asignaciones son válidas durante 7 días
- Posibilidad de borrar manualmente los ajustes guardados
ean,nombre,cantidad,precio
1234567890123,"Produkt A",50,19.99
1234567890124,"Produkt B",30,29.99
1234567890125,"Produkt C",0,39.99Éxito
La memorización automática de las asignaciones acelera considerablemente el trabajo con las importaciones regulares. El sistema reconoce la estructura de los archivos y restaura los ajustes pertinentes.
11 Solución de problemas
La importación de archivos no funciona- Compruebe que el módulo tiene una licencia activa
- Asegúrese de que el archivo tiene un formato compatible (CSV, XLS, XLSX)
- Compruebe el tamaño del archivo (por defecto, 10 MB como máximo)
- Para los archivos del servidor, compruebe los permisos de lectura
- Para la URL, compruebe la disponibilidad y exactitud de la dirección
- Compruebe los registros del módulo para ver los detalles del error
- Comprobar si la asignación de columnas es correcta
- Verificar el tipo de identificador del producto
- Asegúrese de que los identificadores del fichero son correctos
- Comprobar si existen productos en la tienda
- Verificar el formato de los datos (números para cantidades y precios)
- Revisar los registros en busca de advertencias
- Validar el token de seguridad
- Asegúrese de que cron está activado en la configuración (modo de configuración)
- Comprobar la disponibilidad del archivo fuente
- Compruebe los registros de tareas CRON en el servidor
- Asegúrese de que la URL de la tarea CRON es correcta
- Comprobar si el servidor puede ejecutar peticiones HTTP
- Reducir el tamaño de los archivos importados
- Aumentar el límite de tiempo de ejecución de PHP (max_execution_time)
- Aumentar el límite de memoria PHP (memory_limit)
- Desactivar el registro de importaciones muy grandes
- Utilizar tareas CRON en lugar de importaciones basadas en navegador
- Divide archivos grandes en partes más pequeñas
Error
Si sigue teniendo problemas, compruebe los registros PHP del servidor y los registros del módulo. En caso de errores críticos, póngase en contacto con el servicio de asistencia de COCOS a través del correo electrónico cocos.codes/soporte.
12. PREGUNTAS FRECUENTES
¿Cuáles son los límites de tamaño de los archivos?El límite por defecto es de 10MB, pero puede aumentarse en la configuración del módulo. Recuerda los límites de PHP (upload_max_filesize, post_max_size).
¿Puedo actualizar sólo los precios sin modificar las cantidades?
Sí, puede actualizar sólo los precios o sólo las cantidades. En la asignación, basta con indicar la columna correspondiente y dejar la otra columna en blanco.
¿Admite el módulo productos con atributos?
El módulo actualiza los productos base. Para los productos con atributos, se actualizan la cantidad y el precio del producto principal.
¿Con qué frecuencia puedo ejecutar tareas CRON?
La frecuencia depende del tamaño del archivo y de los recursos del servidor. Recomendamos no más de cada 15 minutos para archivos grandes.
¿Puedo utilizar el módulo en varias tiendas?
La licencia es válida para un dominio. Se necesita una licencia distinta para cada tienda.
¿Qué ocurre con los productos que no se encuentran?
Los productos no encontrados se omiten y se registran en los logs como advertencias. Esto no afecta a los demás productos de la importación.
¿Puedo restablecer los valores anteriores después de la actualización?
El módulo no crea automáticamente copias de seguridad. Recomendamos hacer una copia de seguridad de la base de datos antes de realizar operaciones masivas.
¿Cómo puedo automatizar las importaciones desde FTP?
Utilice las tareas CRON con el modo 'ruta en el servidor', apuntando al directorio al que se envían los archivos por FTP.
¿El módulo registra todas las operaciones?
Sí, todas las operaciones se registran con la opción de activar/desactivar esta función en los ajustes. Los registros contienen información detallada sobre aciertos y errores.
¿Qué codificaciones de caracteres se admiten?
El módulo detecta y admite automáticamente las codificaciones más comunes, como UTF-8, ISO-8859-1 y Windows-1250.
