⚙️ Manual de Usuario — Configuración de Atributos de Variante

Sistema: Yagware
Módulo: Configuración
Versión: 1.0
Fecha: Abril 2026

Índice

1. ¿Qué es un atributo de variante?
2. ¿Cuándo necesito configurar atributos?
3. Cómo acceder
4. Crear un atributo nuevo
5. Modos de ingreso: Opciones vs Libre
6. Gestionar los valores de un atributo
7. Editar un atributo existente
8. Ejemplos por tipo de negocio
   • 8.1 Zapatería
   • 8.2 Ropa y Indumentaria
   • 8.3 Ferretería
   • 8.4 Pinturería
9. Preguntas frecuentes

1. ¿Qué es un atributo de variante?

Un atributo de variante es una característica que diferencia las presentaciones de un mismo producto. Permite que el sistema registre y controle stock por cada combinación de variantes.

💡 Ejemplo:
El producto “Zapatilla Running” se vende en varios talles y colores.

• Talle → es un atributo
• 38, 39, 40 → son los valores de ese atributo
• Color → es otro atributo
• Negro, Blanco → son los valores de ese atributo

Al combinar Talle 38 + Color Negro se obtiene una presentación específica con su propio stock y código de barra.

2. ¿Cuándo necesito configurar atributos?

Configurar atributos es necesario cuando el negocio vende productos que se diferencian por características como talle, color, medida, material, etc., y es importante controlar el stock de cada variante por separado.

⚠️ Si el negocio no vende productos con variantes, no es necesario configurar atributos. Se puede saltear esta sección.

3. Cómo acceder

1. En el menú lateral, ir a Configuración
2. Seleccionar Atributos de variante
3. Se muestra el listado de atributos existentes

┌─ Atributos de variante ──────────────────────────────────────┐
│  Nombre     │ Modo         │ Valores          │ Activo │     │
│ ────────────────────────────────────────────────────────     │
│  Talle      │ Predefinidos │ 36, 37, 38...    │  ✅    │ ✏️ │
│  Color      │ Predefinidos │ Negro, Blanco...  │  ✅    │ ✏️ │
│  Medida     │ Libre        │ (el usuario escribe) │ ✅ │ ✏️ │
└──────────────────────────────────────────────────────────────┘
                                              [+ Nuevo atributo]

4. Crear un atributo nuevo

1. En el listado de atributos, hacer clic en ➕ Nuevo atributo
2. Se abre el formulario con dos secciones

Sección: Datos del atributo

┌─ Datos del atributo ───────────────────────────────────────────┐
│                                                                  │
│  Nombre del atributo        │  Tipo                             │
│  ─────────────────────────  │  ─────────────────                │
│  [Talle                  ]  │  [Texto          ▼]               │
│                                                                  │
│  Modo de ingreso                                                 │
│  ─────────────────────────                                       │
│  [Opciones predefinidas   ▼]                                     │
│                                                                  │
└────────────────────────────────────────────────────────────────┘

3. Completar los campos y hacer clic en 💾 Guardar

5. Modos de ingreso: Opciones vs Libre

El modo de ingreso define cómo se elige el valor del atributo al cargar una presentación de producto.

Modo: Opciones predefinidas

El usuario elige de una lista de valores que se cargan previamente.

Cuándo usarlo: cuando los valores son conocidos y finitos (talles numéricos, colores estándar, materiales fijos).

Talle: [ 38 ▼ ]   ← desplegable con los valores cargados
Color: [ Negro ▼ ] ← desplegable con los valores cargados

✅ Ventaja: evita errores de tipeo, mantiene consistencia en el stock.

Modo: Ingreso libre (texto)

El usuario escribe el valor manualmente al asignarlo a cada presentación.

Cuándo usarlo: cuando los valores son muy variables o no se pueden predefinir (medidas exactas, especificaciones técnicas).

Medida: [ 30x45 cm        ] ← campo de texto libre
Espesor: [ 2.5 mm          ] ← campo de texto libre

✅ Ventaja: máxima flexibilidad, no requiere cargar valores previos.
⚠️ Atención: el sistema no puede validar el formato; depende del criterio del operador.

6. Gestionar los valores de un atributo

Esta sección solo aparece cuando el modo de ingreso es “Opciones predefinidas”. Si el modo es “Libre”, no hay valores que cargar.

Agregar valores

┌─ Valores del atributo ─────────────────────────────────────┐
│  #  │ Valor     │ Orden │                                   │
│ ────────────────────────────────────────────────────────   │
│  1  │ [36     ] │ [1  ] │                              ➖  │
│  2  │ [37     ] │ [2  ] │                              ➖  │
│  3  │ [38     ] │ [3  ] │                         ➕   ➖  │
└────────────────────────────────────────────────────────────┘

• Hacer clic en ➕ para agregar un nuevo valor
• En el campo Valor escribir el nombre (ej: 38, Negro, Marrón)
• El campo Orden define el orden en que aparecen en el selector
• Para eliminar un valor, hacer clic en ➖

⚠️ Importante: No eliminar valores que ya estén asignados a presentaciones de productos. Si se necesita deshabilitar un valor, lo recomendable es no usarlo en nuevos productos en lugar de eliminarlo.

Guardar los valores

Una vez cargados todos los valores, hacer clic en 💾 Guardar (o 💾 Guardar y volver).

7. Editar un atributo existente

1. En el listado, hacer clic en el ícono ✏️ del atributo
2. Se carga el formulario con los datos actuales
3. Se puede modificar el nombre, el modo o agregar/quitar valores
4. Hacer clic en 💾 Guardar

💡 Si se cambia el modo de ingreso de un atributo que ya tiene productos asignados, los valores existentes en esos productos no se borran, pero en nuevas asignaciones se usará el nuevo modo.

8. Ejemplos por tipo de negocio

8.1 Zapatería

Una zapatería típica necesita al menos dos atributos: Talle y Color.

Atributo 1: Talle (calzado adulto)

Valores a cargar:

Atributo 2: Color

Valores a cargar:

Atributo 3 (opcional): Talle infantil

Si se vende calzado infantil con talles distintos, conviene crear un atributo separado para evitar confusión con el calzado adulto.

Valores: 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34

8.2 Ropa y Indumentaria

Atributo 1: Talle de ropa

Valores:

💡 Si también se vende ropa con talle numérico (36, 38, 40…), se puede usar el mismo atributo agregando los valores numéricos, o crear un segundo atributo Talle Numérico.

Atributo 2: Color

Mismo que zapatería — ver sección 8.1.

Atributo 3 (opcional): Material / Composición

Valores sugeridos: Algodón, Poliéster, Lana, Jean / Denim, Lino, Cuero, Seda

8.3 Ferretería

Atributo 1: Medida (para perfiles, caños, madera)

Cuando las medidas son muy variadas y no se pueden predefinir todas:

No requiere cargar valores. El operador escribe la medida al crear cada presentación: "2 pulgadas", "1/2 pulgada", "30x40mm", etc.

Atributo 2: Material (para artículos con variante de material)

Valores:

Atributo 3: Diámetro / Calibre

El operador escribe: "6mm", "8mm", "1/4 pulgada", etc.

8.4 Pinturería

Atributo 1: Color

En una pinturería el color se puede manejar de dos formas:

Opción A — Colores de catálogo fijos (pocas opciones):

Valores: Blanco, Negro, Rojo, Azul, Verde, Amarillo, Gris, Beige

Opción B — Colores mezclados a pedido (muchas combinaciones):

El operador escribe el nombre o código del color: "Blanco Hueso", "Azul Francia", "RAL 7016", etc.

Atributo 2 (opcional): Terminación

Valores: Mate, Satinado, Semi-brillante, Brillante

9. Preguntas frecuentes

¿Puedo tener un atributo para zapatería y otro para ropa al mismo tiempo?
Sí. Los atributos son globales, pero solo se asignan a los productos donde corresponda. Al crear un producto, se ven todos los atributos configurados y el operador completa solo los que aplican.

¿Qué pasa si me olvidé de cargar un valor de talle (ej: talle 45)?
Se puede editar el atributo en cualquier momento y agregar el valor faltante. No afecta los productos ya cargados.

¿Puedo eliminar un valor de atributo que ya está asignado a productos?
Técnicamente sí, pero no se recomienda porque puede afectar el historial de stock y ventas de esas presentaciones. Lo mejor es dejar el valor y simplemente no usarlo en nuevos productos.

¿Se pueden tener dos atributos con el mismo nombre?
No es recomendable ya que generaría confusión. Si se necesita diferenciar (ej: talle de calzado vs talle de ropa), usar nombres distintos: Talle Calzado y Talle Ropa.

¿Los atributos se comparten entre sucursales?
Sí, los atributos son configuraciones globales del sistema que aplican a todas las sucursales.

¿Cuántos atributos puedo crear?
No hay límite. Sin embargo, se recomienda no crear más atributos de los necesarios para mantener el sistema ordenado.

¿Qué hago si el producto que quiero cargar no tiene el campo de atributos?
Verificar que el producto tenga activado “Control de stock por variante” en la configuración avanzada (⚙️ en Datos básicos). Sin ese ajuste, la sección de atributos no aparece.

Resumen del flujo completo (zapatería como ejemplo)

1. Configuración → Atributos de variante
   └─ Crear atributo "Talle" (Opciones: 35, 36, 37... 44)
   └─ Crear atributo "Color" (Opciones: Negro, Blanco, Marrón...)

2. Productos → Nuevo producto
   └─ Datos básicos:
       ├─ Nombre: "Zapatilla Running Air Max"
       ├─ Categoría: Calzado / Deportivo
       └─ ⚙️ Control de stock: Por variante ← IMPORTANTE
   
   └─ Presentaciones (una fila por cada combinación):
       ├─ [Talle 38 Negro] → expandir ▶ → Talle: 38 | Color: Negro
       ├─ [Talle 39 Negro] → expandir ▶ → Talle: 39 | Color: Negro
       └─ [Talle 38 Blanco] → expandir ▶ → Talle: 38 | Color: Blanco
   
   └─ Guardar ✅

Manual generado para el sistema Yagware — Módulo de Configuración
Ver también: Manual de Carga de Productos