Importar CSV PrestaShop: límites y la alternativa correcta | PropulseCom Tools

Gestionas un catálogo PrestaShop de varios cientos de productos o más, y acabas de descubrir los límites de la importación CSV nativa. El archivo se interrumpe a mitad con un error 500. Los precios no se actualizan. Las combinaciones quedan desordenadas. O todo a la vez, un viernes por la noche antes de una promoción.

Este artículo es para ti si:

Tu catálogo supera las 200 referencias
Tienes varios proveedores con sus propios formatos de archivo
Necesitas sincronizar stock, precios o fichas de producto más de una vez por semana
Gestionas varias tiendas o varios idiomas

Si importas 30 productos una vez al año, la herramienta nativa de PrestaShop te basta. Para todo lo demás, sigue leyendo.

Qué hace la herramienta de importación CSV nativa de PrestaShop

Formato esperado y columnas reconocidas

La herramienta de importación nativa es accesible desde el panel de administración de PrestaShop en Parámetros avanzados > Importar (o Catálogo > Importar según tu versión). Acepta archivos .csv y, desde la versión 1.7, también .xls, .xlsx y .ods.

Para la importación de productos, las columnas reconocidas por el motor nativo incluyen:

Columna	Descripción
`ID`	Identificador PrestaShop (opcional — déjalo vacío para crear)
`Active (0/1)`	Producto activo o no
`Name *`	Nombre del producto (obligatorio)
`Categories (x,y,z...)`	Categorías separadas por comas
`Price tax excl.`	Precio sin impuestos
`Tax rules ID`	Identificador de la regla de impuestos
`Wholesale price`	Precio de compra (coste de proveedor)
`Reference #`	Referencia interna
`EAN13`	Código de barras EAN-13
`Quantity`	Stock disponible
`Description`	Descripción larga
`Short description`	Descripción corta
`Meta title`	Etiqueta title para SEO
`Meta description`	Meta descripción para SEO
`Image URLs (x,y,z...)`	URLs de imágenes, separadas por comas
`Combinations`	Combinaciones (atributos/valores)
`Available for order (0/1)`	Producto disponible para compra

Nota técnica: los nombres exactos de las columnas varían ligeramente según la versión de PrestaShop (1.6, 1.7, 8.x) y el idioma del panel de administración. El back office muestra la lista de columnas disponibles en un panel lateral al configurar la importación — ese panel es la referencia definitiva.

El separador por defecto es el punto y coma ;. El separador de valores múltiples (varias categorías, varias imágenes) es la coma ,. La codificación esperada es UTF-8 sin BOM.

Cómo ejecutar una importación

La importación se ejecuta de forma síncrona desde el navegador: cargas el archivo, mapeas las columnas, lanzas la importación y el back office espera a que termine el procesamiento. Sin proceso en segundo plano, sin posibilidad de reanudación si la red se cae. Si el procesamiento supera el timeout PHP (habitualmente 30 o 60 segundos según la configuración del servidor), la importación se detiene a mitad sin rollback.

Los 6 límites concretos de la importación CSV PrestaShop

1. Timeout y caídas en volúmenes grandes

La importación nativa está diseñada para volúmenes modestos. En la práctica, los foros de PrestaShop documentan errores 500 o timeouts a partir de unos pocos cientos de filas, y a veces antes si los productos incluyen imágenes que hay que descargar. ¿Un catálogo de 5.000 referencias con imágenes remotas? La importación falla antes de llegar a la mitad. No existe mecanismo de reanudación: empiezas de cero, o divides el archivo en lotes de 200 filas y lo repites manualmente.

2. Codificación y separadores: la lotería del UTF-8

Un archivo CSV exportado desde Excel en Windows suele llegar en Windows-1252 (Latin-1) o en UTF-8 con BOM. PrestaShop espera UTF-8 sin BOM. Resultado: los caracteres acentuados (é, ç, ô) se muestran como Ã©, Ã§, Ã´ en tu catálogo. La depuración consume fácilmente dos horas para un problema que una validación de codificación previa resolvería en dos segundos.

Lo mismo ocurre con los separadores: si tu proveedor entrega un archivo con comas como separadores y punto y comas en las descripciones, la importación falla sin un mensaje de error claro.

3. Sin rollback ni idempotencia

La importación nativa no es idempotente: si importas el mismo archivo dos veces, creas duplicados o sobreescribes datos existentes según la opción seleccionada. No hay verificación de coherencia antes de importar: si tu CSV referencia una categoría que aún no existe, el producto se importa sin esa categoría — en silencio, sin aviso.

En caso de importación parcial por un timeout, los productos procesados antes de la interrupción están en la base de datos, los demás no. Tu catálogo queda en un estado intermedio indeterminado.

4. Combinaciones: el caso más frágil

Importar combinaciones de productos en CSV nativo PrestaShop es técnicamente posible, pero de una fragilidad notable. Los atributos (talla, color) y sus valores deben existir previamente en tu back office. El formato del CSV de combinaciones es diferente al CSV de productos: requiere dos pasadas. Una correspondencia incorrecta entre los IDs de atributos y los valores del CSV genera combinaciones huérfanas o combinaciones incorrectas que corrompen el catálogo en silencio.

5. Cero monitoreo, sin registros útiles

La interfaz de importación muestra un resumen tras el procesamiento: “X productos importados, Y errores.” Sin número de línea, sin traza con fecha y hora, sin exportación del informe. Si 47 productos de 800 han fallado, no sabes cuáles ni por qué sin buscarlos manualmente.

6. Frecuencia y contenido: dos límites en uno

La herramienta nativa no tiene planificación — cada importación es manual. Pero el límite más estructural no es la frecuencia: es el contenido. El CSV del proveedor transporta lo que el proveedor ha escrito. No tus descripciones, no tu tono editorial, no tus palabras clave SEO, no tus traducciones. Para un catálogo serio, la importación CSV es solo la mitad del trabajo — la otra mitad sigue siendo completamente manual.

Qué aporta la automatización externa

Sincronización en tiempo real vía la API REST de PrestaShop

PrestaShop expone una API REST (antes llamada «Webservices») que permite crear, leer, modificar y eliminar recursos — productos, stock, precios, pedidos, clientes — sin pasar por la interfaz gráfica. Una solución de automatización externa como PropulseCom utiliza esta API para enviar los datos directamente a la base de datos, producto a producto o en lotes, sin bloquear el back office.

La diferencia clave con el CSV: la API permite operaciones granulares y precisas. En lugar de reimportar un archivo de 2.000 filas para cambiar 15 precios, una llamada API actualiza únicamente esos 15 productos en unos segundos. El back office permanece utilizable durante toda la sincronización.

PropulseCom se conecta a tu tienda validando tu clave API PrestaShop y luego sincroniza automáticamente tus categorías, idiomas, atributos y características — sin volver a introducir datos manualmente.

Idempotencia y gestión de duplicados

Una automatización bien construida es idempotente: ejecutar la sincronización dos veces con los mismos datos produce el mismo resultado que una sola ejecución. La lógica de deduplicación se apoya en un identificador único estable — la referencia del producto, el EAN13 o el ID de PrestaShop — para decidir si crear o actualizar. Sin duplicados, sin pérdida de datos existentes no afectados por la actualización.

Flujo de errores y observabilidad

Cuando un producto falla durante una sincronización automatizada, ocurren varias cosas que el módulo nativo no hace:

El error queda registrado con su causa exacta (imagen inaccesible, referencia duplicada, categoría ausente)
El producto fallido entra en reintento automático sin bloquear los productos siguientes
Todas las operaciones quedan registradas con fecha y hora, ID del producto, acción realizada y resultado
El progreso se actualiza en tiempo real en la interfaz, sin necesidad de recargar la página

Tras generar 3.000 productos, sabes exactamente qué se ha creado, qué se ha actualizado y qué ha fallado — y por qué.

Casos de uso concretos

Análisis del catálogo del proveedor: nuevos, existentes y ausentes

Este suele ser el primer problema operativo cuando un proveedor envía su catálogo actualizado: ¿cómo saber qué ha cambiado? PropulseCom incorpora un módulo de análisis de catálogo de proveedor que compara automáticamente el archivo entregado con el estado real de tu tienda vía la API PrestaShop.

El resultado se clasifica en tres categorías:

Productos nuevos: presentes en el archivo del proveedor, ausentes de tu tienda → importables con un clic
Productos existentes: ya en tu tienda → el módulo muestra las diferencias de precio de compra (delta en € y %) para que decidas si una actualización de precio está justificada
Productos ausentes: en tu tienda, pero no en el archivo del proveedor → el módulo los identifica para que decidas si desactivarlos

El formato de cada proveedor se memoriza tras la primera importación: el mapeo de columnas solo se configura una vez y se reutiliza automáticamente con cada nuevo archivo. En un catálogo de 800 referencias con dos proveedores activos, este análisis reemplaza lo que antes requería 2 o 3 horas de comparación manual en hojas de cálculo.

Generación de fichas de producto con el tono de tu tienda

El CSV del proveedor contiene lo que el proveedor ha escrito: un título de producto, algunas características técnicas, a veces una frase descriptiva genérica. Ese no es tu contenido — y tampoco es contenido SEO.

PropulseCom añade una capa de generación IA entre la importación del CSV y la creación en PrestaShop. Configuras prompts personalizables por campo: descripción corta, descripción larga, meta title, meta descripción, características. Estos prompts definen el tono, el estilo y el vocabulario del sector de tu tienda. La IA genera dentro de ese marco preciso para cada producto del CSV.

Un ejemplo concreto: un distribuidor de material eléctrico configura su prompt de descripción larga para mencionar siempre las normativas CE aplicables, la compatibilidad con las instalaciones existentes y una frase sobre el servicio al cliente. Ese contexto se aplica a cada producto generado, sin que el comerciante tenga que volver a introducirlo. Un modo de prueba sobre 3 productos permite validar la calidad antes de lanzar la generación masiva — accesible directamente desde el generador de fichas de producto.

Multiidioma sin coste adicional

Para las tiendas multiidioma, PropulseCom detecta automáticamente todos los idiomas activos al conectarse a la API PrestaShop. La generación de productos cubre todos los idiomas en una sola pasada: 1 crédito = 1 producto, todos los idiomas incluidos. Sin configuración adicional, sin pasada separada por idioma, sin que el coste se multiplique por el número de idiomas.

Más allá del texto: reconocimiento de imágenes y descripciones enriquecibles

Visión IA sobre las imágenes de producto

El CSV de un proveedor suele contener URLs de imágenes. Lo que la importación nativa hace con esas URLs: descargar los archivos y adjuntarlos a los productos. Lo que no hace: verificar que esas imágenes sean utilizables.

PropulseCom incluye un análisis IA de las imágenes de producto antes de la publicación. Para cada visual proporcionado, la visión IA detecta:

Marcas de agua: imágenes marcadas por el proveedor o un socio, no utilizables tal cual en tu escaparate
Coherencia producto/imagen: ¿la imagen representa realmente el producto listado? Un error de mapeo del proveedor puede asociar la imagen de un cable a un conector, o mostrar dos colores diferentes
Resolución: las imágenes con resolución demasiado baja degradan la experiencia del usuario y la tasa de conversión

Un caso concreto: un proveedor entrega 2.000 productos nuevos con sus imágenes. El análisis IA detecta automáticamente 47 visueles con marca de agua de un socio y 12 imágenes con resolución inferior al mínimo requerido para la visualización en zoom. Sin esta etapa, esos 59 productos se publicarían con imágenes no conformes, descubiertas a través de las reclamaciones de clientes o de una auditoría manual — semanas después.

El análisis se factura en créditos por imagen procesada. No vuelve a analizar todo el catálogo en cada importación: solo se analizan los productos nuevos o modificados desde la última pasada.

Beneficio SEO directo: Google penaliza las imágenes duplicadas, de mala calidad o asociadas a un contenido incoherente. Identificar los problemas antes de la publicación — antes incluso de que Google indexe esas páginas — evita correcciones a posteriori que requieren desindexar, corregir y esperar a que el bot vuelva. El beneficio no es teórico: cada imagen correcta publicada desde el primer pase es potencial de posicionamiento que no hay que reconstruir. Puedes verificar el estado actual de tu tienda con nuestra auditoría SEO de tienda.

Descripciones enriquecibles: un activo editorial que crece con el tiempo

El modelo de PropulseCom no es reemplazar al comerciante, sino proporcionarle una base de calidad que pueda enriquecer. El flujo de trabajo tipo:

CSV bruto del proveedor — título + características técnicas + una frase descriptiva genérica
PropulseCom genera — descripción corta, descripción larga, meta title, meta descripción, características estructuradas, con el tono y el estilo definidos por los prompts configurados
El comerciante recibe en PrestaShop — una ficha ya prerrellenada y editable, a la que puede añadir elementos diferenciadores: opiniones de clientes utilizadas como prueba social, garantías específicas de la tienda, comparativas internas, referencias técnicas locales

Lo que esto cambia frente a una importación CSV clásica: un CSV transporta lo que el proveedor ha escrito. Todos tus competidores que revenden los mismos productos tienen las mismas descripciones. La IA genera contenido único para tu tienda — con tu estilo, tus palabras clave, en todos tus idiomas — lo que resulta crítico para el SEO: Google penaliza sistemáticamente las fichas duplicadas entre revendedores competidores. Nuestra guía SEO de fichas de producto detalla los 6 criterios que marcan la diferencia en este punto.

La ventaja a largo plazo proviene de la persistencia de las plantillas de mapeo. Los prompts se guardan y se recargan de una importación a otra: el tono de la tienda se mantiene coherente entre la primera importación de enero y un nuevo proveedor incorporado en septiembre. El ciclo recomendado: generar en masa → validar sobre 3 productos en el modo de prueba → ajustar los prompts → relanzar. Tras varias iteraciones, el dominio de los prompts se convierte en una ventaja competitiva real frente a los revendedores que publican las descripciones del proveedor sin modificación.

Tabla comparativa: CSV nativo vs Módulo Addons vs PropulseCom

Criterio	CSV nativo PrestaShop	Módulo Addons (p. ej. Sitolog, Store Commander)	PropulseCom
Volumen soportado	< 500 productos de forma fiable	Hasta varias decenas de miles	Ilimitado, división automática en lotes
Gestión de errores	Informe resumido, sin reintento	Variable según módulo	Captura por producto, reintento automático, registros con fecha y hora
Idempotencia	No	Parcial	Sí — deduplicación por referencia/EAN
Plantillas de mapeo reutilizables	No	Según módulo	Sí — guardadas y recargadas entre importaciones
Generación IA de descripciones	No	No	Sí — prompts personalizables por campo
Modo de prueba (3 productos antes del lanzamiento masivo)	No	No	Sí
Multiidioma automático	No (una pasada por idioma)	Según módulo	Sí — 1 crédito = 1 producto, todos los idiomas incluidos
Visión IA sobre imágenes	No	No	Sí — marcas de agua, coherencia, resolución
Análisis catálogo proveedor	No	No	Sí — nuevos / existentes / ausentes + delta de precio
Créditos prepago	N/A	Licencia anual	Sí — 100 créditos gratis al registrarse
Intervención humana	En cada importación	Configuración inicial + supervisión	Configuración inicial + validación de calidad

Nota sobre el TCO: el coste aparente de 0 € del CSV nativo no tiene en cuenta el tiempo del operador. En un catálogo sincronizado dos veces por semana, 1 o 2 horas por operación representan entre 100 y 200 horas al año. A un coste horario de 30 €/h (salario cargado de un empleado de e-commerce), eso supone entre 3.000 y 6.000 €/año en costes ocultos — sin contar el tiempo dedicado a corregir errores de importación y fichas de producto vacías.

FAQ

¿Por qué la importación CSV de PrestaShop falla con un archivo de 500 productos?

La importación nativa se ejecuta de forma síncrona en el hilo PHP del back office. Si el procesamiento supera el timeout configurado en el servidor (habitualmente entre 30 y 60 segundos), PHP detiene la ejecución sin rollback. En un alojamiento compartido o un VPS limitado, 500 productos con imágenes remotas que descargar pueden superar fácilmente ese umbral. La solución nativa consiste en dividir el archivo en lotes — lo que no resuelve el problema, simplemente lo desplaza.

¿Cuál es la diferencia entre un módulo de importación CSV y una sincronización por API?

Un módulo de importación CSV se mantiene en la misma lógica que el nativo: procesa un archivo, a menudo con mejor rendimiento y mejor reporte, pero la fuente de datos sigue siendo un archivo batch. Una sincronización por API es granular: los datos se leen desde cualquier fuente (CSV de proveedor, feed) y se envían directamente a los endpoints REST de PrestaShop, producto a producto. Las reglas de negocio se aplican en el flujo, no en el preprocesamiento.

¿Cómo actualizar los precios de PrestaShop automáticamente desde un archivo de proveedor?

PropulseCom lee el precio de compra desde el archivo del proveedor (wholesale_price) durante el mapeo CSV y lo escribe directamente en PrestaShop vía la API. El precio de venta queda bajo tu control: defines tu regla de margen en la configuración, y la automatización aplica la misma lógica en cada importación sin intervención manual.

¿Se pueden importar combinaciones de productos en CSV en PrestaShop?

Sí, pero en la interfaz nativa es una operación en dos pasos: primero la importación de los productos, luego la importación de las combinaciones en un archivo separado. Los atributos y valores deben existir previamente en el back office. En la práctica, el mínimo desajuste entre los dos archivos genera combinaciones huérfanas difíciles de depurar. PropulseCom sincroniza los atributos y características de tu tienda desde el momento de la conexión, lo que garantiza la coherencia entre el mapeo CSV y los datos reales de PrestaShop.

¿Qué frecuencia de sincronización es posible con la API de PrestaShop?

La API de PrestaShop no impone un límite de tasa documentado, pero el servidor que aloja tu tienda es el factor limitante real. En la práctica, el volumen de generación depende del tamaño del catálogo y de los créditos disponibles. Para actualizaciones puntuales de precios o stock vía la API, las operaciones dirigidas se completan en pocos segundos sin impactar el rendimiento de la tienda.

¿Cómo puede la IA generar contenido único cuando mis competidores venden los mismos productos?

Porque el contenido generado no es la descripción del proveedor reformateada — es una creación dentro del marco preciso que tú has definido. Los prompts personalizables de PropulseCom permiten inyectar tu tono, tu vocabulario del sector y tus ángulos diferenciadores (servicio, experiencia, garantías) en cada ficha. Dos revendedores que importen el mismo archivo de proveedor obtendrán descripciones estructuralmente distintas si sus prompts son diferentes.

El otro palanca es el multiidioma: PropulseCom genera en todos tus idiomas activos en una sola pasada, al mismo coste (1 crédito por producto). Fichas completas en todos los idiomas = más páginas indexables y mayor superficie SEO frente a un competidor que se ha quedado en un único idioma.

Da el salto a la automatización

Si tu catálogo cambia más de una vez por semana, si tienes varios proveedores con sus propios formatos, o si pierdes tiempo reformateando archivos CSV en Excel antes de cada importación — esa es la señal de que la herramienta nativa te cuesta más de lo que te ahorra.

PropulseCom conecta tus fuentes de datos a PrestaShop vía la API, genera descripciones con tu tono, cubre todos tus idiomas y analiza tus imágenes antes de la publicación. Las primeras fichas se generan con 100 créditos gratuitos al registrarte — sin tarjeta de crédito.

Prueba PropulseCom gratis en tu catálogo

Para ir más lejos: