Una importación de productos de WooCommerce que no funciona es casi siempre un problema con el archivo CSV en lugar de con tu tienda. La codificación, las columnas no mapeadas, un enlace padre roto en las filas de variación o un límite del servidor explican la gran mayoría de los fallos, y cada uno tiene una solución específica que puedes comprobar en un par de minutos.
La parte frustrante es lo silenciosamente que falla. WooCommerce a menudo informa de una importación exitosa mientras que la mitad de tus filas no llegaron a ninguna parte, por lo que te quedas adivinando qué etapa se rompió.
Esta guía recorre las causas en el orden en que vale la pena revisarlas, desde el propio archivo hasta conflictos de plugins y límites del servidor, con la solución exacta para cada una. ¡Así que, empecemos!
Tabla de Contenidos
Problemas de formato CSV: la causa más común
Una gran parte de los casos de "la importación no funciona" se remonta al archivo, no a la tienda. Tres detalles causan la mayoría de los fallos silenciosos, y los tres son visibles si abres el CSV en un editor de texto plano en lugar de una aplicación de hoja de cálculo.
- Codificación UTF-8: los archivos guardados desde Excel usan por defecto Windows-1252 o MacRoman, y cada carácter acentuado, símbolo de moneda o comilla inteligente se corrompe. Vuelve a guardar como "CSV UTF-8 (delimitado por comas)", o usa Google Sheets, que exporta UTF-8 por defecto.
- Campos de varios valores sin comillas: una celda que contiene varias categorías o URLs de imágenes necesita comillas dobles a su alrededor. Sin ellas, la coma se lee como un salto de columna y la fila se desmorona.
- Filas de variación sin padre: cada variación necesita una columna "Padre" que contenga el SKU del producto padre. Los valores faltantes o incorrectos hacen que las variaciones se importen como productos simples huérfanos.
Ejecuta esta lista de verificación en el archivo antes de asumir que el problema está en el lado de WooCommerce:
- Ábrelo en un editor de texto plano y busca caracteres garabateados. Que "café" aparezca como "café" confirma un problema de codificación.
- Comprueba que las celdas con varios valores estén entre comillas dobles.
- Para productos variables, confirma que algunas filas de variación hagan referencia al SKU correcto del padre, sin espacios al final.
- Importa de 5 a 10 filas primero. Si esas llegan correctamente, aumenta la escala al archivo completo.
Para el desglose completo de columnas, valores aceptados y reglas de formato, consulta nuestra guía de importación CSV de WooCommerce.
¿Por qué no funciona la importación de productos de WooCommerce?
Una importación de productos de WooCommerce que no funciona se reduce a cuatro causas: el formato del archivo, columnas sin mapear, un plugin que interfiere con la creación del producto o el servidor que acorta el proceso. Trabajar en ellas en ese orden encuentra la causa más rápido, porque las dos primeras son mucho más comunes que las dos últimas.
- Codificación incorrecta o valores sin comillas que contienen comas
- Columnas dejadas en "No importar" durante el mapeo
- Filas de variación que no hacen referencia a su padre
- Tiempos de espera o agotamiento de memoria en archivos grandes
- Conflictos con plugins de caché, seguridad o SEO
- URLs de imágenes a las que el servidor no puede acceder
Empieza con el archivo. Valida el formato y confirma tu mapeo, luego pasa a las comprobaciones del plugin y del servidor si el problema persiste.
¿Qué formato de archivo se requiere para las importaciones de productos de WooCommerce?
WooCommerce importa archivos CSV en codificación UTF-8, y nada más. Otros formatos como XLSX, TSV o JSON deben convertirse primero a CSV, lo que cualquier aplicación de hoja de cálculo hace a través de Guardar como o Descargar.
Vale la pena saberlo: se requieren muchas menos columnas de las que afirman la mayoría de las guías. Solo Nombre es realmente obligatorio, además de Tipo para cualquier cosa que no sea un producto simple. El SKU se genera automáticamente cuando falta, por lo que una columna SKU en blanco no detendrá una importación, aunque te deja sin una clave para futuras actualizaciones.
- ¿Cada fila tiene un Nombre?
- ¿Están los tipos de producto escritos correctamente (
simple,variable,variation)? - ¿Hay espacios al final o caracteres ocultos en las columnas SKU o Padre?
- ¿Hay filas completamente vacías mezcladas en los datos?
¿Por qué faltan columnas en la pantalla de mapeo?
Si los productos se importaron pero sus datos están vacíos, la columna casi con toda seguridad se dejó en “No importar”. WooCommerce muestra una pantalla de Mapeo de Columnas después de la carga, y cualquier cosa que no reconozca se omite por defecto en lugar de intentar adivinarla.
Esto también significa que tus encabezados nunca tuvieron que coincidir con los nombres de WooCommerce. Una columna llamada “Código de Artículo” o “SKU de Producto” se mapea perfectamente desde el desplegable, por lo que renombrar las columnas de tu proveedor es un esfuerzo perdido. Lee la pantalla de mapeo en lugar de hacer clic para pasarla, y configura cualquier columna que realmente quieras.
Las columnas no reconocidas también se pueden enviar a un campo personalizado mapeándolas a una clave meta:, que es como se importan los códigos de proveedor y los precios mayoristas.
¿Qué conflictos de plugins afectan la importación de productos de WooCommerce?
Los plugins que se enganchan a la creación de productos pueden ralentizar una importación hasta casi detenerla o rechazar filas por completo. Las herramientas de caché, seguridad y SEO son los sospechosos habituales, porque cada una ejecuta trabajo adicional cada vez que se guarda un producto.
- Plugins de caché (WP Rocket, W3 Total Cache)
- Plugins de seguridad y firewall (Wordfence)
- Herramientas de SEO que se enganchan a los metadatos del producto
- Otras herramientas de importación y exportación
Prueba en un sitio de staging con los plugins no esenciales desactivados y un tema predeterminado como Twenty Twenty-Four activo. Si la importación se realiza correctamente, reactiva un plugin a la vez hasta que vuelva a fallar.
¿Cómo comprobar los límites de recursos del servidor para las importaciones de productos?
Los catálogos grandes pueden exceder el tiempo de ejecución o la memoria de PHP antes de que finalice la importación, y cuando eso sucede, el proceso se detiene sin un error útil. El manual de PHP establece el max_execution_time predeterminado en 30 segundos a través de un servidor web, lo que unos pocos miles de filas superarán fácilmente.
max_execution_time, aumentado a 300 segundos o más para archivos grandesmemory_limit, con 512 MB como punto de partida razonableupload_max_filesizeypost_max_size, que limitan lo que puedes subir a través del navegador
Estos residen en su configuración de PHP, y el alojamiento compartido a menudo limita lo que puede cambiar. La solución confiable son lotes más pequeños de 500 a 1,000 filas, que evitan los límites por completo.
¿Qué mensajes de error aparecen cuando una importación falla?
WooCommerce informa fallos a nivel de fila en lugar de explicarlos. El resumen de importación le indica cuántas filas se importaron, actualizaron, omitieron y fallaron, y el recuento de fallos es el número que vale la pena leer, porque una importación "exitosa" aún puede haber omitido la mitad de su archivo.
Una barra de progreso estancada sin ningún resumen generalmente significa un tiempo de espera agotado en lugar de un problema de datos. Si no aparece nada en la pantalla, revise el registro de errores de su servidor y confirme que WordPress y WooCommerce estén actualizados.
¿Cómo evitar productos duplicados o faltantes?
Los duplicados casi siempre significan que la casilla de verificación Actualizar productos existentes se dejó desmarcada. Con ella activada, WooCommerce compara cada fila con su catálogo por ID de producto o SKU y actualiza la coincidencia en lugar de crear una segunda copia. Las filas sin coincidencia se omiten en lugar de agregarse.
El síntoma opuesto, productos omitidos silenciosamente cuando esperaba actualizaciones, significa que la casilla estaba marcada pero nada coincidía. Verifique la columna SKU en busca de espacios al final y capitalización inconsistente, ambos comunes en los archivos de proveedores y ambos suficientes para romper una coincidencia.
- Use SKUs únicos en productos y variaciones
- Deje la columna ID fuera a menos que esté actualizando deliberadamente por ID
- Incluya solo las columnas que pretende cambiar en una ejecución de actualización
- Haga una copia de seguridad antes de cualquier actualización, ya que se aplica a su catálogo en vivo de inmediato
¿Qué hacer cuando la importación todavía no se ejecuta?
Si el archivo está limpio y su importación de productos de WooCommerce no funciona, el problema casi siempre es el tamaño. Tres enfoques lo solucionan sin tocar su plan de alojamiento.
- Use una ruta de archivo del servidor. Cargue el CSV a través de FTP, luego abra Opciones avanzadas en la pantalla de importación e ingrese la ruta. El límite de carga del navegador deja de aplicarse por completo.
- Divida el archivo. Lotes de 500 a 1,000 filas terminan bien dentro de cualquier tiempo de espera, y un fallo solo le cuesta un lote.
- Ejecútelo desde la línea de comandos. WP-CLI omite los tiempos de espera del navegador y del servidor web, lo que es adecuado para migraciones únicas muy grandes.
Pruebe todo el proceso en un sitio de staging primero cuando el catálogo sea grande. Una importación que se completa a medias en una tienda en vivo es considerablemente más trabajo para deshacer que una que falla de forma segura en otro lugar.
¿Cómo puedes exportar productos para la resolución de problemas?
Exportar sus productos existentes le da un archivo que WooCommerce ya acepta, lo que convierte las conjeturas en comparación. Coloque su exportación junto a su archivo de importación y la discrepancia generalmente se vuelve obvia: una columna con un nombre diferente, un valor con la forma incorrecta, una referencia de padre faltante.
Store Exporter Deluxe se encarga del lado de la exportación, en CSV, TSV, XLS, XLSX, XML o JSON:
- Exportar productos, variaciones, etiquetas y niveles de stock
- Detectar términos de taxonomía o campos personalizados faltantes
- Crear una plantilla de trabajo para construir tu archivo de importación
- Archivar una instantánea antes de cualquier cambio importante
¿Cuáles son las mejores prácticas para evitar fallos en la importación?
Unos pocos hábitos evitan la mayoría de los problemas recurrentes. Cuestan un poco de tiempo al principio y ahorran el trabajo de rehacer que surge al descubrir una importación incorrecta dos semanas después.
- Haz una copia de seguridad de tu tienda antes de cualquier importación grande
- Prueba siempre primero con un archivo de muestra pequeño
- Guarda como CSV UTF-8 en lugar de CSV plano
- Mantén WordPress y WooCommerce actualizados
- Usa un sitio de staging para operaciones masivas
- Comprueba manualmente algunos productos después en lugar de confiar en el resumen
Reflexiones finales
Una importación de productos de WooCommerce que no funciona rara vez se debe a una tienda rota. Es un archivo que no dice exactamente lo que crees que dice, y la solución suele estar a un ajuste o una columna de distancia.
Aquí tienes un resumen rápido de lo que debes comprobar, en orden:
- Codificación y comillas del archivo, la causa más común con diferencia.
- La pantalla de Mapeo de Columnas, donde los datos desaparecen silenciosamente.
- Conflictos de plugins, probados en staging con un tema predeterminado.
- Límites del servidor, o simplemente lotes más pequeños.
- La casilla Actualizar productos existentes, que decide los duplicados.
Si estás solucionando un archivo que no creaste tú, empieza con uno que WooCommerce ya acepte. Exporta tu catálogo actual con Store Exporter Deluxe y compáralo con el archivo que está fallando.
Preguntas Frecuentes
¿Qué significa "Requisitos del formato CSV" para la importación de WooCommerce?
Significa un archivo delimitado por comas guardado en UTF-8 con una fila de encabezado. Solo la columna Nombre es realmente obligatoria, y tus encabezados no necesitan coincidir con los nombres de campo de WooCommerce porque la pantalla de Mapeo de Columnas te permite asignar cada uno. La especificación completa está en nuestra guía de importación CSV.
¿Por qué mi importación CSV de WooCommerce tiene éxito pero los productos no aparecen?
Tres causas explican casi todas estas situaciones. Los productos se importaron como borradores, así que comprueba el filtro de estado en la lista de productos. Una columna Publicado se estableció en 0 o -1, lo que los hace privados o borradores. O un producto padre variable se importó mientras sus variaciones fallaron, lo que se muestra como un producto sin opciones comprables.
¿Por qué no funciona mi importación de productos de WooCommerce?
Las razones más comunes son un archivo guardado en la codificación incorrecta, columnas dejadas en "No importar" durante el mapeo, filas de variaciones sin valor de Padre, y tiempos de espera del servidor en archivos grandes. Compruébalas en ese orden, porque las dos primeras explican la mayoría de los fallos y ambas son visibles antes de ejecutar la importación.
¿Cómo soluciono los errores de "URL de imagen 404" durante la importación CSV?
El importador descarga cada URL de imagen durante la importación, por lo que cada URL debe devolver una imagen real sin una redirección o un muro de inicio de sesión. Pruébalas con curl -I, o pega una en una ventana de incógnito. Las imágenes detrás de la autenticación o protección hot-link siempre fallarán, así que súbelas primero a tu Biblioteca de Medios y referencia sus URL finales.
¿Por qué mis variaciones se importaron como productos separados?
Falta la columna Padre, está mal escrita o no coincide exactamente con el SKU del padre. Cada fila de variación necesita que el Tipo esté configurado como variation y un valor de Padre que contenga el SKU del padre o id: más su ID de producto. Los espacios al final son el culpable habitual, ya que son invisibles en una hoja de cálculo pero rompen la coincidencia.
¿Por qué mi importación se detiene a mitad de camino?
Eso es un tiempo de espera, no un problema de datos. PHP detiene cualquier script que se ejecute durante más de max_execution_time, que por defecto es de 30 segundos en la mayoría de los servidores. Divida el archivo en lotes de 500 a 1.000 filas, o colóquelo en el servidor y utilice la opción de ruta de archivo en Opciones avanzadas.
¿Puedo deshacer una importación de productos de WooCommerce?
No, WooCommerce no tiene deshacer para las importaciones, por eso una copia de seguridad antes de cualquier ejecución grande es importante. Para corregir una importación incorrecta, corrija el archivo de origen y ejecútelo de nuevo con la opción Actualizar productos existentes marcada para que las filas se corrijan en su lugar en lugar de duplicarse.
