Importar CSV WooCommerce: límites del nativo y sincronización vía API
El importador CSV nativo de WooCommerce funciona para 50 productos. Más allá, la sincronización por REST API evita timeouts, variaciones rotas y fichas duplicadas.
Gestionas una tienda WooCommerce con algunos cientos de productos y la importación CSV nativa empieza a mostrar sus límites. Tus variaciones se importan mal, PHP se detiene a mitad de camino con un timeout, algunas filas no pasan, y tus descripciones son idénticas a las de tres competidores que revenden el mismo catálogo de proveedor.
Este artículo es para ti si:
- Tu catálogo WooCommerce supera los 200 productos o varios cientos de variaciones
- Trabajas con varios proveedores con sus propios formatos de archivo
- Sincronizas stock, precios o fichas de producto más de una vez por semana
- Gestionas varios idiomas (WPML, Polylang) o varias tiendas
Para una importación puntual de 30 productos al año, la herramienta nativa de WooCommerce es perfectamente válida. Para todo lo demás, sigue leyendo.
Lo que hace el importador CSV nativo de WooCommerce
Formato esperado y columnas reconocidas
Desde WooCommerce 3.1, un importador CSV está integrado: Productos > Importar. Acepta archivos .csv en UTF-8 con coma por defecto (separador configurable). El mapping de columnas es interactivo — WooCommerce detecta automáticamente los nombres estándar y ofrece mapping manual para las columnas desconocidas.
Las principales columnas esperadas:
| Columna | Descripción |
|---|---|
ID | Identificador WooCommerce (vacío = creación) |
Type | simple, variable, variation, grouped, external |
SKU | Referencia única |
Name | Nombre del producto (obligatorio) |
Published | 1 publicado, 0 borrador, -1 papelera |
Featured | Producto destacado |
Short description | Descripción corta (HTML) |
Description | Descripción larga (HTML) |
Tax status / Tax class | Configuración IVA |
In stock? / Stock | Disponibilidad y cantidad |
Regular price / Sale price | Precio normal y rebajado |
Categories | Categorías separadas por > para jerarquía, , para múltiples |
Tags | Etiquetas separadas por coma |
Images | URLs separadas por coma (1ª imagen = imagen principal) |
Attribute 1 name / Attribute 1 value(s) | Atributo + valores para variaciones |
Parent | ID padre para las variaciones |
Meta: _yoast_wpseo_title | Title SEO (con Yoast) |
Meta: _yoast_wpseo_metadesc | Meta description SEO (con Yoast) |
Nota técnica: las variaciones se importan como filas separadas con Type=variation y Parent=ID_del_producto_variable. En un catálogo de 800 productos con el 60% en variable y un promedio de 6 variaciones, el CSV supera fácilmente las 3.500 filas.
Cómo lanzar una importación
La importación se ejecuta del lado del servidor en segundo plano, con una barra de progreso en el Admin WordPress. El proceso depende del PHP del servidor (timeout, memoria) y del número de hooks WooCommerce/WordPress activos (cada plugin añade trabajo a cada producto creado). Un sitio con 30 plugins activos no importa a la misma velocidad que un sitio vainilla.
Los 6 límites concretos del importador CSV de WooCommerce
1. Timeout PHP y límite de memoria
El límite más frecuente. Un alojamiento compartido con max_execution_time a 30s y memory_limit a 256 MB se detiene en algunos cientos de productos, especialmente si cada producto tiene 4–6 imágenes a descargar. WooCommerce procesa por lotes, pero la ausencia de una cola persistente significa que una interrupción (cierre de pestaña, pérdida de sesión WordPress) deja la importación en suspenso sin reintento limpio.
2. Variaciones: el árbol padre/hijo frágil
Una variación huérfana (Parent apuntando a un ID inexistente o aún no creado en la misma importación) queda en la base de datos sin ser vinculada — invisible del lado tienda, visible solo pasando por el backend. WooCommerce no alerta sobre estos huérfanos. Peor: si renombras un atributo sin reimportar las variaciones, los valores de atributo existentes se conservan sin correspondencia, creando “celdas muertas” en los selectores de variantes.
3. Codificación y separadores
WooCommerce acepta UTF-8 y ofrece elección del separador, pero un archivo exportado desde Excel en Windows llega a menudo en Windows-1252 (Latin-1) o UTF-8 BOM. Los caracteres acentuados se muestran como é, ç, ô del lado tienda. El debugging consume fácilmente dos horas por un problema que una validación de codificación aguas arriba resolvería en dos segundos.
4. Conflictos con plugins SEO y compatibilidad de meta-campos
Las columnas Meta: permiten importar los campos Yoast/Rank Math/AIO SEO, pero la sintaxis difiere según el plugin y la versión. Un cambio de plugin SEO en la tienda exige retrabajar el CSV. Los campos meta personalizados (ACF, atributos de tema) deben importarse fila por fila con nomenclatura exacta.
5. Reporting mínimo
WooCommerce muestra al final de la importación: “X productos importados, Y errores”. El detalle de errores es consultable pero no se exporta en CSV utilizable. Diagnosticar por qué 47 productos fallaron sobre 800 requiere volver manualmente a cada uno.
6. Contenido = lo que el proveedor escribió
Es el límite más estructural. El CSV transporta el título, la descripción y las características del proveedor. No tu tono, no tus palabras clave SEO, no tus traducciones (WPML/Polylang requieren una importación separada por idioma). Tus competidores que revenden el mismo catálogo tienen la misma descripción. Google penaliza sistemáticamente las fichas duplicadas entre revendedores en competencia.
Lo que aporta una automatización externa vía REST API
Sincronización granular por producto
WooCommerce expone una REST API (/wp-json/wc/v3/products) que permite crear, leer, modificar y eliminar cada recurso (producto, variación, imagen, stock, precio) sin pasar por CSV. Una solución como PropulseCom usa esta API para enviar únicamente los cambios pertinentes — modificar 15 precios requiere 15 llamadas API, no la reimportación de un archivo de 3.500 filas. El back-office WordPress sigue utilizable durante la sincronización.
PropulseCom se conecta a tu tienda vía la creación de una clave API REST en WooCommerce > Ajustes > Avanzado > REST API, luego lee automáticamente tus categorías, atributos, taxonomías WordPress e idiomas activos (si WPML/Polylang) — sin reintroducir datos.
Idempotencia y gestión de duplicados
Una sincronización bien diseñada es idempotente: el mismo dato enviado dos veces produce el mismo resultado. La deduplicación se apoya en un identificador estable — SKU, EAN o ID WooCommerce — para decidir crear o actualizar. Sin productos fantasma, sin variaciones duplicadas, sin pérdida de metadatos existentes no relacionados con la actualización.
Flujo de errores y observabilidad
Para cada producto enviado, la API devuelve el detalle del éxito o fracaso:
- El error se captura con su causa (imagen inaccesible, SKU duplicado, atributo faltante, categoría inexistente)
- El producto en error pasa a reintento automático sin bloquear el resto
- Todas las operaciones se registran con timestamp, ID WooCommerce, acción y resultado
- El seguimiento avanza en tiempo real en la interfaz PropulseCom
Después de generar 3.000 productos, sabes exactamente qué se creó, qué se actualizó y qué falló — y por qué.
Casos de uso concretos
Análisis del catálogo del proveedor: nuevos, existentes, faltantes
A cada nuevo archivo de proveedor, PropulseCom compara automáticamente el CSV entregado con el estado real de tu catálogo WooCommerce vía la REST API:
- Nuevos productos: presentes en el archivo, ausentes de la tienda → importables en un clic
- Productos existentes: ya en base de datos → el módulo muestra las diferencias de precio de compra (delta en € y %) para validar las actualizaciones
- Productos faltantes: en la tienda, ausentes del archivo → identificados para decidir su desactivación
El mapping de columnas de cada proveedor se memoriza en la primera importación y se reutiliza automáticamente en cada entrega siguiente.
Generación de fichas de producto en el tono de la tienda
PropulseCom añade una capa de generación IA entre la importación CSV y la creación en WooCommerce. Configuras prompts personalizables por campo: título, descripción corta, descripción larga, meta title Yoast, meta description Yoast, etiquetas. Estos prompts codifican el tono, vocabulario y ángulos diferenciadores de tu marca. La IA genera luego en este marco preciso para cada producto del archivo del proveedor.
Un modo test sobre 3 productos permite validar la calidad antes de lanzar la generación en masa — accesible directamente vía el generador de fichas de producto.
Multilingüe (WPML / Polylang) sin sobrecoste
Si usas WPML o Polylang para gestionar varios idiomas, PropulseCom detecta automáticamente todos los idiomas activos al conectarse y genera el contenido en cada uno en una sola pasada: 1 crédito = 1 producto, todos los idiomas incluidos. Los productos traducidos se crean y vinculan a su versión original vía los meta-campos WPML/Polylang, sin configuración adicional.
Más allá del texto: reconocimiento de imágenes y descripciones enriquecibles
Vision IA sobre imágenes de producto
Un CSV de proveedor suele contener URLs de imágenes. La importación nativa WooCommerce las descarga y adjunta vía la biblioteca de medios WordPress — sin verificar que sean utilizables. PropulseCom analiza cada visual antes de la publicación y detecta:
- Marcas de agua del proveedor o partner, no utilizables en escaparate
- Coherencia producto/imagen: ¿la imagen representa realmente el producto listado?
- Resolución: las imágenes demasiado bajas degradan la experiencia zoom y la tasa de conversión
En 2.000 nuevos productos entregados, el análisis IA marca automáticamente los visuales no conformes antes de la publicación — evitando devoluciones de clientes y una auditoría manual semanas después. Beneficio SEO: Google penaliza las imágenes duplicadas entre revendedores y las imágenes de mala calidad. Identificar problemas en origen evita correcciones a posteriori que requieren desindexación y nuevo paso del bot. Puedes verificar el estado actual de tu tienda con nuestra auditoría SEO de tienda.
Descripciones enriquecibles: un activo editorial que se construye en el tiempo
El workflow típico:
- CSV bruto del proveedor — título + características + una frase descriptiva genérica
- PropulseCom genera — descripción corta, descripción larga, meta title, meta description, etiquetas, en el tono definido por tus prompts
- Recibes en WooCommerce — una ficha pre-rellenada, editable, a la que añades tus elementos diferenciadores (reseñas de clientes, garantías específicas, comparativos internos)
La IA genera contenido único a tu tienda — en tu estilo, tus palabras clave, todos tus idiomas. Nuestra guía SEO de fichas de producto detalla los 6 criterios que marcan la diferencia frente a un competidor que revende los mismos productos.
Tabla comparativa: CSV nativo vs WP All Import vs PropulseCom
| Criterio | CSV nativo WooCommerce | WP All Import Pro | PropulseCom |
|---|---|---|---|
| Volumen soportado | Limitado por PHP timeout / memoria | Decenas de miles (con cron) | Ilimitado, batch automático |
| Gestión de errores | Resumen al final | Log detallado, reintento manual | Captura por producto, reintento auto, logs con timestamp |
| Idempotencia | Parcial (según opción) | Sí | Sí — dedup por SKU/EAN/ID |
| Templates de mapping reutilizables | Limitado (mapping interactivo) | Sí (importación planificable) | Sí — guardado + recarga |
| Generación IA de descripciones | No | No | Sí — prompts personalizables por campo |
| Modo test (3 productos antes de masa) | No | No | Sí |
| Multilingüe automático (WPML/Polylang) | No (1 pasada por idioma) | Add-on pagado separado | Sí — 1 crédito = 1 producto todos los idiomas |
| Vision IA sobre imágenes | No | No | Sí — marca de agua, coherencia, resolución |
| Análisis catálogo proveedor | No | No | Sí — nuevos / existentes / faltantes + delta precio |
| Créditos prepagados | N/A | Licencia anual (~99–199 $/año + add-ons) | Sí — 100 créditos al registrarse |
| Intervención humana | En cada importación | Configuración + supervisión | Configuración inicial + validación de calidad |
Nota sobre el TCO: el coste aparente de 0 € del CSV nativo no contempla el tiempo de operador. En un catálogo sincronizado dos veces por semana, 1 a 2 horas por operación = 100 a 200 horas/año. A un coste horario de 30 € (coste cargado de un empleado e-commerce), son 3.000 a 6.000 €/año de coste oculto — sin contar las correcciones de errores de importación y las fichas incompletas.
FAQ
¿Por qué la importación CSV WooCommerce falla con un archivo de 500 productos?
La importación nativa se ejecuta en el thread PHP del back-office WordPress. Si el procesamiento supera max_execution_time (a menudo 30 a 60s) o memory_limit (a menudo 256 MB), PHP detiene la ejecución sin rollback. En un alojamiento compartido, 500 productos con imágenes remotas y 30 plugins activos superan fácilmente estos umbrales. La solución nativa consiste en dividir el archivo en lotes — lo que no resuelve el problema, lo desplaza.
¿Cuál es la diferencia entre WP All Import y una sincronización por REST API?
WP All Import se mantiene en la lógica de archivo: mejora el formato, mapping y reporting, ofrece importaciones planificadas, pero sigue procesando un archivo batch. La sincronización por REST API es granular — los datos se leen desde cualquier fuente (CSV proveedor, feed, base interna) y se envían directamente a los endpoints /wp-json/wc/v3/ de WooCommerce, producto por producto. Las reglas de negocio se aplican en el flujo, no en preprocesamiento.
¿Cómo actualizar los precios WooCommerce automáticamente desde un archivo de proveedor?
PropulseCom lee el precio de compra del archivo del proveedor durante el mapping, aplica tu regla de margen (configurada una vez), y escribe el regular_price en WooCommerce vía la REST API. La misma lógica se reaplica en cada entrega del proveedor sin intervención manual. El sale_price se mantiene bajo tu control en WooCommerce — la automatización no toca las promociones activas.
¿Se pueden importar variaciones complejas (3 ejes) en CSV WooCommerce?
Sí, hasta 3 atributos con valores múltiples. Pero cada variación = una fila CSV apuntando al producto padre vía la columna Parent. Un producto con 5 colores × 4 tallas × 2 materiales ocupa 40 filas hijo. La fragilidad viene de la consistencia absoluta entre nombres de atributos, valores y filas padre — un solo desvío de nomenclatura crea variaciones huérfanas. PropulseCom genera el mapping de variaciones desde tus atributos origen y garantiza la consistencia de las combinaciones.
¿Qué frecuencia de sincronización es posible con la REST API de WooCommerce?
La REST API WooCommerce no impone cuota documentada, pero el servidor que aloja la tienda es el verdadero factor limitante. PropulseCom respeta automáticamente el caudal que puede absorber tu alojamiento con backoff y reintento — la frecuencia práctica está limitada por tu número de créditos y la potencia de tu alojamiento, no por WooCommerce.
¿Cómo puede la IA generar contenido único cuando mis competidores revenden los mismos productos?
Porque el contenido generado no es la descripción del proveedor reformateada — es una creación dentro del marco preciso que has definido. Los prompts personalizables permiten inyectar tu tono, vocabulario y ángulos diferenciadores (servicio, experiencia, garantías) en cada ficha. Dos revendedores importando el mismo archivo obtendrán descripciones estructuralmente diferentes si sus prompts difieren. Palanca adicional con WPML/Polylang: PropulseCom genera en todos tus idiomas activos en una sola pasada, al mismo coste (1 crédito / producto). Más páginas indexables = más superficie SEO frente a un competidor monolingüe.
Pasa a la automatización
Si tu catálogo WooCommerce evoluciona más de una vez por semana, si tienes varios proveedores con sus propios formatos, o si pierdes tiempo retratando archivos CSV en Excel antes de cada importación — la herramienta nativa te cuesta más de lo que te ahorra.
PropulseCom conecta tus fuentes de datos a WooCommerce vía la REST API, genera descripciones en tu tono, cubre todos tus idiomas (WPML/Polylang), y analiza tus imágenes antes de la publicación. Las primeras fichas se generan con 100 créditos al registrarse — sin tarjeta bancaria.
Probar PropulseCom gratis en tu tienda WooCommerce
Para ir más lejos:
Prueba la herramienta relacionada
Pon en práctica los consejos de este artículo con nuestra herramienta gratuita.
Probar la herramienta gratis