Mass Product Updater (CSV/Excel). Mass Product Updater importa un archivo CSV o Excel (.xlsx) y actualiza el precio, el stock, el estado y los identificadores de tus productos existentes. Guardas perfiles de correspondencia de columnas reutilizables, revisas cada cambio línea por línea con una simulación antes de que se escriba nada, lanzas la importación por lotes con un informe de errores línea por línea y deshaces la última importación si hace falta. Un cron protegido por token te permite automatizar los feeds de proveedores. Sin programar, sin tocar la plantilla.
Mass Product Updater importa un archivo CSV o Excel (.xlsx) y actualiza el precio, el stock, el estado y los identificadores de tus productos existentes. Guardas perfiles de correspondencia de columnas reutilizables, revisas cada cambio con una simulación línea por línea antes de que se escriba nada, lanzas la importación por lotes con un informe de errores línea por línea y deshaces la última importación si hace falta. Un cron protegido por token te permite automatizar los feeds de proveedores. Sin programar, sin tocar la plantilla.
1. Instalación
- En el back office ve a Módulos → Gestor de módulos → Subir un módulo y selecciona el ZIP del módulo.
- Cuando termine la instalación, pulsa Configurar para abrir el asistente.
.local, .test, localhost) se admiten siempre. Cuando sale una versión nueva, el propio módulo te avisa.Si en lugar de la confirmación lees «Upload failed», PrestaShop puede haber desactivado el módulo sin decírtelo: los ajustes y los datos se quedan donde están. Cómo actualizar un módulo, y qué hacer si dice «Upload failed».
2. Configuración: paso a paso
La pantalla Configurar tiene cuatro pestañas: Importar / actualizar, Perfiles de correspondencia, Historial y deshacer y Ajustes. Una importación normal es un asistente corto: subir el archivo → asignar columnas → simular → aplicar.
1. Subir un archivo CSV o Excel empieza aquí
En la pestaña Importar / actualizar, elige un archivo (.csv / .xlsx) y pulsa Subir. Se admiten .csv, .txt y .xlsx, hasta 20 MB. El CSV está soportado por completo; el XLSX se lee en la medida de lo posible cuando están disponibles las extensiones PHP ZIP y SimpleXML. Si ya tienes un perfil guardado, selecciónalo en Usar un perfil guardado para rellenar de antemano la correspondencia y las opciones de lectura. Recuerda: esta herramienta solo actualiza productos existentes, nunca crea productos nuevos.
2. Asignar las columnas y las opciones de lectura
Tras la subida, el módulo muestra la cabecera y las primeras líneas del archivo para que asignes cada columna de origen. Ajusta arriba las opciones de lectura y debajo la correspondencia de columnas.
- Identificar los productos por: el identificador con el que se busca el producto, ID de producto, Referencia, EAN13, UPC o Referencia del proveedor.
- Delimitador / Delimitador de texto: el separador de campos (usa
\tpara el tabulador) y el carácter de comillas. - Codificación / Decimal: la codificación del archivo (por ejemplo
UTF-8,ISO-8859-1,Windows-1252; se convierte a UTF-8) y el separador decimal (.o,). - La primera línea es la cabecera: márcalo si la línea 1 contiene los nombres de las columnas.
- Cuando ningún producto coincide: Omitir sin avisar o Anotarlo en el registro de la importación.
- Tabla de correspondencia: para cada columna, elige a qué campo alimenta: ** CLAVE DE COINCIDENCIA (identificador) **, Precio (sin impuestos), Precio de coste, Cantidad en stock (valor), Cantidad en stock (delta +/-), Precio específico (fijo), Activo (0/1), Peso, Referencia, EAN13, UPC, Cantidad mínima, o déjala en -- ignorar --.
Tienes que marcar exactamente una columna como CLAVE DE COINCIDENCIA y al menos una columna como campo que actualizar.
3. Simulación y comparativa recomendado
Pulsa Simulación (vista previa) para simular la importación sin escribir nada. El módulo indica cuántas líneas se han reconocido, cuántas no se encuentran y cuántas dan error, y abre el detalle de la importación con una comparativa línea por línea: cada campo modificado aparece como valor anterior → valor nuevo. Revisa siempre la comparativa antes de aplicar.
4. Lanzar la importación (aplicar)
Cuando la comparativa te convenza, pulsa Aplicar los cambios y confirma. La importación se hace por lotes (el tamaño de lote fijado en Ajustes decide cuántas líneas se procesan por transacción). Al final obtienes un resumen, líneas actualizadas, no encontradas y con error sobre el total, además del detalle completo con el registro línea por línea.
5. Perfiles de correspondencia reutilizables
En la pestaña Perfiles de correspondencia guardas una asignación de columnas una sola vez y la reutilizas en los feeds recurrentes. Un perfil guarda el nombre del perfil, el campo de identificación, el delimitador, el delimitador de texto, la codificación, el separador decimal, si hay cabecera, qué hacer cuando el producto no se encuentra y la correspondencia de cada columna (por número de columna, empezando por 0). Los perfiles guardados se editan y se borran, y aparecen tanto en la pestaña Importar como en el cron.
6. Historial y deshacer
La pestaña Historial y deshacer lista las importaciones recientes con su modo (simulación / aplicada), el origen, los totales y el estado. Abre cualquiera para ver sus estadísticas, el registro línea por línea (filtrable por resultado) y un botón Descargar informe (CSV). En una importación aplicada puedes pulsar Deshacer esta importación para restaurar los valores anteriores de todos los campos modificados, siempre que se haya conservado la copia previa (mira los Ajustes).
7. Cron protegido por token automatización
En la pestaña Ajustes, la sección Importación programada (cron) te da una URL de cron lista para usar, con un token secreto dentro. Llámala desde tu programador de tareas (por ejemplo la crontab) para aplicar el perfil del cron elegido al origen del cron configurado: una dirección http(s) de un feed de proveedor, o simplemente el nombre de un archivo colocado en la carpeta de trabajo del módulo (modules/cll_csvimport/work/). Usa Regenerar el token del cron para renovarlo. El token es obligatorio y se comprueba por hash.
8. Ajustes: valores por defecto y datos
La pestaña Ajustes contiene además: Activar el módulo, el tamaño de lote (de 20 a 5000 líneas por transacción; cuanto más bajo, más seguro en servidores pequeños), las opciones de lectura por defecto (delimitador, delimitador de texto, codificación, separador decimal, cabecera, qué hacer si el producto no se encuentra) que rellenan de antemano las importaciones nuevas, Conservar la copia previa a la actualización (es lo que permite deshacer, déjalo activo) y Borrar los datos al desinstalar (desactivado por defecto; si lo activas, al desinstalar se borran todos los perfiles y todo el historial).
3. Comprobar que funciona
- Sube un archivo pequeño y lanza una simulación; abre el detalle y comprueba que la comparativa línea por línea muestra los valores esperados, anterior → nuevo.
- Lanza Aplicar los cambios sobre dos o tres líneas, abre después esos productos y comprueba que el precio y el stock han cambiado como se anunciaba.
- Desde Historial y deshacer, abre esa importación aplicada y pulsa Deshacer esta importación; comprueba que los productos vuelven a sus valores anteriores.
- Pega la URL de cron en un navegador (o llámala con
curl): debe aparecer una importación en el historial, con el perfil y el origen configurados.
4. Preguntas frecuentes
¿Crea productos nuevos?
No. Mass Product Updater solo actualiza productos que ya existen. Las líneas cuyo identificador no coincide con ningún producto se omiten o se anotan, nunca se crean.
¿Qué formatos de archivo admite?
El CSV (y el texto tabulado .txt) está soportado por completo. El Excel .xlsx se lee en la medida de lo posible cuando están disponibles las extensiones PHP ZIP y SimpleXML. Se admiten archivos de hasta 20 MB.
¿Cómo se reconocen los productos?
Eliges una clave de coincidencia, ID de producto, Referencia, EAN13, UPC o Referencia del proveedor, y le asignas una columna. Cada línea se empareja con un producto por ese identificador antes de tocar ningún campo.
¿Deshacer es seguro?
Sí, siempre que la opción Conservar la copia previa a la actualización esté activa (lo está por defecto). El módulo guarda el valor anterior de cada campo modificado, así que una importación aplicada se puede restaurar tal cual. Cada importación solo se puede deshacer una vez.