Todos los cursos

Atributos y familias

Qué son los atributos, para qué sirven las familias y por qué mueven el número de completitud.

Transcripción del video

En este video creas atributos y familias, y ves por qué mueven la completitud.

Un atributo es un dato estructurado de tu producto, como el color o el material.

Estos dos llegaron con tu archivo, cada uno con sus valores.

Hay siete tipos: lista, lista múltiple, sí o no, texto, número, fecha y medida.

Crea la talla, de tipo lista…

…y agrégale sus valores.

Una familia agrupa los atributos que le tocan a un tipo de producto.

Crea la familia Ropa…

…marca sus atributos y cuáles son obligatorios. Así Bruxel sabe qué le falta a cada producto.

En la ficha de una playera, asígnale su familia.

Ahora Bruxel sabe qué le falta: tiene dos de sus tres atributos obligatorios.

Llena la talla…

…y la completitud sube: marca, categoría, atributos y contenido suman hasta cien puntos.

Y la IA puede completar los atributos por ti, en un producto o en muchos a la vez.

En el siguiente video agrupas las variantes de un producto.

Qué es un atributo

Un dato estructurado del producto —color, talla, material— que alimenta la descripción y los filtros de tu tienda. Hay siete tipos:

Lista: un valor de un catálogo cerrado (color: rojo).
Lista múltiple: varios valores del mismo catálogo.
Sí/No.
Texto libre.
Número.
Fecha.
Medida: número con una unidad fija (250 ml).

Familias

Una familia agrupa los atributos que le tocan a un tipo de producto. Una playera y una mochila pueden compartir el atributo color, y cada familia decide si es obligatorio o no.

La familia es lo que le permite a Bruxel saber qué le FALTA a un producto: sin ella no hay contra qué comparar.

Una categoría puede llevar una familia por defecto (en su detalle, «Familia por defecto»): los productos sin familia que entren a ella —o a cualquiera de sus subcategorías, que la heredan mientras no declaren la suya— la reciben en el mismo acto. Una familia ya puesta nunca se cambia. Para los productos que ya estaban, la categoría ofrece «Aplicar», que deja fuera a los que están en categorías con familias distintas. Borrar una familia la quita de sus categorías; mover o borrar una categoría solo cambia lo que se asigne después.

Grupos: la ficha en secciones

Un grupo es una sección de la ficha de producto —Datos maestros, SAP, Merch, Ecomm— para repartir el trabajo por equipos. Cada atributo pertenece a un grupo o a ninguno; los sin grupo se muestran al final, en «Otros». La ficha y la grilla ordenan primero por grupo y luego por el orden del atributo.

Los grupos se crean y se ordenan en la página de atributos, o con la columna «group» del CSV de definiciones, que crea el grupo si no existe. A qué grupo va cada atributo se elige en la ficha del atributo, y solo un administrador puede moverlo.

Quitar un grupo no borra nada: sus atributos vuelven a «Otros» y ningún valor cambia. La API pública devuelve el código del grupo en cada atributo.

Listas compartidas de valores

Cuando varios atributos usan los mismos valores —el color del estuche y el color del producto, los tonos de dos líneas de maquillaje—, una lista los escribe una sola vez. Se crea en la página de atributos y cada atributo de lista la elige en su ficha, en «Lista compartida».

Al ligar un atributo, las opciones que ya tenía con el mismo texto se ligan (también si solo cambian mayúsculas y minúsculas), las que faltan se crean y las propias se quedan como estaban. Desde ahí, agregar, renombrar, traducir o quitar un valor en la lista cambia en todos los atributos que la usan, y cada producto afectado gana una versión en su historial.

Una opción que viene de una lista se edita en la lista, no en el atributo. Quitar un valor de la lista no le quita nada a un producto: donde algún producto lo usa, se queda como opción propia del atributo. Dejar de usar una lista, o borrarla, tampoco borra opciones.

Cómo se calcula la completitud

Cada producto suma hasta 100 puntos en cuatro partes:

Parte	Puntos	Cómo se llena
Marca y categoría	25	La mitad por cada una.
Atributos	25	Atributos obligatorios de su familia que ya tienen valor.
Contenido	35	Idiomas con descripción publicada, sobre los que configuraste.
Imagen principal	15	Una imagen lista en la ficha: la principal o, si no marcaste ninguna, la primera de la galería. Es la que tu tienda recibe como imagen base.

Si un producto no tiene familia —o su familia no marca ninguno como obligatorio— los 25 puntos se reparten entre todos los atributos que definiste en el catálogo: llenar la mitad da la mitad de los puntos.

Rellenar con IA

En vez de llenar atributo por atributo, puedes seleccionar productos y pedir que la IA los complete a partir de lo que ya sabes de ellos. Cuesta créditos y solo cobra los que sí logra llenar.

El código en tu tienda

Cada atributo tiene un code en Bruxel, derivado de su nombre. Si tu tienda (Adobe Commerce) lo conoce con otro attribute_code, cáptalo en la ficha del atributo, en «Código en tu tienda»: el CSV de descarga para Adobe Commerce y la API pública usan ese código como nombre de la columna, así el import de tu tienda encuentra el atributo sin que renombres columnas a mano.

Solo admite letras, dígitos y guion bajo, y no puede repetirse entre dos atributos de tu organización (serían dos columnas iguales). Déjalo vacío para volver al code de Bruxel. Las selecciones de columnas de Descargas y los canales guardados no cambian: siguen usando el code.

Importar atributos desde un CSV

Si ya tienes tus atributos definidos en una hoja, no hace falta capturarlos uno por uno: en «Importar atributos (CSV)» subes un archivo con una fila por atributo y Bruxel te muestra qué haría antes de tocar nada. La plantilla descargable trae una fila de ejemplo por tipo.

Columnas: code (opcional; si va vacío se deriva del nombre), name, type (select, multiselect, boolean, text, number, date, metric), unit (solo metric), filterable (sí/no), external_code (el código en tu tienda), values (separados por |, solo select y multiselect) y label_en, label_fr, label_pt para las etiquetas por idioma. Los encabezados admiten mayúsculas, acentos y su versión en español (código, nombre, tipo, valores…).
Un atributo que ya existe se reconoce por su code y se actualiza: nombre, filtrable, código en tu tienda, etiquetas y valores nuevos. Uno que no existe se crea. Nada se borra: ni atributos, ni valores que no vengan en el archivo, ni etiquetas de otros idiomas.
Lo que no se puede aplicar se reporta por fila con su motivo (tipo inválido, unidad faltante, código externo repetido) y las demás filas siguen. Un cambio de tipo que dejaría valores inconsistentes se avisa y no se aplica.

Subir el mismo archivo dos veces no cambia nada: la segunda revisión dice «sin cambios» en todas las filas. Tope: 1 MB por archivo.

Reglas para los valores

Un atributo de selección o de texto puede llevar reglas que corren, en orden, sobre cada valor que entra: convertir una unidad (número + unidad → número × factor + otra unidad), reemplazar un texto por otro, prohibir un patrón o exigir uno. El caso típico: un tamaño con valores en onzas y en mililitros mezclados — con «convertir oz → ml, factor 29.5735» un «1.7 OZ» entra como «50 ml», y con «prohibir oz» lo que no se pudo convertir se rechaza con el mensaje que tú escribas.

Bruxel no trae tabla de conversiones: «oz» puede ser masa o volumen, así que el factor lo confirmas tú (hay atajos que rellenan el formulario). Las reglas aplican a lo que entra por la pantalla de atributos, por el import de atributos y por la API. Para lo que ya estaba guardado, «Revisar los valores actuales» te muestra qué cambiaría cada valor y «Aplicar» lo hace: si dos opciones quedan iguales se fusionan y sus productos pasan a la que queda.

Los patrones son expresiones regulares acotadas: sin grupos repetidos ni retro-referencias, y se miden al guardar; un patrón demasiado costoso se rechaza. Las reglas no aplican a números, medidas, fechas ni sí/no, que ya validan su forma.

Reglas de captura: cuándo se pide un dato y de dónde sale

Además de las reglas de los valores, cualquier atributo —de cualquier tipo— puede llevar reglas de captura. Se arman en su ficha, en «Reglas», con selectores de atributo, estructura y categoría, y las cambia un operador o un administrador:

Se pide cuando…: si se cumple la condición (por ejemplo, «importado o nacional» es Importado) y el campo está vacío, la ficha lo avisa junto al campo y el import lo reporta por fila. Solo avisa: el producto se guarda y se importa igual.
Se oculta cuando…: sirve para el formulario de alta del proveedor, que no enseñará el campo cuando la condición se cumpla. La ficha y la grilla lo enseñan siempre.
Se deriva de…: el valor lo pone el sistema desde un valor fijo, otro atributo (con un mapa: «cuando vale loyalty, pon ZMYP; si no, ZMOD»), un código de la categoría o un código de la marca. Puede aplicar siempre o solo cuando se cumple una condición.
Comparar con otro: en un número o una medida, avisa cuando no cumple la comparación con otro atributo (el precio de venta por debajo del de compra, el peso neto por encima del bruto).

Un atributo derivado no lo escribe nadie mientras su regla aplica, ni el propietario: la ficha y la grilla lo enseñan con candado y la API responde que el valor lo pone el sistema. Se recalcula solo al escribir su origen, al importar, al categorizar el producto y al cambiar su marca, en la misma versión del historial que el cambio que lo movió. Una regla nueva, o un código de categoría o de marca que cambió, no reescribe lo que ya estaba: en «Reglas», «Aplicar a lo existente» cuenta cuántos productos cambiarían y los aplica por vueltas de mil.

Un atributo lleva una sola derivación, y un derivado no se deriva de otro ni condiciona a otro. Cuando la condición de un derivado deja de cumplirse, el valor que puso la regla se quita y el campo queda libre. Borrar un atributo o una opción que una regla nombra se rechaza hasta quitarlo de la regla; renombrarlos reescribe las reglas solas.

Convertir una lista en medida

Si las opciones de una lista son medidas escritas como texto («50 ml», «1.7 OZ», «100 g»), «Convertir a medida» las pasa a atributos de tipo Medida. Desde el detalle de la lista, «Revisar las opciones» agrupa las opciones por la unidad que traen escrita y te dice cuántos productos usa cada grupo; después eliges a dónde va cada medida y confirmas.

Cada medida (volumen, peso, longitud) va a un atributo de medida que ya tengas o a uno nuevo que se crea en ese momento. El número se guarda convertido a la unidad del destino, redondeado a 4 decimales.
«oz» puede ser volumen (un perfume) o peso (un labial), y la lista no dice cuál. Tú decides: mandarlo a una de las dos medidas o dejarlo como está; por defecto se queda. Si tu catálogo trae una columna que distingue los productos —la categoría, por ejemplo—, puedes decidirlo por cada valor: las fragancias a volumen, los labiales a peso.
Las opciones que no son una medida —sin unidad reconocible, o en cero como «0.00 OZ»— no se mueven y se listan aparte.

La lista se conserva con sus opciones y sus productos: el CSV que hoy sale de ella no cambia hasta que cambies la columna de tu canal. Un producto que ya tenía valor en el destino lo conserva. Cada producto convertido queda en su historial. Convertir pide rol de operador, y un destino protegido, de administrador.

Cambiar el código de un atributo

El code se deriva del nombre al crear el atributo y desde entonces es su identidad: nombra la columna en el CSV para Adobe Commerce (si no tiene código en tu tienda), es la fuente de las columnas de tus canales guardados y la ruta de la API pública. Por eso hasta ahora no se podía cambiar. Desde la ficha del atributo, «Cambiar código» te muestra cómo quedará normalizado, si otro atributo ya lo usa y qué canales cambian de fuente, y solo después confirmas.

Los canales guardados se actualizan solos (su columna apunta al código nuevo; el encabezado que escribiste no cambia). Lo que NO se actualiza solo: las integraciones que llaman a la API pública por el código viejo reciben 404, y un CSV de atributos que traiga el código viejo crearía un atributo nuevo. Cámbialos tú.