Mapear columnas del proveedor a los campos de producto de WooCommerce

Cómo mapear las columnas del proveedor a los campos de producto de WooCommerce

Mapear las columnas del proveedor a los campos de producto de WooCommerce significa decidir qué información del listado se convierte en nombre, SKU, precio, categoría, imagen o atributo en el catálogo. El archivo del mayorista llega con sus propias etiquetas: código de artículo, descripción comercial, familia, EAN. WooCommerce espera nombres de columna distintos y tipos de producto diferenciados. Sin una tabla de correspondencias, la importación crea fichas incompletas, duplicados y feeds que los canales rechazan.

Un crawler lee el título visible, el texto de la ficha, las imágenes y los datos estructurados que WooCommerce ya muestra en la página. Si la columna de descripción del proveedor termina en el nombre, el título se convierte en un párrafo. Si falta el SKU, la siguiente sincronización no tiene una clave. Si el EAN está en una nota libre, el GTIN no llega a los feeds. El mecanismo es visible: campos vacíos o colocados en el lugar equivocado, no un algoritmo misterioso.

Por qué el archivo del proveedor nunca está listo para WooCommerce

El listado del proveedor es una herramienta de venta al por mayor, no un esquema de catálogo: los nombres de las columnas, los decimales y las familias de productos no coinciden con los campos nativos de WooCommerce.

El mayorista optimiza la hoja para quien hace el pedido: código interno, descripción comprimida, precio por tramos, unidades por caja. WooCommerce optimiza la ficha para quien compra y para quien indexa: nombre legible, SKU estable, precio con un solo separador decimal, categorías de la tienda, atributos visibles en los filtros e imágenes con URL pública. Ambos objetos comparten los datos (artículo, precio, código de barras), pero no la forma.

Un ejemplo ilustrativo: una tienda con cuarenta referencias recibe un CSV con las columnas COD, DESCR, PZ, FAM, BARCODE. La fila DESCR contiene «VASO ESMALTE AZUL D20 H18 PZ/CT 6». Ese texto no es un título, ni una descripción, ni un conjunto de atributos. Son tres campos comprimidos en uno. Hasta que no los separes, la importación publica una ficha que a un asistente le cuesta citar y que Google Shopping interpreta como un título ruidoso.

El texto de la página y los datos estructurados trabajan juntos: el marcado confirma el precio y la disponibilidad cuando coinciden con la página.

Campos obligatorios y opcionales de un producto de WooCommerce

Para crear una ficha basta con un nombre; para venderla hacen falta el precio y, si gestionas el inventario, la cantidad; para no crear duplicados necesitas el SKU; el resto determina si la ficha está completa para la tienda y los feeds.

WooCommerce reconoce etiquetas inglesas fijas en su archivo CSV nativo. No puedes dejar los nombres del proveedor en la cabecera y esperar que el plugin de importación los «entienda». Debes cambiar el nombre de las columnas o utilizar la pantalla de correspondencias en Productos, Importar. Estos son los campos que casi siempre se utilizan.

• Name: título de la ficha, visible en la página y en los resultados.
• SKU: clave única de la tienda; sin SKU, cada nueva importación puede crear un duplicado.
• Type: simple, variable, variation, grouped o external.
• Regular price: precio de catálogo en el formato de la tienda, normalmente con punto decimal.
• Description y Short description: texto largo de la página y resumen en el listado.
• Categories y Tags: rutas ya existentes o que deben crearse antes de importar.
• Images: URL públicas, una o varias, separadas como indique el CSV.
• Attribute n name / Attribute n value(s): atributos globales o locales (color, talla, material).
• Parent: SKU del producto padre, solo en las filas variation.
• Stock e In stock?: cantidad y estado de disponibilidad, si la gestión de inventario está activa.

El peso, las longitudes, la clase de envío, la clase de IVA y el identificador global (GTIN, si aparece en los materiales del proveedor) son opcionales para publicar, pero su ausencia se nota enseguida en los feeds y en la ficha. Según Google Search Central, existen dos clases principales de datos estructurados para productos: el marcado que WooCommerce ya genera confirma los datos solo cuando coinciden con el título, el precio y la disponibilidad escritos en la página.

Quién importa listados de varios proveedores en la misma tienda

Quien importa listados de varios proveedores en la misma tienda debe tratar el SKU como un espacio de nombres. Dos mayoristas pueden utilizar el mismo código «1001». Añade un prefijo al SKU (FORN1-1001) o conserva una columna de proveedor como atributo oculto, nunca como parte del título. El GTIN, si está presente y es válido, sigue siendo la identidad de la pieza física; el SKU sigue siendo la identidad de la fila en tu sistema de gestión.

Cómo leer y mapear las columnas del proveedor una por una

Abre el CSV del proveedor, enumera cada encabezado y escribe al lado el campo de destino de WooCommerce, junto con una regla para los valores que deben separarse o descartarse.

No empieces por la importación. Empieza por una hoja de mapeo con tres columnas propias: encabezado original, campo de WooCommerce y regla de limpieza. La regla evita que la misma columna termine en dos campos o en ninguno.

1. Abre el archivo en una hoja de cálculo con codificación UTF-8. Si Excel en español ha utilizado el punto y coma, no lo conviertas al azar: anota el separador antes de guardar.
2. Bloquea la primera fila y recorre los encabezados. Marca CODIGO, ART, ITEM y REF como posibles SKU. Marca DESCRIPCION, NOMBRE e ITEM NAME como posibles títulos. Marca EAN, GTIN, BARCODE y UPC como posibles identificadores globales.
3. Abre WooCommerce, Productos, Importar y compara las etiquetas nativas (Name, SKU, Regular price, Categories, Images, Attribute 1 name). Cuando los nombres no coincidan, cambia el encabezado del CSV o realiza la correspondencia manualmente en el menú desplegable de la pantalla de importación.
4. Para cada columna ambigua, escribe la regla. Ejemplo: FAMILIA va a Categories solo después de haber creado las mismas categorías en la tienda; COLOR y TALLA van a atributos globales (Productos, Atributos), no al título.
5. Elige el Type. Una fila, un artículo vendible: simple. El mismo modelo con varias tallas o colores: un padre variable y filas variation con Parent igual al SKU del padre.
6. Normaliza los números. El precio con coma decimal debe convertirse al formato que espera la tienda. Las cantidades deben ser enteras. El peso debe utilizar la unidad configurada en WooCommerce, Ajustes, Productos.
7. Guarda un CSV de prueba con diez filas, impórtalo como borrador, abre una ficha y verifica el nombre, el SKU, el precio, el inventario, los atributos y la imagen antes de modificar todo el catálogo.

Un ejemplo ilustrativo de antes y después, declarado como tal. Antes, una sola celda: «CAMISETA ALGODÓN HOMBRE AZUL M 19,90 8001234567897». Después del mapeo: SKU a partir del código de artículo; Name «Camiseta de algodón azul, hombre»; atributo Material algodón, atributo Color azul, atributo Talla M; Regular price 19.90; GTIN solo si el código de barras aparece en los materiales del proveedor y supera el dígito de control. La frase sobre la caja no es el título.

Quién tiene poco tiempo para la rutina diaria

Quien tiene poco tiempo para la rutina diaria no asigna cada fila nueva manualmente. Congela la tabla de correspondencias en una hoja modelo y, con cada listado, cambia solo el encabezado. Si el proveedor añade una columna, trátala como una excepción: puedes ignorarla o vincularla a un atributo ya existente. El coste oculto no es la importación, sino rehacer las reglas cada lunes.

Errores habituales

Los errores de mapeo que perjudican al SEO y a los feeds son siempre los mismos: título sucio, categoría del mayorista en lugar de la categoría de la tienda, GTIN inventado o colocado en el campo equivocado y variantes separadas como productos simples.

Título igual a la descripción del proveedor. Se manifiesta así: en el escaparate aparece un nombre completamente en mayúsculas, con unidades por caja, códigos internos y medidas pegadas. Ocurre porque la columna DESCR es la única textual y termina en Name. Se soluciona extrayendo un título corto (producto, material y rasgo distintivo) y trasladando el resto a Description o a los atributos. El formato de título se aplica después, no en lugar de la limpieza.

Categoría del proveedor copiada como categoría de la tienda. Se manifiesta así: en Productos, Categorías aparecen decenas de entradas duplicadas («CERAMICA», «Cerámica», «cerámicas») y los filtros del tema no agrupan nada. Ocurre porque FAMILIA no coincide con la taxonomía que has definido. Se soluciona creando primero el árbol de categorías en WooCommerce y mapeándolo con una tabla de equivalencias (FAMILIA «CER-VAS» → Categoría «Jarrones»). La categoría de la taxonomía de Google es un campo distinto: no es el slug de la tienda y no debe improvisarse en el CSV si no la has confirmado.

GTIN en el lugar equivocado o inventado. Se manifiesta así: el feed informa de identificadores ausentes, duplicados o no válidos; en la ficha, el código aparece en las notas. Ocurre porque BARCODE se colocó en Description o porque alguien copió un EAN de un sitio de terceros. Se soluciona copiando el código solo de los materiales del proveedor (columna, foto del embalaje o PDF) y dejando el campo vacío si falta. Un GTIN no se busca en internet ni se fabrica.

Variantes importadas como productos simples. Se manifiesta así: tres fichas de «el mismo jersey, tres tallas», tres URL y tres precios que divergen con la primera actualización. Ocurre porque el listado tiene una fila por SKU hijo y la importación utiliza Type simple en todas. Se soluciona así: una fila padre con Type variable y atributos utilizados para las variaciones; filas hijas con Type variation, Parent igual al SKU del padre y un solo valor de atributo por fila. Según el blog para desarrolladores de WooCommerce, a partir de la versión WooCommerce 11.1 las galerías de variación estarán habilitadas para todas las tiendas: tiene sentido mapear también las imágenes de cada variante, no solo la del padre.

Un artesano que vende cerámica y gestiona unas cuarenta referencias

Un artesano que vende cerámica y gestiona unas cuarenta referencias suele recibir del taller una hoja con el esmalte, el diámetro y las unidades por caja en la misma celda. Aquí el mapeo es breve y se hace una vez: SKU propio, nombre con forma y color, atributos Diámetro y Esmalte y peso para el envío. No hace falta un producto variable si cada jarrón es una pieza única: Type simple, imágenes diferentes y ningún Parent.

Importar el CSV de la hoja del proveedor al catálogo publicado

La importación CSV nativa de WooCommerce publica solo lo que ya has mapeado: se carga un archivo de prueba, se asignan las columnas, se verifica una ficha en borrador y solo después se importa todo el catálogo.

La ruta en el sistema de gestión es Productos, Importar. WooCommerce solicita el archivo y después muestra cada encabezado del CSV junto a un menú de campos conocidos. Si has cambiado las columnas por los nombres nativos (Name, SKU, Regular price), la correspondencia es casi automática. Si has dejado COD y DESCR, debes elegir manualmente. La opción de actualizar los productos existentes utiliza el SKU como clave: sin SKU, la actualización crea filas nuevas.

1. Exporta primero un CSV de un producto ya publicado (Productos, Exportar) y úsalo como plantilla de columnas. Es el vocabulario que la importación entiende sin ambigüedades.
2. Copia los valores del proveedor bajo esos encabezados, no al contrario. El listado original sigue siendo un archivo de referencia; el archivo de importación es un derivado limpio.
3. Establece Published en -1 (borrador) en la primera ronda. Así las fichas no aparecen en el escaparate con títulos sucios.
4. Carga el archivo, comprueba la correspondencia columna por columna, inicia la importación y abre tres fichas de muestra: una simple, una variante y una sin imagen.
5. Corrige la hoja, no las fichas una por una, y vuelve a importar actualizando por SKU. Cuando el nombre, el precio, el inventario y los atributos coincidan, cambia Published a 1.

Si el proveedor no te entrega un CSV, sino un listado maquetado, el trabajo de extracción se realiza antes del mapeo. En ese caso se pasa del PDF a los datos de producto y solo después se alinean las columnas con los campos de WooCommerce. Lo mismo ocurre con una foto de una etiqueta: primero se extraen los datos visibles y después se asignan a SKU, nombre y atributos.

Cómo agilizar el mapeo en catálogos grandes sin rehacerlo todo a mano

En los catálogos grandes, el mapeo se agiliza fijando las reglas de correspondencia, los atributos globales y las categorías antes de importar, y actualizando después solo las columnas que el proveedor haya cambiado realmente.

La tentación es abrir dos mil filas y limpiar los títulos a mano. Ese método no escala. Se prepara la tienda: en Productos, Atributos creas Color, Talla, Material y Marca como atributos globales, con los valores ya utilizados en el escaparate. En Productos, Categorías defines el árbol. En la hoja de mapeo estableces las equivalencias del proveedor con esas listas. La importación escribe valores conocidos; los nuevos quedan visibles porque no coinciden con la lista.

• Actualiza por SKU solo el precio, el inventario y la disponibilidad cuando el listado sea una renovación.
• Mantén Name y Description fuera de la renovación automática si ya los has reescrito en un español legible.
• Separa los archivos: uno para los SKU nuevos, otro para las actualizaciones y otro para las variaciones.
• No mezcles en el mismo CSV productos simples y variaciones hasta que la columna Parent esté completa y sea coherente.
• Descarta del archivo de importación las columnas que no tengan un campo de destino (descuentos por tramos, pedido mínimo y notas internas del mayorista).

Un GTIN se lee únicamente en los materiales del comerciante, como fotos del embalaje, PDF o una columna del CSV, y debe superar el dígito de control: no se inventa ni se busca en internet.

Quién alinea el mismo listado con varios canales de venta

Quien alinea el mismo listado con varios canales de venta (Amazon, eBay, Etsy) debe decidir quién es la fuente principal de los datos. WooCommerce conserva el SKU, el título de la tienda, el precio y el inventario. Los marketplaces reciben una exportación derivada, no el CSV sin limpiar del proveedor. Si asignas el título de Amazon al Name de la tienda, pierdes la frase útil del escaparate. Es mejor utilizar un atributo o una columna de exportación por canal y un único Name pensado para la ficha del sitio.

Para un posible feed destinado a asistentes de compra se mantienen los nueve campos de la especificación de OpenAI (item_id, title, description, url, brand, seller_name, image_url, availability, price con moneda). GTIN y MPN son opcionales. Esos campos se rellenan después del mapeo de WooCommerce, no en lugar de Name y SKU. Los nombres link e image_link pertenecen a Merchant Center, no a ese feed.

Cómo ayuda Katapic a llevar el listado a los campos correctos

Katapic importa desde CSV, PDF y fotos, completa solo los campos vacíos con datos verificados y devuelve las fichas a WooCommerce con la sincronización bidireccional.

Si el proveedor te envía una hoja, la importación CSV entra en el catálogo de trabajo; si te envía un listado maquetado, la lectura página por página extrae los textos y las imágenes incorporadas y las asigna a los productos. Una foto, una ficha: de la foto Katapic reconoce el producto, la marca, la categoría y los atributos, y todo sigue siendo modificable antes de publicar. Completar los campos vacíos es una acción aparte, solicitada explícitamente y con fuente.

El escaneo gratuito de un catálogo público de WooCommerce, sin cuenta y en modo de solo lectura, muestra dos puntuaciones por ficha (búsqueda clásica y preparación para asistentes), además de una comprobación de la preparación de los datos sobre los campos que faltan o son incorrectos; Relevancia y Completitud se añaden con una cuenta gratuita. La categoría de la taxonomía de Google se propone para cada categoría de la tienda: tú la confirmas y el identificador confirmado entra en los feeds. Las posibles variantes (mismo título con talla, color o formato) se proponen como variantes de un único producto y se agrupan solo después de la confirmación.

La sincronización de WooCommerce es bidireccional, con el plugin gratuito. La reescritura de las fichas pasa por un verificador de afirmaciones: no se inventan marcas, certificaciones ni historia de la marca; si una medida encontrada en internet contradice el título del comerciante, se mantiene el dato del comerciante. Las correcciones gratuitas (formato de título en nombres completamente en mayúsculas, limpieza del HTML, condición, declaración de ausencia del GTIN del fabricante, agrupación de variantes y confirmación de la categoría de Google) llegan solo tras una confirmación explícita y se pueden deshacer. Para organizar el catálogo de WooCommerce se parte de los datos que ya tienes, no de un texto generado en tu lugar.

Preguntas frecuentes sobre el mapeo CSV en WooCommerce

¿Qué campos son obligatorios para un producto de WooCommerce en una importación CSV?

Para crear la ficha hace falta al menos Name. Para venderla hacen falta Regular price y, si activas el inventario, Stock con In stock?. El SKU no es obligatorio en el formulario de creación, pero sin SKU la importación no puede actualizar y crea duplicados. Type hace falta en cuanto tienes variaciones. Las categorías, imágenes, atributos y el GTIN no bloquean la publicación, pero una ficha sin esos datos queda pobre para la tienda y los feeds.

¿Cómo se mapean las columnas del archivo del proveedor a los campos de producto de WooCommerce?

Se crea una tabla de correspondencias: cada encabezado del listado tiene un campo de destino (SKU, Name, Regular price, Categories, Images, Attribute) y una regla de limpieza. Después se cambia la cabecera del CSV por los nombres nativos o se realiza la asignación manualmente en Productos, Importar. Se prueba con diez filas en borrador. Solo cuando el título, el precio y los atributos coinciden se importa el resto actualizando por SKU.

¿Dónde se coloca el código EAN del proveedor en la ficha de WooCommerce?

El EAN va en el identificador global del producto (GTIN), no en el título ni en la descripción. Solo se copia si aparece en los materiales del proveedor y supera el dígito de control. Si la columna está vacía, el campo se deja vacío: no se busca un código en internet ni se inventa. Un EAN colocado en las notas no llega a los feeds ni ayuda a la ficha.

¿Cómo se importa un CSV de productos de WooCommerce sin duplicar los SKU?

Cada fila debe tener un SKU único en la tienda. En la importación, elige actualizar los productos existentes: WooCommerce utiliza el SKU como clave. Añade prefijos a los SKU si dos proveedores comparten el mismo código. No importes dos veces un archivo sin SKU. Comprueba primero Productos, Todos los productos, busca por SKU y solo después inicia la actualización de precios e inventario.

¿Cómo se asigna la categoría de Google a los productos de WooCommerce?

La categoría de la tienda (Productos, Categorías) no es la categoría de la taxonomía de Google. Primero se define el árbol interno, se asigna la familia del proveedor a ese árbol y después se asocia por separado el ID de Google confirmado que se utilizará en los feeds. No pegues la cadena FAMILIA del mayorista en el campo de Google. Sin confirmación, tendrás una categoría del escaparate útil para el tema, pero no un ID de taxonomía para los canales.

¿Qué ocurre si las variantes del proveedor llegan como filas separadas?

Si cada talla o color es una fila y las importas como simple, obtendrás fichas gemelas y URL distintas. El mapeo correcto es un padre variable con los atributos de variación y productos hijos variation con Parent igual al SKU del padre. Cada fila hija debe tener un solo valor de atributo. Las imágenes de cada variante se vinculan a la fila hija, no solo al padre, para que la galería muestre la pieza correcta.

¿Se puede tratar un listado en PDF como un CSV que hay que mapear?

Sí, pero en dos etapas. Primero se extraen de las páginas y tablas los datos (código, nombre, precio y posibles imágenes incorporadas) y se obtiene una cuadrícula. Después esa cuadrícula sigue las mismas reglas de mapeo del CSV: SKU, Name, precio, categorías y atributos. Saltarse la extracción y copiar a mano desde un PDF de cien páginas es la vía que produce títulos sucios y campos vacíos.