Cómo importar productos en PrestaShop desde un archivo CSV
Introducción: La forma más rápida de llenar tu tienda
Si tienes una tienda online con PrestaShop, tarde o temprano te enfrentarás a la misma situación: tienes 50, 100 o 500 productos que añadir y hacerlo uno a uno desde el panel de administración es una tarea titánica y propensa a errores.
La solución es mucho más sencilla de lo que piensas. PrestaShop incluye un potente importador de archivos CSV (valores separados por comas) que te permite cargar productos PrestaShop de forma masiva en cuestión de minutos. Este proceso no solo te ahorra horas de trabajo, sino que también reduce los errores humanos al mínimo.
En esta guía completa, te explicaré paso a paso cómo importar CSV PrestaShop, qué estructura necesita tu archivo, cómo configurar el importador correctamente y qué hacer cuando las cosas no salen a la primera. No necesitas ser un experto en programación, solo seguir estas instrucciones al pie de la letra.
¿Qué es un archivo CSV y por qué es tan útil?
Un archivo CSV es un formato de texto plano que organiza la información en columnas y filas. Cada fila representa un producto y cada columna una característica (nombre, precio, referencia, etc.). Es el estándar universal para intercambiar datos entre sistemas, y PrestaShop lo soporta de forma nativa.
La gran ventaja es que puedes crear estos archivos con cualquier programa de hoja de cálculo como Excel, Google Sheets o LibreOffice Calc, y guardarlos en formato CSV. También puedes exportarlos desde tu proveedor o desde otra plataforma de ecommerce.
Preparación previa: Lo que necesitas antes de empezar
Antes de lanzarte a la importación, es fundamental que prepares el terreno. Una importación mal planificada puede generar errores que afecten a toda tu tienda.
1. Haz una copia de seguridad
Este es el paso más importante y el que más se olvida. Antes de cualquier operación masiva, entra en tu panel de administración de PrestaShop y haz una copia de seguridad completa de tu base de datos. Si algo sale mal, podrás restaurar tu tienda al estado anterior sin perder información.
[WARNING] No importes productos directamente sobre una tienda en producción sin hacer una copia de seguridad. Un archivo CSV mal formateado puede sobrescribir precios, referencias o descripciones existentes.
2. Conoce tu versión de PrestaShop
El importador ha cambiado ligeramente entre versiones. En PrestaShop 1.6, 1.7 y 8.x el proceso es similar, pero la interfaz puede variar en algunos botones. Esta guía se centra en PrestaShop 1.7 y 8.x, que son las más utilizadas actualmente.
3. Prepara tu archivo CSV
El archivo debe estar en formato UTF-8 para que los caracteres especiales (acentos, eñes) se muestren correctamente. Si usas Excel, al guardar el archivo elige la opción "CSV UTF-8 (delimitado por comas)". Si usas Google Sheets, ve a Archivo > Descargar > CSV.
Estructura del archivo CSV: Las columnas imprescindibles
PrestaShop no exige que tengas todas las columnas posibles, pero hay un mínimo necesario para que el producto se cree correctamente. Te recomiendo empezar con estas columnas básicas:
| Columna | Descripción | ¿Obligatoria? |
|---|---|---|
name | Nombre del producto | Sí |
price | Precio de venta sin IVA | Sí |
reference | Referencia interna única | Recomendada |
description_short | Descripción corta | No |
description | Descripción larga | No |
quantity | Stock inicial | Recomendada |
category | Categoría principal | Recomendada |
active | 1 para activo, 0 para inactivo | No |
Puedes añadir muchas más: imágenes, atributos, fabricante, peso, etc. Pero para tu primera importación, mantén la estructura simple. Es mejor importar 10 productos correctamente que 1000 con errores.
Ejemplo práctico de CSV
Así se vería un archivo CSV válido con tres productos:
name;price;reference;quantity;active
Zapatillas Running;49.99;ZAP-001;25;1
Camiseta Algodón;19.50;CAM-002;100;1
Pantalón Deportivo;34.75;PAN-003;0;0
Fíjate en que uso el punto y coma (;) como separador. En PrestaShop puedes elegir el separador durante la importación, pero el punto y coma es el más seguro en entornos europeos porque la coma se usa para decimales.
Paso a paso: Cómo importar productos en PrestaShop
Ahora viene la parte práctica. Sigue estos pasos con calma y verás cómo tu catálogo se llena en minutos.
Paso 1: Accede al importador
Entra en tu panel de administración de PrestaShop y ve al menú lateral izquierdo. Busca la sección Catálogo y haz clic en Productos. En la esquina superior derecha verás un botón que dice Importar. Haz clic en él.
Paso 2: Sube tu archivo CSV
En la pantalla que aparece, verás un apartado para subir el archivo. Puedes arrastrarlo directamente o hacer clic en "Seleccionar archivo". PrestaShop también te permite importar desde una URL, pero la opción más fiable es la subida directa.
Paso 3: Configura los parámetros de importación
Aquí es donde debes prestar atención. PrestaShop te preguntará:
- Separador de campos: Elige el que uses en tu CSV (normalmente
;o,). - Delimitador de texto: Si tus descripciones contienen el separador, necesitas un delimitador. Lo más común es usar comillas dobles (
"). - Idioma: Selecciona el idioma de los datos de tu archivo.
- Modo de importación: Puedes importar nuevos productos o actualizar los existentes. Para la primera vez, elige "Importar".
[TIP] Si tu archivo tiene caracteres extraños, prueba a cambiar el delimitador de texto o verifica que el archivo esté guardado en UTF-8.
Paso 4: Asocia las columnas del archivo
Este es el paso crítico. PrestaShop te mostrará una tabla con las columnas de tu CSV en la parte izquierda y una lista desplegable en la parte derecha para que indiques qué representa cada columna.
Por ejemplo, si tu primera columna se llama name, en el desplegable debes seleccionar Nombre. Haz esto con todas las columnas. La asociación correcta es la clave para que la importación sea exitosa.
Paso 5: Configura las opciones avanzadas
Desplázate hacia abajo y verás opciones adicionales:
- Actualizar productos existentes: Marca esta casilla si quieres que los productos con la misma referencia se actualicen en lugar de duplicarse.
- Forzar IDs: No la marques a menos que sepas lo que estás haciendo.
- Saltar errores: Recomendable marcarla para que si un producto falla, la importación continúe con los demás.
[INFO] Si no asocias la columna de referencia, PrestaShop generará una automáticamente, pero es mejor que la tengas siempre para evitar duplicados.
Paso 6: Lanza la importación
Haz clic en el botón Siguiente o Importar. PrestaShop procesará el archivo y te mostrará un resumen con el número de productos importados, errores y advertencias.
Cómo importar imágenes desde el CSV
Las imágenes son el alma de una tienda online. Para importarlas junto con tus productos, necesitas una columna adicional llamada image_url. En cada fila, pon la URL completa de la imagen que quieres asociar al producto.
Puedes poner varias URLs separadas por coma (o por el separador que uses) para añadir varias imágenes en orden. PrestaShop descargará las imágenes automáticamente y las asociará al producto.
[WARNING] Las URLs deben ser accesibles públicamente. Si las imágenes están en tu servidor, asegúrate de que la ruta sea absoluta y no requiera autenticación.
Errores comunes y cómo solucionarlos
Es normal que la primera importación no sea perfecta. Aquí tienes los errores más frecuentes y sus soluciones:
Error: "No se pudo encontrar el separador"
Esto significa que el separador que has indicado no coincide con el que usa tu archivo. Abre el CSV en un editor de texto y verifica qué carácter separa los campos.
Error: "El campo name es obligatorio"
Te falta la columna de nombre o no la has asociado correctamente en el paso 4. Vuelve a revisar la asociación de columnas.
Error: "Formato de precio incorrecto"
PrestaShop espera el precio con punto decimal (49.99) y sin símbolos de moneda. Si tu archivo usa coma decimal (49,99), cámbialo antes de subir.
Productos duplicados
Si importas dos veces el mismo archivo sin marcar la opción de actualizar, tendrás duplicados. Siempre marca Actualizar productos existentes si el archivo contiene referencias ya presentes en tu tienda.
Preguntas frecuentes sobre la importación de productos
¿Puedo importar productos con atributos (tallas, colores)?
Sí, pero requiere una estructura más compleja. Necesitas columnas para las combinaciones y un archivo adicional para las opciones. Para empezar, te recomiendo importar primero los productos base y luego añadir atributos manualmente o con un módulo específico.
¿Cuántos productos puedo importar de una vez?
PrestaShop no tiene un límite estricto, pero archivos muy grandes (más de 10,000 filas) pueden agotar el tiempo de ejecución del servidor. Si tienes muchos productos, divide la importación en lotes de 1,000 o 2,000 filas.
¿Qué hago si la importación se detiene a mitad?
Vuelve al importador y revisa el archivo de errores que PrestaShop genera. Corrige los problemas y vuelve a importar solo los productos fallidos.
¿Puedo programar importaciones automáticas?
Con el importador nativo no puedes, pero existen módulos de pago que lo permiten. Para la mayoría de las tiendas, la importación manual periódica es suficiente.
¿Cómo actualizo precios y stock sin tocar el resto?
Crea un CSV con solo las columnas reference, price y quantity. Al importar, marca Actualizar productos existentes y deja el resto de columnas vacías. PrestaShop actualizará solo los campos incluidos.
Consejos finales para una importación exitosa
La práctica hace al maestro. Para tu primera importación, te recomiendo:
- Prueba con 5 o 10 productos antes de lanzar el archivo completo.
- Revisa siempre el resumen después de importar para detectar errores.
- Mantén un archivo maestro en Google Sheets o Excel con todos tus productos. Así podrás modificarlo y reimportar cuando necesites cambios masivos.
- Documenta la estructura que utilizas para futuras importaciones.
La importación de productos mediante CSV es una de las habilidades más valiosas que puedes dominar como gestor de una tienda PrestaShop. Te permitirá expandir tu catálogo rápidamente, sincronizar datos con proveedores y mantener tu tienda actualizada sin esfuerzo manual.
[TIP] Si tu tienda está alojada en un servidor con Syspanel (antes HestiaCP), recuerda que puedes acceder al panel de archivos a través del puerto 2106 para subir tu CSV directamente al servidor si tienes problemas con el límite de tamaño de subida de PrestaShop.
Conclusión
Importar productos en PrestaShop desde un archivo CSV es un proceso que, una vez dominado, te ahorrará muchísimo tiempo y te permitirá escalar tu negocio sin complicaciones. La clave está en preparar bien tu archivo, asociar correctamente las columnas y revisar los resultados después de cada importación.
No tengas miedo de experimentar. Crea un archivo de prueba, impórtalo y juega con las opciones. En pocas horas serás capaz de gestionar catálogos completos con total confianza. Y recuerda: si algo sale mal, siempre puedes restaurar la copia de seguridad y empezar de nuevo.
