Guía

Atributos de producto: cómo extraerlos, normalizarlos y asignarlos

Unos atributos de producto limpios son lo que hace que funcionen los filtros, las comparativas, los feeds y los borradores de conformidad. Esta guía abarca el esquema, la extracción, las reglas de unidades y de vocabulario, y la asignación a taxonomías que convierten los valores desordenados de los proveedores en datos coherentes.

Cada proveedor describe lo mismo de forma distinta. Una ficha técnica dice “Capacidad: 1,5 l”, otra “1500 ml” y una tercera esconde “admite 1.5 litros” en un párrafo. Para un comprador es un mismo dato; para un filtro o un feed son tres cadenas sin relación. La normalización de atributos de producto convierte esas variaciones en un único valor, en una única unidad y bajo un único nombre de atributo.

Esta guía sigue el orden en que se hace el trabajo en la práctica: esquema, extracción, normalización de números y textos, asignación a taxonomías, variantes y validación. Los ejemplos usan códigos de unidad y estructuras de taxonomía reales, para que puedas adaptarlos directamente.

Qué son los atributos de producto (y qué no son)

Un atributo de producto es una propiedad con nombre y con un valor: material = acero inoxidable, capacidad = 1,5 L, color = negro. La investigación sobre extracción de atributos los llama pares atributo-valor. Los atributos describen el propio producto y siguen siendo ciertos dondequiera que se venda, por eso deben estar en campos estructurados y no solo en el texto de la descripción.

Hay tres conceptos cercanos que es fácil confundir con los atributos, y mezclarlos causa la mayoría de los problemas de esquema posteriores:

Los atributos frente a otros datos de producto relacionados
ConceptoFinalidadEjemploDónde suele ir
AtributoDescribe una propiedad del productoMaterial: acero inoxidable; Capacidad: 1,5 LTabla de especificaciones, filtros, campos de categoría
IdentificadorNombra de forma única el producto o el artículo comercialGTIN, MPN, SKU, número de modeloCampos de identificador específicos
Opción de varianteUn atributo entre cuyos valores elige el compradorColor: negro / blanco; Talla: S / M / LEjes de variante (Shopify admite hasta 3 opciones)
DescripciónExplica en prosa los beneficios y el uso“Hierve un hervidor lleno en pocos minutos”Descripción y viñetas

Define el esquema de atributos antes de extraer nada

Un esquema de atributos es el contrato que debe cumplir cada valor. Sin él, la extracción produce lo que casualmente diga la fuente y la normalización se convierte en una conjetura. Para cada atributo, decide el nombre, el tipo de datos, la unidad canónica, los valores permitidos o la regla de validación, si puede contener varios valores y dónde es obligatorio.

Mantén el esquema por familia de producto en lugar de una lista gigante: un hervidor necesita capacidad y potencia nominal, una camiseta necesita composición de fibras y talla. Empieza por los atributos que exigen tus canales y por los que filtran tus compradores, y añade después los atributos técnicos que tus fichas técnicas proporcionan de forma fiable.

Ejemplo de esquema de atributos para una familia de hervidores eléctricos
AtributoTipo de datosUnidad / formatoValores permitidos o reglaObligatorio
model_numberTexto—Tal como lo imprime el fabricante; sin añadir espaciosSí
gtinTexto (dígitos)8, 12, 13 o 14 dígitosDígito de control GS1 válidoSi está asignado
capacityDecimalLTR (litro)0,1 a 5,0; un valor por varianteSí
rated_power_min / rated_power_maxEnteroWTT (vatio)mín. ≤ máx.; ambos de la misma línea de características nominalesSí
body_materialEnum (multivalor)—stainless steel, glass, plastic, ceramicSí
colorEnum—Lista de colores base; el nombre comercial se guarda por separadoSí, por variante
net_weightDecimalKGM (kilogramo)> 0; no puede superar el peso brutoPara el envío

De dónde proceden los valores de los atributos y qué fuente prevalece

Los valores suelen llegar de varias fuentes que no siempre coinciden. Fija una prioridad de fuentes por atributo para que los conflictos se resuelvan siempre de la misma manera y no según quién edite el registro en último lugar.

Una norma práctica por defecto: los documentos técnicos prevalecen sobre el texto de marketing, y el documento específico prevalece sobre el general. Cuando fuentes de igual rango discrepan (por ejemplo, la ficha técnica y el embalaje indican pesos distintos), no hagas la media ni elijas uno: pregunta al proveedor cuál es el vigente.

  • Fichas técnicas y hojas de especificaciones: la fuente más fiable para dimensiones, valores nominales, materiales y valores de rendimiento, normalmente en tablas.
  • Embalaje y artes finales de etiquetas: determinantes para lo que va impreso en el envase, como la cantidad neta, las advertencias y los marcados.
  • Fichas de datos de seguridad: clasificación de peligros, composición y propiedades físicas de los productos químicos; no son atributos de marketing.
  • Descripciones de producto del proveedor: útiles para atributos que nunca aparecen en una tabla (estilo, uso previsto, modelos compatibles), pero la fuente menos precisa.

Cómo extraer atributos de las descripciones de producto

Las descripciones en texto libre son la fuente más difícil porque los valores están envueltos en frases, matizados por lenguaje de marketing y a veces negados. Tanto si usas reglas como un diccionario de valores conocidos o un modelo de lenguaje, el procedimiento que mantiene fiable el resultado es el mismo:

  1. Enumera los atributos objetivo de la familia de producto, con sus valores permitidos y unidades, antes de leer ningún texto.
  2. Divide el texto en frases y viñetas y busca los valores candidatos: números con unidades, términos conocidos del vocabulario y patrones como “compatible con …”.
  3. Comprueba el contexto de cada candidato en busca de calificadores (“hasta”, “aprox.”, “desde”), negaciones (“sin BPA”, “no apto para”) y condiciones (“con tapa”, “a 20 °C”).
  4. Asigna cada valor a un único atributo; cuando un número pueda pertenecer a dos atributos, déjalo sin asignar para revisarlo en lugar de adivinar.
  5. Normaliza el valor y la unidad con las reglas de las secciones siguientes, conservando el texto original al lado.
  6. Marca todos los atributos que procedan únicamente del texto de marketing, para que un revisor pueda confirmarlos con una ficha técnica antes de usarlos en una tabla de especificaciones o en un borrador de declaración.
Ejemplo práctico: atributos hallados en una frase de descripción
Texto de la descripciónAtributoValor extraídoNota
“…un hervidor de acero inoxidable de 1,7 litros…”capacity; body_material1.7 LTR; stainless steelDos atributos en una misma expresión
“…con tapa de plástico sin BPA…”lid_material; bpa_freeplastic; trueLa negación se convierte en un booleano, no en un material
“…no apto para placas de inducción…”induction_compatiblefalseEnunciado negado, invertido
“…disponible en negro mate y crema…”color (opción de variante)black; beigeLos nombres comerciales se guardan por separado

Asigna los encabezados de las fichas técnicas a nombres de atributo canónicos

Cada fabricante rotula el mismo atributo de forma distinta, a menudo en su propio idioma. Crea una tabla de sinónimos que asigne el texto de encabezado que realmente encuentres a tu nombre de atributo canónico; crece rápido al principio, luego se estabiliza y se convierte en tu activo de normalización más reutilizable. Registra también la unidad impresa en el encabezado: bajo “Peso (lbs)”, ninguna celda repite la unidad. Los diseños de tablas, los escaneos y el OCR se tratan en la guía sobre cómo extraer datos de producto de PDF.

Sinónimos de encabezados asignados a un único atributo canónico
Encabezado tal como se imprimeAtributo canónicoUnidad implícita en el encabezadoNota
Potencia nominal / Consumo de potencia / Leistungrated_powerWTTComprueba que sea la potencia de entrada, no la de salida
Peso neto / Peso (unidad) / Nettogewichtnet_weightKGM o LBR, según lo impresoNo es el peso de envío
Capacidad / Volumen / FassungsvermögencapacityLTR o MLTPara recipientes, no el volumen del paquete
Dimensiones (An × Pr × Al) mmwidth, depth, heightMMTOrden de los ejes tomado del encabezado

Normaliza números y unidades

Guarda cada atributo cuantitativo en dos campos: un número y un código de unidad. La Recomendación n.º 20 de UN/CEFACT (“Códigos de las unidades de medida utilizadas en el comercio internacional”) proporciona códigos comunes de tres caracteres para ello, y schema.org usa los mismos códigos en su propiedad unitCode, por ejemplo un QuantitativeValue de 25 con unitCode CMT. Usar estos códigos en lugar de unidades en texto libre (“cm”, “cms”, “centímetros”) elimina toda una clase de discrepancias.

Elige una unidad canónica por atributo, normalmente la unidad del SI o un múltiplo decimal de ella, y conviértela al importar para que los valores sean comparables entre proveedores. Conserva el valor y la unidad originales tal como figuran impresos para garantizar la trazabilidad, y reconvierte a las unidades de cada canal al exportar: el CSV de productos de Shopify espera el peso en gramos, mientras que WooCommerce usa las unidades de peso y de dimensiones configuradas en la tienda.

Ojo con los detalles que causan errores silenciosos. Los separadores decimales y de millares dependen de la configuración regional del documento: en una ficha técnica alemana “1.000 W” son mil vatios. Divide los intervalos en campos de mínimo y máximo, guarda las tolerancias aparte del valor nominal y conserva calificadores como “aprox.” o “máx.” en su propio campo. Las conversiones imperiales usan definiciones exactas (1 pulgada = 25,4 mm; 1 lb = 0,45359237 kg); redondea una sola vez, en el momento de mostrar el valor.

Valores brutos de proveedores y su forma normalizada
Valor bruto tal como se imprimeValor normalizadoCódigo UNECE Rec. 20Regla aplicada
1,5 l1.5LTRComa decimal interpretada según la configuración regional del documento
1500 ml1.5LTRConvertido a la unidad canónica del atributo; se conserva el original
1.000 W (ficha técnica alemana)1000WTTPunto interpretado como separador de millares
220–240 V~mín. 220, máx. 240VLTIntervalo dividido; “~” guardado como tipo de corriente CA
Ø 12 mm ± 0,2nominal 12, tolerancia 0.2MMTTolerancia guardada por separado
aprox. 2,3 kg2.3 (calificador: aproximado)KGMEl calificador se conserva, no se descarta
5 lb2.26796KGMConvertido con 0,45359237; se conserva el original en LBR
1/2 in12.7MMTFracción resuelta; se conserva el original en INH
Pack de 66H87Número de piezas por pack

Usa vocabularios controlados para los atributos de texto

Un vocabulario controlado es la lista de valores que puede tomar un atributo de texto, más los sinónimos que se asignan a cada uno. Permite que un filtro “Color: negro” encuentre productos descritos como “blk”, “Black” y “schwarz”.

Mantén dos campos cuando el marketing y el filtrado tiran en direcciones distintas: un valor base normalizado para los filtros y los feeds, y el nombre propio del fabricante para mostrar. “Midnight Graphite” es un buen detalle para la página de producto y un valor de filtro inútil; “gris” es lo contrario. En catálogos multilingües, guarda los valores del vocabulario como códigos independientes del idioma y traduce sus etiquetas, de modo que el mismo producto se filtre correctamente en todos los idiomas de la tienda.

Valores de texto antes y después de la normalización del vocabulario
Valor de texto brutoValor normalizadoRegla del vocabulario
blk / BLACK / schwarzblackLos sinónimos y las traducciones se asignan a un único código
Midnight Graphitegray (se conserva el nombre para mostrar)El nombre comercial se guarda por separado
18/8 SSstainless steelAbreviatura desarrollada; el grado se guarda como atributo propio
Algodón 95 %, elastano 5 %cotton 95; elastane 5Composición como pares valor-porcentaje
Sí / ✓ / incluidotrueBooleanos reducidos a true o false

Asigna los atributos a taxonomías y esquemas de canal

Una taxonomía decide qué atributos se aplican a un producto y cómo se llaman. Rara vez puedes elegir: un minorista puede pedir GS1 GPC, un mayorista ETIM, Shopify su Standard Product Taxonomy, y los buscadores leen el marcado de schema.org. Mantén tu propio esquema de atributos como maestro y conserva una correspondencia con cada taxonomía externa.

En GS1 GPC el brick es el bloque básico, y los atributos del brick recogen detalles como si una leche es de origen animal o no animal. ETIM asigna a cada clase un conjunto predefinido de características con listas de valores fijas y unidades, y publica su modelo en 17 idiomas. Shopify pide una categoría elegida según la función principal del producto; al fijarla se desbloquean los metacampos de categoría. El Product de schema.org tiene propiedades específicas como gtin, mpn, brand, color, material, size y weight.

Comparación de taxonomías de producto
TaxonomíaUsuarios principalesEstructuraModelo de atributosA tener en cuenta
GS1 GPCIntercambio de datos del comercio minorista y de bienes de consumoSegmento > Familia > Clase > BrickAtributos de brick con valores definidosEs una clasificación, no un modelo completo de especificaciones
ETIMComercio mayorista técnico: electricidad, climatización, fontaneríaClases con sinónimosCaracterísticas de tipo alfanumérico, lógico, numérico o de rango, con unidadesLos valores de las características deben salir de las listas de la clase
Shopify Standard Product TaxonomyTiendas ShopifyRuta de categoría o ID de categoríaMetacampos de categoría (atributos de producto) por categoríaEn el CSV indica la ruta o el ID, no ambos
schema.org ProductDatos estructurados para buscadoresUn único tipo Product con propiedadesPropiedades específicas; QuantitativeValue con unitCodeUsa las propiedades específicas antes que additionalProperty

Gestiona las variantes sin duplicar atributos

Las variantes son productos que comparten la mayoría de los atributos y se diferencian en unos pocos. Modélalas como un registro padre con los atributos compartidos y registros hijos que contengan solo los ejes de variante y los valores que cambian con ellos, como el color, la talla, la capacidad y sus propios identificadores. Las reglas del GTIN de GS1 tratan cada variación de estilo, color y talla como un producto único con su propio GTIN, así que el identificador siempre reside en el hijo.

Las tablas de especificaciones con varios modelos causan la mayoría de los errores de variantes. Divide una tabla con una columna por modelo en un registro por columna, y copia cualquier valor impreso una sola vez para varias columnas (una celda combinada o “todos los modelos: 230 V” debajo de la tabla) a cada hijo al que se aplique. En Shopify, la columna CSV Option1 LinkedTo vincula una opción de variante con un metacampo de categoría; un producto puede tener hasta tres opciones y 2048 variantes.

Valida los atributos con reglas y muestreo de control de calidad

Las reglas de validación detectan errores mecánicos: tipo erróneo, unidad errónea, valor imposible, atributo obligatorio ausente. Ejecútalas en cada importación y deriva los fallos a un revisor en lugar de descartar valores en silencio.

Las reglas no pueden detectar un valor verosímil pero erróneo: una capacidad copiada de la columna del modelo vecino pasa todas las comprobaciones. El muestreo de control de calidad sí puede: compara los registros de la muestra con los documentos de origen campo por campo. No existe un tamaño de muestra ni un umbral de error universales; fíjalos según el riesgo.

  1. Extrae una muestra de registros por proveedor, con más peso en los proveedores nuevos y en los diseños de documento nuevos.
  2. Compara cada atributo de la muestra con la fuente, registrando por separado los aciertos, los valores erróneos y los valores ausentes.
  3. Calcula las tasas de error por atributo, no solo por registro, para encontrar los atributos o las asignaciones de encabezados que dan problemas.
  4. Comprueba los atributos relevantes para la seguridad y los exigidos por ley en todos los registros, no en una muestra.
Tipos de reglas de validación con ejemplos
Tipo de reglaEjemploAcción en caso de fallo
Tipo y formatocapacity debe ser un decimal; gtin solo dígitosRechazar el valor y conservar el texto bruto para su revisión
Rango y plausibilidadcapacidad del hervidor entre 0,1 y 5 LSeñalar como probable error de unidad o de separador
Pertenencia a la enumeracióncolor debe estar en la lista de colores baseAsignar el sinónimo o añadirlo al vocabulario
Entre camposmín. ≤ máx.; peso neto ≤ peso brutoSeñalar ambos campos
Dígito de controlEl GTIN supera la comprobación mod-10 de GS1Rechazar; volver a leer desde la fuente
Exhaustividadtodos los atributos obligatorios para la familia y el canal están rellenadosBloquear la publicación; solicitar los datos al proveedor

Normalizar atributos a gran escala

El esquema, las tablas de sinónimos, los vocabularios y las reglas son la parte duradera de este trabajo; el método de extracción puede cambiar por debajo de ellos. Controla sus versiones, asigna un responsable a cada uno, registra las correcciones manuales con su motivo (las correcciones repetidas revelan una regla que falta) y revisa la tabla de sinónimos cada vez que incorpores a un proveedor nuevo.

Si tus atributos nacen en PDF de proveedores, Doc2Shelf puede encargarse de la extracción: lee fichas técnicas, hojas de especificaciones, SDS y catálogos que subas, conserva los valores y las unidades exactamente como figuran impresos con la página y una cita breve como evidencia, y señala los datos obligatorios que faltan. Tus reglas de normalización se aplican después durante la revisión, antes de que el registro alimente listados o borradores de declaraciones.

Preguntas frecuentes

¿Qué son los atributos de producto?
Los atributos de producto son propiedades con nombre y con valor que describen un producto, como el material, el color, la capacidad, las dimensiones o la potencia nominal. A diferencia del texto de la descripción, residen en campos estructurados para poder alimentar filtros, tablas de especificaciones, feeds y requisitos de categoría.
¿Cuál es la diferencia entre un atributo de producto y una variante?
Un atributo es cualquier propiedad de un producto. Una variante es una versión del producto que se diferencia en uno o más atributos entre los que elige el comprador, como la talla o el color. Esos atributos elegibles son las opciones de variante; el resto permanecen compartidos en el producto padre.
¿Cómo extraigo atributos de las descripciones de producto?
Define primero los atributos objetivo y los valores permitidos, divide el texto en frases, busca los valores candidatos y comprueba en cada uno los calificadores, las negaciones y las condiciones antes de asignarlo a un atributo. Confirma con una ficha técnica los atributos que solo aparecen en el texto de marketing.
¿Qué son los códigos de unidad de la Recomendación 20 de la UNECE?
Son códigos de tres caracteres para las unidades de medida utilizadas en el comercio internacional, publicados por UN/CEFACT; por ejemplo, MTR para el metro, KGM para el kilogramo, LTR para el litro y WTT para el vatio. La propiedad unitCode de schema.org usa los mismos códigos.
¿Debo guardar el valor original o el convertido?
Ambos. Guarda el número normalizado y el código de unidad para filtrar, comparar y validar, y conserva el valor tal como figura impreso para garantizar la trazabilidad. Convierte a la unidad que espera cada canal al exportar, por ejemplo gramos para el peso en un CSV de productos de Shopify.
¿Qué taxonomía de producto debo usar: GS1 GPC, ETIM o la de Shopify?
La que pidan tus socios comerciales y tus canales, y a menudo más de una. Mantén tu propio esquema de atributos como maestro y conserva correspondencias con GPC para el intercambio de datos del comercio minorista, con ETIM para el comercio mayorista técnico y con la Standard Product Taxonomy de Shopify para una tienda Shopify.
¿Cómo mido la calidad de la extracción de atributos?
Compara una muestra de registros extraídos con los documentos de origen campo por campo y cuenta por separado los valores correctos, erróneos y ausentes de cada atributo. Los valores erróneos indican problemas de precisión; los ausentes, problemas de exhaustividad (recall). Haz el seguimiento de ambos por proveedor.
¿Cómo gestiono los atributos de producto en varios idiomas?
Guarda los valores enumerados, como colores y materiales, como códigos independientes del idioma con etiquetas traducidas, y mantén los números y los códigos de unidad independientes del idioma. Los atributos de texto libre necesitan traducción y revisión por idioma.

Fuentes oficiales

Textos jurídicos primarios y orientaciones oficiales a los que se hace referencia en esta guía.

Esta guía ofrece información general y no constituye asesoramiento jurídico. Los requisitos dependen del producto y del mercado; consulta los textos oficiales y busca asesoramiento cualificado para tu caso.

Más guías

Convierte los PDF de tus proveedores en datos de producto revisados

Doc2Shelf extrae los datos de producto de los documentos de tus proveedores y redacta borradores de listados y documentos de cumplimiento para que los revises.

Crea tu cuenta gratuita