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:
| Concepto | Finalidad | Ejemplo | Dónde suele ir |
|---|---|---|---|
| Atributo | Describe una propiedad del producto | Material: acero inoxidable; Capacidad: 1,5 L | Tabla de especificaciones, filtros, campos de categoría |
| Identificador | Nombra de forma única el producto o el artículo comercial | GTIN, MPN, SKU, número de modelo | Campos de identificador específicos |
| Opción de variante | Un atributo entre cuyos valores elige el comprador | Color: negro / blanco; Talla: S / M / L | Ejes de variante (Shopify admite hasta 3 opciones) |
| Descripción | Explica 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.
| Atributo | Tipo de datos | Unidad / formato | Valores permitidos o regla | Obligatorio |
|---|---|---|---|---|
| model_number | Texto | — | Tal como lo imprime el fabricante; sin añadir espacios | Sí |
| gtin | Texto (dígitos) | 8, 12, 13 o 14 dígitos | Dígito de control GS1 válido | Si está asignado |
| capacity | Decimal | LTR (litro) | 0,1 a 5,0; un valor por variante | Sí |
| rated_power_min / rated_power_max | Entero | WTT (vatio) | mín. ≤ máx.; ambos de la misma línea de características nominales | Sí |
| body_material | Enum (multivalor) | — | stainless steel, glass, plastic, ceramic | Sí |
| color | Enum | — | Lista de colores base; el nombre comercial se guarda por separado | Sí, por variante |
| net_weight | Decimal | KGM (kilogramo) | > 0; no puede superar el peso bruto | Para 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:
- Enumera los atributos objetivo de la familia de producto, con sus valores permitidos y unidades, antes de leer ningún texto.
- 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 …”.
- 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”).
- 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.
- Normaliza el valor y la unidad con las reglas de las secciones siguientes, conservando el texto original al lado.
- 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.
| Texto de la descripción | Atributo | Valor extraído | Nota |
|---|---|---|---|
| “…un hervidor de acero inoxidable de 1,7 litros…” | capacity; body_material | 1.7 LTR; stainless steel | Dos atributos en una misma expresión |
| “…con tapa de plástico sin BPA…” | lid_material; bpa_free | plastic; true | La negación se convierte en un booleano, no en un material |
| “…no apto para placas de inducción…” | induction_compatible | false | Enunciado negado, invertido |
| “…disponible en negro mate y crema…” | color (opción de variante) | black; beige | Los 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.
| Encabezado tal como se imprime | Atributo canónico | Unidad implícita en el encabezado | Nota |
|---|---|---|---|
| Potencia nominal / Consumo de potencia / Leistung | rated_power | WTT | Comprueba que sea la potencia de entrada, no la de salida |
| Peso neto / Peso (unidad) / Nettogewicht | net_weight | KGM o LBR, según lo impreso | No es el peso de envío |
| Capacidad / Volumen / Fassungsvermögen | capacity | LTR o MLT | Para recipientes, no el volumen del paquete |
| Dimensiones (An × Pr × Al) mm | width, depth, height | MMT | Orden 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.
| Valor bruto tal como se imprime | Valor normalizado | Código UNECE Rec. 20 | Regla aplicada |
|---|---|---|---|
| 1,5 l | 1.5 | LTR | Coma decimal interpretada según la configuración regional del documento |
| 1500 ml | 1.5 | LTR | Convertido a la unidad canónica del atributo; se conserva el original |
| 1.000 W (ficha técnica alemana) | 1000 | WTT | Punto interpretado como separador de millares |
| 220–240 V~ | mín. 220, máx. 240 | VLT | Intervalo dividido; “~” guardado como tipo de corriente CA |
| Ø 12 mm ± 0,2 | nominal 12, tolerancia 0.2 | MMT | Tolerancia guardada por separado |
| aprox. 2,3 kg | 2.3 (calificador: aproximado) | KGM | El calificador se conserva, no se descarta |
| 5 lb | 2.26796 | KGM | Convertido con 0,45359237; se conserva el original en LBR |
| 1/2 in | 12.7 | MMT | Fracción resuelta; se conserva el original en INH |
| Pack de 6 | 6 | H87 | Nú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.
| Valor de texto bruto | Valor normalizado | Regla del vocabulario |
|---|---|---|
| blk / BLACK / schwarz | black | Los sinónimos y las traducciones se asignan a un único código |
| Midnight Graphite | gray (se conserva el nombre para mostrar) | El nombre comercial se guarda por separado |
| 18/8 SS | stainless steel | Abreviatura desarrollada; el grado se guarda como atributo propio |
| Algodón 95 %, elastano 5 % | cotton 95; elastane 5 | Composición como pares valor-porcentaje |
| Sí / ✓ / incluido | true | Booleanos 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.
| Taxonomía | Usuarios principales | Estructura | Modelo de atributos | A tener en cuenta |
|---|---|---|---|---|
| GS1 GPC | Intercambio de datos del comercio minorista y de bienes de consumo | Segmento > Familia > Clase > Brick | Atributos de brick con valores definidos | Es una clasificación, no un modelo completo de especificaciones |
| ETIM | Comercio mayorista técnico: electricidad, climatización, fontanería | Clases con sinónimos | Características de tipo alfanumérico, lógico, numérico o de rango, con unidades | Los valores de las características deben salir de las listas de la clase |
| Shopify Standard Product Taxonomy | Tiendas Shopify | Ruta de categoría o ID de categoría | Metacampos de categoría (atributos de producto) por categoría | En el CSV indica la ruta o el ID, no ambos |
| schema.org Product | Datos estructurados para buscadores | Un único tipo Product con propiedades | Propiedades específicas; QuantitativeValue con unitCode | Usa 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.
- Extrae una muestra de registros por proveedor, con más peso en los proveedores nuevos y en los diseños de documento nuevos.
- Compara cada atributo de la muestra con la fuente, registrando por separado los aciertos, los valores erróneos y los valores ausentes.
- Calcula las tasas de error por atributo, no solo por registro, para encontrar los atributos o las asignaciones de encabezados que dan problemas.
- Comprueba los atributos relevantes para la seguridad y los exigidos por ley en todos los registros, no en una muestra.
| Tipo de regla | Ejemplo | Acción en caso de fallo |
|---|---|---|
| Tipo y formato | capacity debe ser un decimal; gtin solo dígitos | Rechazar el valor y conservar el texto bruto para su revisión |
| Rango y plausibilidad | capacidad del hervidor entre 0,1 y 5 L | Señalar como probable error de unidad o de separador |
| Pertenencia a la enumeración | color debe estar en la lista de colores base | Asignar el sinónimo o añadirlo al vocabulario |
| Entre campos | mín. ≤ máx.; peso neto ≤ peso bruto | Señalar ambos campos |
| Dígito de control | El GTIN supera la comprobación mod-10 de GS1 | Rechazar; volver a leer desde la fuente |
| Exhaustividad | todos los atributos obligatorios para la familia y el canal están rellenados | Bloquear 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.
- GTIN Management Standard: reglas de asignación de GTIN (GS1)
- Cómo calcular manualmente un dígito de control (GS1)
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.