Importar productos CSV en PrestaShop: tutorial fácil

Introducción: ¿Por qué importar productos en PrestaShop desde un CSV?

Si tienes una tienda online con PrestaShop, seguramente llegará un momento en el que necesites añadir muchos productos a la vez. Hacerlo uno por uno desde el panel de administración es lento, tedioso y propenso a errores humanos. La solución más eficiente y profesional es la importación masiva mediante archivos CSV.

Un archivo CSV (del inglés Comma-Separated Values) es un formato de texto plano que organiza la información en filas y columnas, similar a una hoja de cálculo. Es el estándar de facto para intercambiar datos entre plataformas de comercio electrónico. Aprender a importar csv prestashop correctamente te ahorrará horas de trabajo y te permitirá escalar tu catálogo de forma rápida.

En esta guía para principiantes, te voy a explicar paso a paso cómo preparar tu archivo, configurar la importación en PrestaShop y solucionar los errores más comunes. No necesitas ser un experto en programación, solo seguir las instrucciones al pie de la letra.

¿Qué necesitas antes de empezar?

Antes de lanzarte a importar, asegúrate de tener lo siguiente:

Acceso al panel de administración de tu PrestaShop (normalmente en tudominio.com/admin).
Un archivo CSV con los datos de tus productos. Puedes crearlo desde Excel, Google Sheets o cualquier editor de texto.
Una copia de seguridad de tu base de datos. Esto es fundamental por si algo sale mal. Puedes hacerla desde el panel de tu hosting o usando módulos de backup.
Paciencia y atención al detalle. La primera vez siempre cuesta un poco, pero luego es pan comido.

[WARNING] Nunca importes un CSV sin hacer una copia de seguridad antes. Si la estructura del archivo no es correcta, podrías sobrescribir productos existentes o generar datos basura en tu tienda.

Paso 1: Estructura correcta del archivo CSV

La clave para importar productos prestashop sin problemas es que el CSV tenga las columnas correctas. PrestaShop es bastante flexible, pero hay campos obligatorios y otros opcionales.

Campos obligatorios

name (nombre del producto): Es el título que verá el cliente.
price (precio): El precio de venta sin impuestos (o con impuestos, según tu configuración).
quantity (cantidad): El stock disponible.

Campos altamente recomendados

id o reference (referencia): Un código único para identificar el producto. Si no lo pones, PrestaShop generará uno automáticamente.
description_short (descripción corta): Resumen que aparece en las listas de productos.
description (descripción larga): Ficha completa del producto.
categories (categorías): Ruta de categorías separadas por / (por ejemplo: Ropa/Hombres/Camisas).
image_url (URL de imagen): Enlace directo a la imagen del producto. PrestaShop la descargará automáticamente.
active (activo): 1 para visible, 0 para oculto.
weight (peso): Útil para calcular gastos de envío.
manufacturer_name (fabricante): Nombre de la marca.

Ejemplo de estructura básica

name,price,quantity,description_short,description,categories,image_url,active
Camiseta básica,15.99,100,Camiseta de algodón,Camiseta de manga corta 100% algodón,Ropa/Hombres,https://ejemplo.com/camiseta.jpg,1
Pantalón vaquero,29.50,50,Pantalón de mezclilla,Pantalón vaquero de corte recto,Ropa/Hombres,https://ejemplo.com/pantalon.jpg,1

[TIP] Si usas Excel o Google Sheets, guarda el archivo como CSV UTF-8. Esto evita problemas con caracteres especiales como tildes o la letra "ñ". En Google Sheets: Archivo → Descargar → CSV (hoja actual). En Excel: Archivo → Guardar como → CSV UTF-8 (delimitado por comas).

Paso 2: Acceder a la herramienta de importación

Una vez que tienes tu CSV listo, inicia sesión en el panel de administración de PrestaShop y sigue estos pasos:

En el menú lateral izquierdo, ve a Catálogo.
Haz clic en Productos.
En la parte superior derecha, verás un botón que dice Importar. Haz clic en él.

Se abrirá una nueva página con el asistente de importación. Es posible que veas un mensaje sobre el tamaño máximo del archivo. Si tu CSV pesa más de 8 MB, tendrás que dividirlo en varios archivos más pequeños o aumentar el límite desde la configuración de PHP de tu servidor.

[INFO] Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), puedes aumentar el límite de subida editando el archivo php.ini. Accede a Syspanel a través del puerto 2106 (por ejemplo, https://tudominio.com:2106), busca la sección de PHP y modifica los valores upload_max_filesize y post_max_size. Luego reinicia el servicio PHP.

Paso 3: Configurar la importación (paso a paso)

El asistente de PrestaShop te guiará a través de varias pantallas. Voy a explicarte cada una:

Selección del archivo

Haz clic en Seleccionar archivo y elige tu CSV desde tu ordenador.
Si ya has importado antes, puedes usar el selector de Historial de importaciones para reutilizar un archivo.
Marca la casilla Restablecer los IDs de los productos solo si estás seguro de que quieres sobrescribir los IDs existentes. Para principiantes, recomiendo dejarla desmarcada.

Configuración de idioma y separador

Idioma: Selecciona el idioma principal de tu tienda (español, inglés, etc.). Los campos de texto se importarán en ese idioma.
Separador de campos: Asegúrate de que coincide con el que usas en tu CSV. Normalmente es la coma (,), pero si tu archivo usa punto y coma (;), cámbialo aquí.
Separador de valores múltiples: Se usa para campos que contienen varias opciones (como atributos). Por defecto es el punto y coma (;).

Configuración de campos

Aquí es donde ocurre la magia. PrestaShop intentará adivinar qué columna corresponde a cada campo, pero es recomendable que lo verifiques manualmente.

Verás una tabla con las columnas de tu CSV a la izquierda y los campos de PrestaShop a la derecha.
Arrastra o selecciona de la lista desplegable el campo correcto para cada columna.
Por ejemplo, si tu primera columna es name, selecciona name en el desplegable correspondiente.
Si hay columnas que no quieres importar, selecciona Ignore (Ignorar).

[WARNING] PrestaShop distingue entre mayúsculas y minúsculas en los nombres de los campos. Asegúrate de que el campo se llama exactamente igual que en la lista (en minúsculas). Por ejemplo, Name no funcionará, debe ser name.

Previsualización de datos

Antes de lanzar la importación, PrestaShop te mostrará una vista previa de cómo quedarán los datos. Revisa que los nombres, precios y cantidades se ven correctos. Si algo está mal, es el momento de corregirlo.

Paso 4: Ejecutar la importación y verificar

Cuando todo esté configurado, haz clic en Siguiente y luego en Importar. El proceso puede tardar unos minutos si tienes muchos productos. Verás una barra de progreso.

Al finalizar, PrestaShop te mostrará un resumen con el número de productos importados, actualizados y los errores encontrados.

¿Qué hacer después de importar?

Limpia la caché: Ve a Parámetros avanzados → Rendimiento y haz clic en Vaciar la caché. Esto asegura que los cambios se reflejen inmediatamente en tu tienda.
Revisa algunos productos: Entra en tu tienda como cliente y comprueba que las fichas de producto se ven bien, las imágenes cargan y los precios son correctos.
Comprueba las categorías: Asegúrate de que los productos están asignados a las categorías correctas.

Errores comunes al importar CSV en PrestaShop

Aunque sigas todos los pasos, es posible que encuentres algunos errores. Aquí te dejo los más frecuentes y cómo solucionarlos:

"No se pudo abrir el archivo"

Este error suele deberse a que el archivo CSV está corrupto o no tiene el formato correcto. Prueba a guardarlo de nuevo desde Google Sheets o Excel en formato CSV UTF-8.

"Campo desconocido"

Significa que has escrito mal el nombre de un campo en la configuración. Vuelve al paso de Configuración de campos y revisa que todos los nombres coinciden exactamente con los de la lista.

Productos que se importan pero no aparecen en la tienda

Revisa que el campo active está configurado a 1. Si no has incluido esa columna, PrestaShop importa los productos como inactivos por defecto.

Caracteres extraños o signos de interrogación

Esto es un problema de codificación. Tu archivo CSV debe guardarse como UTF-8. Si usas Excel, asegúrate de elegir "CSV UTF-8" al guardar, no "CSV" a secas.

La imagen no se descarga

Verifica que la URL de la imagen es pública y accesible directamente. A veces los sitios bloquean descargas automatizadas. También comprueba que el campo se llama image_url y no imagen_url.

[TIP] Si tienes muchas imágenes, te recomiendo importar primero los productos sin imágenes y luego usar el módulo "Importar imágenes por URL" que viene incluido en PrestaShop. Es más fiable para volúmenes grandes.

Consejos avanzados para importar productos prestashop CSV

Una vez que domines lo básico, puedes aprovechar al máximo la importación:

Importar atributos y combinaciones

¿Vendes camisetas en varias tallas y colores? Puedes importar combinaciones usando campos como attributes con el formato Color:Rojo, Talla:M. Es un poco más complejo, pero te ahorrarás muchísimo tiempo.

Actualizar precios y stock sin tocar el resto

Si solo quieres actualizar precios o cantidades, crea un CSV con las columnas id o reference, price y quantity. En la configuración de importación, asegúrate de que el modo de actualización esté en "Actualizar los productos existentes" en lugar de "Crear nuevos".

Programar importaciones automáticas

Existen módulos de pago que te permiten programar importaciones periódicas desde un servidor FTP o una URL. Esto es ideal si tu proveedor te envía un catálogo actualizado cada semana.

Preguntas frecuentes (FAQ)

¿Puedo importar productos prestashop CSV con imágenes desde mi ordenador?

Sí, pero las imágenes deben estar alojadas en un servidor accesible por URL. PrestaShop no puede subir imágenes desde tu disco duro local durante la importación. Sube primero las imágenes a tu hosting y luego usa las URLs completas.

¿Qué pasa si mi CSV tiene más de 1000 productos?

PrestaShop puede manejar grandes volúmenes, pero la importación puede tardar varios minutos. Te recomiendo dividir el archivo en lotes de 500-1000 productos para evitar tiempos de espera excesivos y facilitar la depuración de errores.

¿Cómo sé si la importación ha sobrescrito productos existentes?

PrestaShop te muestra un resumen al final de la importación con el número de productos añadidos y actualizados. Si usas el campo reference, los productos con la misma referencia se actualizarán en lugar de duplicarse.

¿Puedo deshacer una importación?

No hay una función nativa de "deshacer". Por eso es tan importante hacer una copia de seguridad antes de importar. Si algo sale mal, restaura la base de datos desde tu panel de hosting o desde Syspanel (puerto 2106).

¿Qué es un CSV multi-idioma?

Es un formato que te permite importar los campos de texto en varios idiomas a la vez. Se usa una columna por idioma, por ejemplo: name_es, name_en, description_es, description_en. En la configuración de importación, PrestaShop te permite asignar cada columna a su idioma correspondiente.

Conclusión

Importar productos en PrestaShop desde un CSV es una habilidad esencial para cualquier propietario de tienda online que quiera gestionar su catálogo de manera eficiente. Aunque al principio pueda parecer abrumador, siguiendo esta guía paso a paso verás que es un proceso lógico y muy gratificante.

Recuerda siempre: haz copias de seguridad, valida tu CSV antes de importar y revisa los resultados después. Con la práctica, podrás importar productos prestashop en cuestión de minutos, incluso con cientos de artículos.

Si te surge cualquier duda, no dudes en consultar la documentación oficial de PrestaShop o contactar con tu proveedor de hosting. Y si tu servidor usa Syspanel, recuerda que puedes gestionar los límites de subida y las copias de seguridad desde su interfaz en el puerto 2106.

¡Ahora es tu turno! Prepara tu primer CSV y lanza esa importación. Tu tienda te lo agradecerá.