Cómo subir productos masivamente a WooCommerce

Opción 1: el importador CSV integrado de WooCommerce

WooCommerce incluye un importador y un exportador CSV de productos. En el administrador de WordPress, ve a Productos → Todos los productos y elige Importar. Sube tu CSV, asocia sus columnas a los campos de WooCommerce y ejecuta la importación. Marcar “Actualizar los productos existentes” te permite actualizar los productos identificados por ID o SKU en lugar de crear duplicados.

• Exporta primero un producto existente y utiliza ese archivo como plantilla: muestra los nombres de columna exactos que espera tu tienda.
• Las columnas habituales incluyen Type, SKU, Name, Published, Short description, Description, Regular price, Categories, Tags, Images y Attribute 1 name / Attribute 1 value(s).
• Las imágenes se importan desde URL, por lo que deben ser de acceso público mientras se ejecuta la importación.
• Los productos variables necesitan una fila principal de tipo “variable” y una fila por cada variación que haga referencia a la principal.
• Los archivos muy grandes pueden agotar el tiempo de espera en hostings compartidos: divídelos en lotes de unos cientos de filas.

Opción 2: plugins de importación

Los plugins de importación de terceros añaden funciones de las que carece el importador estándar: importaciones programadas o recurrentes desde un feed de proveedor, compatibilidad con XML, reglas de transformación de campos y mejor gestión de archivos muy grandes. Tienen sentido cuando un proveedor envía con regularidad archivos actualizados de precios y existencias.

Los plugins siguen esperando datos estructurados. Si tu proveedor te facilita PDF en lugar de un feed, un plugin no elimina el trabajo de convertir esos PDF en filas.

Opción 3: la API REST de WooCommerce

Los desarrolladores y las herramientas de integración pueden crear productos mediante la API REST de WooCommerce, que incluye un endpoint por lotes que crea o actualiza muchos productos en una sola solicitud. Es adecuada para flujos automatizados y aplicaciones que crean productos directamente, sin un paso intermedio con CSV.

Doc2Shelf utiliza esta vía: tras la revisión, envía los productos a WooCommerce como productos simples en borrador con descripciones larga y corta, para que puedas comprobarlos en WooCommerce antes de publicarlos. Los atributos globales de filtro y los productos variables se configuran por separado en WooCommerce.

Preparar los datos de producto para una subida masiva

Sea cual sea el método de importación, la calidad de los datos determina el resultado. Antes de importar:

• Asigna a cada producto un SKU único: es la forma en que las actualizaciones posteriores encuentran el producto correcto.
• Crea primero las categorías y los atributos globales en WooCommerce y haz referencia a ellos de forma coherente.
• Normaliza las especificaciones: mismas unidades, mismos nombres de atributo y un valor por celda.
• Redacta descripciones propias en lugar de pegar el texto del proveedor; los marketplaces y los motores de búsqueda valoran el contenido único.
• Importa como borradores en una primera prueba (establece Published en -1; con 0 los productos quedan privados) y revisa una muestra antes de publicar todo.

Cuando tu proveedor solo envía PDF

Muchos proveedores facilitan fichas técnicas y catálogos en PDF, no feeds CSV. En ese caso el cuello de botella es la extracción: alguien tiene que leer cada PDF, rellenar las columnas y redactar una descripción.

Puedes hacerlo manualmente o extraer los datos con una herramienta y revisarlos. Doc2Shelf lee los PDF de los proveedores, extrae las especificaciones para su revisión, redacta las descripciones larga y corta de WooCommerce y crea los productos como borradores mediante la API REST, lo que sustituye el paso de la hoja de cálculo en los catálogos procedentes de PDF.

Errores habituales de importación en WooCommerce

Si una importación falla o produce resultados inesperados, comprueba primero lo siguiente:

• SKU duplicados o ausentes que hacen que se omitan filas o se dupliquen productos.
• Codificación de archivo incorrecta: guarda el CSV como UTF-8 para que los caracteres acentuados se importen correctamente.
• URL de imágenes que redirigen, exigen iniciar sesión o apuntan a archivos muy grandes.
• Rutas de categoría escritas de forma incoherente (usa “Padre > Hijo” para categorías anidadas).
• Variaciones cuyos valores de atributo no coinciden con los del producto principal.

Referencia de columnas del CSV de productos de WooCommerce

El importador estándar lee un conjunto fijo de nombres de columna. Si exportas un producto de tu propia tienda, obtienes los encabezados exactos que espera tu versión de WooCommerce; la tabla siguiente explica las columnas más importantes para una subida masiva. Solo Name es obligatoria: todas las demás columnas son opcionales, pero importar un catálogo sin Type, SKU, precios ni categorías deja mucho trabajo manual para más adelante.

Las columnas con una unidad en el encabezado, como Weight y las tres dimensiones, muestran la unidad configurada en los ajustes de tu tienda, así que copia esos encabezados de una exportación en lugar de escribirlos a mano. Los datos personalizados que no tienen columna propia van en una columna cuyo encabezado empieza por meta: seguido de la clave del campo.

Productos variables en un CSV: filas principales y filas de variación

Un producto variable se reparte en varias filas: una fila principal que define el producto y los valores de atributo que ofrece, y una fila por variación con el precio, el SKU y las existencias de una combinación concreta. La fila principal tiene Type «variable»; cada fila de variación tiene Type «variation» y remite al producto principal en la columna Parent, con el SKU del principal o id: seguido de su ID.

Las columnas de atributo unen las filas. En la fila principal, Attribute 1 value(s) enumera todos los valores que ofrece el producto, separados por comas. En cada variación aparece el mismo Attribute 1 name con exactamente uno de esos valores. La ortografía y las mayúsculas deben coincidir: una variación que diga «rojo» bajo un producto principal que ofrece «Rojo» puede acabar sin un valor de atributo utilizable.

Establece Attribute 1 global en 1 en el producto principal y en sus variaciones cuando uses un atributo común a toda la tienda creado en Productos → Atributos: es con lo que funcionan la navegación por capas y los widgets de filtro. Desde WooCommerce 11.1, una importación de actualización también puede añadir variaciones nuevas a un producto variable que ya existe, de modo que puedes ampliar una gama sin reconstruir el producto principal.

• Mantén cada fila principal encima de sus variaciones para que el archivo sea fácil de revisar y para que el producto principal exista cuando sus variaciones hagan referencia a él.
• Asigna a cada variación su propio SKU y su propio precio; una variación sin precio no se puede comprar.
• Usa Attribute 1 default en el producto principal para controlar qué opción aparece preseleccionada.

Añadir imágenes de producto mediante el CSV

La columna Images admite una o varias URL de imagen separadas por comas. La primera URL se convierte en la imagen destacada y las demás forman la galería del producto en el orden indicado. Durante la importación, WordPress descarga cada archivo en tu biblioteca de medios, por lo que todas las URL deben ser de acceso público en ese momento: sin inicio de sesión, sin enlaces compartidos que caduquen y sin redirecciones a una página web en lugar de al archivo.

Las imágenes suelen ser la parte más lenta de una importación: unos cientos de productos con cinco imágenes cada uno suponen más de mil descargas. Redimensiona las imágenes antes de alojarlas, usa nombres de archivo descriptivos (kettle-red-front.jpg, no IMG_0042.jpg) y divide los catálogos grandes en archivos más pequeños.

El importador estándar no puede establecer el texto alternativo de las imágenes. Añádelo después en la biblioteca de medios, mediante la API REST o con una extensión de importación que lo admita. Una variación admite una sola imagen, así que da a cada fila de variación una URL como máximo.

Crear productos de forma masiva con la API REST de WooCommerce

La API REST es la mejor opción cuando las importaciones se repiten, cuando los datos de producto ya están en otro sistema o cuando nadie debería tener que manejar un CSV. Su endpoint por lotes de productos (POST /wp-json/wc/v3/products/batch) acepta operaciones de creación, actualización y eliminación en una sola solicitud.

De forma predeterminada, una solicitud por lotes está limitada a 100 objetos entre sus creaciones, actualizaciones y eliminaciones. El mismo límite se aplica a los endpoints por lotes de variaciones, categorías, atributos y términos de atributo. Un catálogo de 1000 productos requiere, por tanto, al menos diez solicitudes, y más si se añaden variaciones.

1. Crea una clave de la API REST con permiso de lectura y escritura en WooCommerce → Ajustes → Avanzado → API REST, o deja que una aplicación solicite una a través de la pantalla de autorización de WooCommerce.
2. Crea primero las categorías, los atributos globales y los términos de atributo, y anota sus ID.
3. Envía los productos simples y los productos principales en lotes de hasta 100, con el estado establecido en borrador.
4. Crea las variaciones de cada producto variable mediante el endpoint por lotes de variaciones de ese producto.
5. Comprueba el resultado de cada elemento en la respuesta y reintenta solo los elementos que hayan fallado.
6. Revisa por muestreo algunos borradores en el administrador y después publícalos.

Elegir un plugin o una vía para la subida masiva de productos a WooCommerce

Si el importador estándar no basta, evalúa un plugin o una extensión de importación por cómo gestiona tus datos, no por la longitud de su lista de funciones, y pruébalo en una copia de pruebas de la tienda con un archivo real de proveedor antes de comprometerte con él. La tabla compara las cuatro vías, seguida de las preguntas que conviene hacer a cualquier plugin.

• Formatos de origen: solo CSV, o también XML, hojas de cálculo y feeds remotos obtenidos por URL.
• Programación: si puede repetir una importación según un calendario para recoger nuevos precios y existencias.
• Mapeo y transformaciones: renombrar columnas, dividir valores, convertir unidades y aplicar reglas de precios durante la importación.
• Productos variables: si crea de forma fiable productos principales, variaciones y atributos globales.
• Imágenes: cómo las descarga, si detecta duplicados y si establece el texto alternativo.
• Archivos grandes: procesamiento en segundo plano o por fragmentos para que las importaciones largas no agoten el tiempo de espera.
• Reglas de actualización: con qué clave busca coincidencias (ID, SKU o GTIN) y qué campos puede sobrescribir.

Lista de comprobación previa a la importación y soluciones a los errores

La mayoría de las importaciones fallidas se deben a un paso de preparación omitido. Repasa la lista de comprobación antes de cada importación grande y usa la tabla para diagnosticar los problemas que aún surjan.

1. Haz una copia de seguridad de la base de datos o ejecuta la importación en una copia de pruebas de la tienda.
2. Exporta un producto existente y copia su fila de encabezados en tu archivo.
3. Crea las categorías, los atributos globales y los términos de atributo a los que hace referencia el archivo.
4. Comprueba que cada SKU es único y que el valor Parent de cada variación coincide con el SKU de un producto principal existente.
5. Usa números simples en las columnas de precio, existencias, peso y dimensiones.
6. Abre una muestra de URL de imágenes en una ventana privada del navegador para confirmar que cargan sin iniciar sesión.
7. Establece Published en -1 para que los productos lleguen como borradores.
8. Guarda el archivo como CSV en UTF-8.
9. Importa un archivo de prueba de diez filas, revisa los resultados y después importa el resto por lotes.

Probar con productos ficticios antes de la importación real

Un pequeño archivo ficticio detecta errores de mapeo antes de que afecten a cientos de productos. Créalo a partir de tu plantilla real para que los encabezados sean idénticos, y da a cada producto de prueba una marca evidente (un prefijo «TEST-» en el SKU y una etiqueta «test») para poder encontrarlos y eliminarlos después.

Cubre todos los casos que contenga tu archivo real, no solo el más sencillo. Suelen bastar unas diez filas:

• Un producto simple con todas las columnas que piensas usar rellenadas.
• Un producto variable con dos atributos y al menos tres variaciones.
• Un producto con una galería de varias imágenes y otro sin imágenes.
• Un producto en una categoría anidada que todavía no existe.
• Un producto con caracteres acentuados, comillas y una coma dentro de la descripción.
• Una fila que actualice un producto existente mediante el SKU.
• Comprueba los resultados en el administrador y en la tienda (precios, desplegables de variaciones, orden de las imágenes y páginas de categoría) y elimina los productos de prueba antes de la importación real.