Cómo importar productos a PrestaShop desde un archivo CSV

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

Si tienes una tienda online con muchos productos, añadirlos uno a uno desde el panel de administración puede convertirse en una tarea eterna y propensa a errores. Ahí es donde entra en juego el archivo CSV. Un archivo CSV (valores separados por comas) es un formato universal que te permite organizar toda tu información de productos (nombre, precio, stock, descripción, etc.) en una tabla sencilla.

Piensa en ello como una hoja de cálculo que PrestaShop puede leer e interpretar. Importar productos PrestaShop CSV no solo te ahorra horas de trabajo manual, sino que también reduce el riesgo de cometer errores tipográficos. En esta guía, te mostraré paso a paso cómo hacerlo, desde preparar tu archivo hasta solucionar los problemas más comunes. No necesitas ser un experto en informática; solo sigue las instrucciones y tendrás tu catálogo lleno en un abrir y cerrar de ojos.

Paso 1: Preparar tu archivo CSV (La clave del éxito)

Antes de siquiera abrir el panel de PrestaShop, el trabajo más importante ocurre en tu ordenador. Un archivo CSV mal formateado es la causa del 90% de los errores al importar. Vamos a desglosarlo.

¿Qué programa uso para crear el CSV?

Puedes usar cualquier editor de texto plano (como el Bloc de notas en Windows o TextEdit en Mac) o, mucho mejor, una hoja de cálculo como Microsoft Excel o Google Sheets. Mi recomendación es usar Google Sheets o Excel, ya que te permiten visualizar los datos en columnas y luego exportarlos fácilmente a formato CSV.

La estructura básica: las columnas obligatorias

PrestaShop necesita al menos identificar un campo único para cada producto. Por defecto, el identificador suele ser el id o el referencia (SKU). Te recomiendo usar la referencia, ya que es más fácil de gestionar para los humanos.

Estas son las columnas mínimas que debes tener:

• id: Un número único para cada producto. Si es un producto nuevo, déjalo vacío o pon 0. Si estás actualizando uno existente, pon su ID actual.
• referencia: Un código alfanumérico único (ej. CAM-001). Es tu identificador personal.
• nome (o name): El nombre público del producto.
• precio (o price): El precio de venta sin impuestos (ej. 19.99).
• cantidad (o quantity): El stock disponible.

Exporta una plantilla desde tu propio PrestaShop (El truco infalible)

En lugar de adivinar el formato exacto, deja que PrestaShop te dé la plantilla perfecta.

1. Ve a tu panel de administración de PrestaShop.
2. Navega a Catálogo > Productos.
3. Haz clic en el botón "Importar" (suele tener un icono de flecha hacia arriba).
4. En la siguiente pantalla, verás un enlace que dice "Descargar un archivo de ejemplo .CSV". Haz clic en él.

Este archivo de ejemplo contiene todas las columnas que PrestaShop reconoce. Ábrelo en tu hoja de cálculo, bórralo y pon tus datos. Así te aseguras de que los nombres de las columnas coinciden exactamente (ej. name, price, reference). Si no usas la plantilla, asegúrate de que los encabezados de tus columnas sean exactamente esos.

Paso 2: Accede a la herramienta de importación en PrestaShop

Una vez que tienes tu archivo CSV listo, es hora de llevarlo a tu tienda.

1. Inicia sesión en el panel de administración de tu PrestaShop.
2. En el menú lateral izquierdo, busca la sección "Catálogo" y haz clic en "Productos".
3. En la esquina superior derecha, verás el botón "Importar". Haz clic en él.

Se abrirá una nueva página con un asistente dividido en varios pasos. No te asustes; es más sencillo de lo que parece.

Configuración inicial del asistente

En el primer bloque, "¿Qué deseas importar?", asegúrate de que esté seleccionado "Productos" en el desplegable.

En el segundo bloque, "Selecciona tu archivo CSV", haz clic en "Subir archivo" y selecciona tu CSV desde tu ordenador. También verás una opción para elegir el "Separador de campos". El más común es la coma (,), pero si usas Excel en español, es probable que tu archivo use punto y coma (;). PrestaShop suele detectarlo automáticamente, pero si ves errores en el siguiente paso, vuelve aquí y cámbialo.

Paso 3: Mapear las columnas (El corazón de la importación)

Este es el paso donde le dices a PrestaShop qué significa cada columna de tu archivo. Es fundamental para importar CSV PrestaShop correctamente.

Después de subir el archivo, haz clic en "Siguiente". Verás una tabla con dos columnas:

• Columna de tu archivo: Muestra los encabezados que has puesto en tu CSV (ej. nombre, precio).
• Columna de destino: Un desplegable con todos los campos que PrestaShop puede rellenar (ej. Nombre, Precio de venta).

Aquí debes hacer la correspondencia manualmente. Por ejemplo:

• Si tu columna se llama name, en el desplegable de destino selecciona "Nombre".
• Si tu columna se llama price, selecciona "Precio de venta".
• Si tu columna se llama quantity, selecciona "Cantidad".

Consejo profesional: PrestaShop intenta adivinar la correspondencia automáticamente, pero siempre debes revisarla. Un error común es que tu columna descripcion_corta se asigne a Descripción (la larga) en lugar de Resumen.

¿Qué pasa con las columnas que no quiero importar?

Si tu CSV tiene una columna que no necesitas (ej. notas_internas), simplemente deja el desplegable de destino en "Ignorar esta columna". Es una opción que aparece al final de la lista.

Paso 4: Configura las opciones avanzadas y ejecuta la importación

Una vez que has mapeado todas las columnas, haz clic en "Siguiente". Ahora verás una pantalla con opciones avanzadas. Te explico las más importantes:

• Actualizar los productos existentes: Si marcas esta casilla, PrestaShop actualizará los productos que ya existen (coincidiendo por id o referencia). Si la dejas desmarcada, intentará crear duplicados o dará error.
• Eliminar todos los productos antes de importar: ¡CUIDADO! Esta opción borra todo tu catálogo antes de importar. Solo úsala si estás seguro de que quieres empezar de cero.
• Usar el campo de referencia como clave de búsqueda: Te recomiendo activar esta opción. Así, si un producto ya tiene esa referencia, lo actualizará en lugar de crear uno nuevo.

Finalmente, haz clic en el botón "Importar" (o "Siguiente" dependiendo de la versión).

El proceso de importación

PrestaShop procesará el archivo en lotes. Verás una barra de progreso. Si el archivo es muy grande, puede tardar varios minutos. No cierres la pestaña del navegador durante este proceso.

Paso 5: Verifica los resultados y soluciona errores comunes

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

Errores frecuentes y cómo solucionarlos

• "Error: No se pudo guardar el producto": Esto suele deberse a que falta un campo obligatorio (como el nombre) o que el formato de un campo es incorrecto (ej. precio con texto). Revisa tu CSV.
• "El campo id no es válido": Asegúrate de que la columna id solo contenga números enteros o esté vacía.
• "Producto duplicado": Si no usaste la referencia como clave y el nombre se repite, PrestaShop puede crear duplicados. Usa la opción de actualizar por referencia.
• Acentos y caracteres raros: Si ves é en lugar de é, es un problema de codificación. Guarda tu CSV con codificación UTF-8. En Excel, al guardar como CSV, elige "CSV UTF-8 (delimitado por comas)".

[WARNING] Si tu archivo es enorme (más de 10,000 productos), puede que el servidor se quede sin memoria. Si tienes acceso a Syspanel (el panel de control con puerto 2106), puedes aumentar el memory_limit de PHP temporalmente. Si no, divide tu CSV en varios archivos más pequeños (ej. 5,000 productos cada uno).

Consejos avanzados para una importación perfecta

Importar imágenes desde un archivo CSV

¿Quieres importar también las fotos de tus productos? Es posible. En tu CSV, añade una columna llamada image_url y en cada fila pon la URL completa de la imagen (ej. https://tudominio.com/imagenes/camiseta.jpg). PrestaShop descargará y asociará esa imagen al producto.

Si tienes varias imágenes, puedes poner varias URLs separadas por coma (ej. url1.jpg,url2.jpg). Es importante que las URLs sean accesibles públicamente.

Usar categorías y atributos

Para asignar un producto a una categoría, necesitas la columna categorías. El formato es el siguiente: Categoría Principal > Subcategoría > Subsubcategoría. Por ejemplo: Ropa > Camisetas > Manga Corta. PrestaShop creará la jerarquía automáticamente si no existe.

Para atributos (tallas, colores), la cosa se complica un poco. Necesitas usar columnas con nombres específicos como Talla o Color y el formato interno es algo como Talla: S, M, L. Te recomiendo que, para las primeras importaciones, te centres solo en los datos básicos y dejes los atributos para una segunda fase.

Preguntas Frecuentes (FAQ)

¿Puedo importar productos desde un archivo CSV de otra plataforma (como WooCommerce)?

Sí, pero tendrás que adaptar las columnas. Lo más fácil es exportar tu CSV de la otra plataforma, abrirlo en Excel y renombrar las columnas para que coincidan con las de PrestaShop. El mapeo del paso 3 es tu mejor amigo aquí.

¿Qué hago si mi importación falla a mitad de camino?

No pasa nada. PrestaShop es transaccional en lotes. Los productos que ya se importaron en los primeros lotes se guardarán. Corrige el error en tu CSV y vuelve a importar. Si usas la referencia como clave, los que ya están se actualizarán y los nuevos se añadirán.

¿Es necesario tener conocimientos de programación?

Para nada. Con saber usar Excel y seguir los pasos de esta guía, es más que suficiente. La herramienta de importación está diseñada para ser usada por cualquier persona.

¿Puedo programar importaciones automáticas periódicas?

PrestaShop no tiene una opción nativa para programarlas, pero puedes usar módulos de terceros o, si tienes acceso a Syspanel (puerto 2106), puedes programar una tarea Cron que ejecute un script con la URL de importación. Eso ya es un nivel más avanzado.

¿Qué pasa con los precios con impuestos?

En el CSV, la columna price se refiere al precio sin impuestos. Si solo tienes el precio con IVA, deberás calcular el precio base antes de importar. Por ejemplo, si el precio final es 121€ y el IVA es del 21%, el precio sin impuestos es 100€ (121 / 1.21).

Conclusión: Domina la importación y ahorra tiempo

Cargar productos PrestaShop mediante CSV es, sin duda, la habilidad más valiosa que puedes aprender para gestionar tu tienda de forma eficiente. Una vez que le coges el truco al formato y al mapeo, podrás actualizar precios, stocks y crear catálogos completos en minutos en lugar de días.

Recuerda siempre estos tres pilares:

1. Prepara bien tu CSV: Usa la plantilla de ejemplo y revisa la codificación.
2. Mapea correctamente: Tómate tu tiempo en el paso 3. Es donde se cometen los errores.
3. Prueba con un archivo pequeño: Antes de importar los 5,000 productos, haz una prueba con 5 para verificar que todo funciona.

[TIP] Guarda siempre una copia de tu archivo CSV original y de la configuración de mapeo. Si algo sale mal, puedes revertir los cambios fácilmente.

Con esta guía, ya tienes todo lo necesario para convertirte en un experto en la importación de productos. ¡Tu catálogo se llenará de productos sin despeinarte! Si te surge cualquier duda, no dudes en consultar la documentación oficial de PrestaShop o contactar con tu proveedor de hosting.