Atributos y variantes
Si vendes el mismo producto en distintas combinaciones (camisa talla S/M/L en azul y rojo), no necesitas crear seis productos separados. Modélalo como un producto base + atributos + variantes.
Ubicación: Inventario → Atributos.
Conceptos
| Concepto | Tabla | Ejemplo |
|---|---|---|
| Atributo | product_attributes | "Talla", "Color", "Sabor". |
| Valor de atributo | product_attribute_values | Talla: S / M / L. Color: Rojo / Azul. |
| Variante | product_variants | Camisa-Talla M-Color Azul. |
| Valores de la variante | product_variant_values | Vincula la variante a sus valores. |
Cada variante es un producto con su propio SKU, precio, costo y estado activo.
Cuándo usar variantes
| Caso | Modelo |
|---|---|
| Camisa S/M/L en azul/rojo | 1 producto + 2 atributos + 6 variantes |
| Bebida en 250 ml / 500 ml / 1 L | 1 producto + 1 atributo + 3 variantes |
| Mismo producto sin combinaciones | Solo producto base; no necesitas variantes |
| Productos completamente distintos | Productos separados, no variantes |
Importante. Si todas las combinaciones tienen precios idénticos y el inventario no las distingue, no uses variantes: sobre-complicas. Variantes brillan cuando cada combinación tiene SKU / precio / stock propios.
Paso 1 · Crear atributos
Crear el atributo
Inventario → Atributos → Nuevo atributo.
| Campo | Detalle |
|---|---|
| Nombre | Máx. 80 caracteres (ej. "Talla", "Color"). |
Agregar valores
Dentro de cada atributo, añade los valores posibles:
| Campo | Detalle |
|---|---|
| Valor | Máx. 80 caracteres (ej. "S", "M", "L"). |
Buena práctica. Nombres cortos para valores; aparecen en selectores y tablas. "S" mejor que "Pequeño/a tamaño S".
Paso 2 · Crear variantes del producto
Cuando ya tienes el producto base (ver Productos y servicios) y los atributos:
Abre el editor de variantes
Desde el producto: pestaña / botón Variantes.
Generar variantes
Tienes dos modos:
- Manual — defines cada variante por su combinación de valores.
- Generación automática — eliges 2 o más atributos; FinMova genera todas las combinaciones posibles (cartesiano).
Campos de una variante
| Campo | Obligatorio | Detalle |
|---|---|---|
| SKU | — | Máx. 60. Identificador único de esa variante. Recomendado para inventario. |
| Precio | ✅ | ≥ 0. |
| Costo | ✅ | ≥ 0. |
| Valores de atributo | ✅ | Uno por cada atributo (no puedes dejar variantes "mixtas"). |
| Activa | — | Por defecto sí. |
Cuidado. Si tu producto tiene 2 atributos (Talla × Color) con 3 y 4 valores respectivamente, la generación automática crea 12 variantes. Asegúrate de querer todas antes de generar; el trabajo de limpiarlas después es mayor.
Cómo aparecen las variantes al facturar
Hoy: las variantes son una vista organizada de productos con combinaciones. Al facturar, eliges el SKU de la variante correspondiente.
Nota. La integración fina "elige producto → desplegable de variante" en el formulario de factura está en evolución. Si tu versión del producto aún no lo muestra así, captura la variante directamente como ítem en la línea (su SKU sirve).
Inventario y variantes
Cada variante puede tener su propio stock por almacén si está
configurada con track_inventory. Esto sí se modela hoy: cada
variante es, a efectos de stock, un producto separado.
Detalle: Almacenes y existencias.
Editar / desactivar / eliminar variantes
| Acción | Cómo |
|---|---|
| Editar precio / costo / SKU | Desde la pestaña Variantes del producto. |
| Desactivar | Desmarca Activa. Oculta de selectores; histórico se mantiene. |
| Eliminar | Solo posible si la variante no tiene movimientos (facturas, inventario). |
Buenas prácticas
- Define atributos genéricos. "Talla" sirve para camisas y pantalones; "Talla de camisa" no.
- No abuses. 3+ atributos generan combinatorias inmanejables. Si tienes "Talla × Color × Material × Estampado", probablemente necesitas productos separados o un solo SKU genérico.
- SKUs significativos. "CAM-AZ-M" mejor que "VAR000123".
- Borra valores no usados antes de que un valor aparezca en alguna variante; después la BD bloquea el borrado.
Cómo se relaciona con listas de precios
Hoy Listas de precios funcionan a nivel de producto. La interacción con variantes —precio de "camisa-S-azul" en Mayoreo distinto al de Minorista— está en evolución; verifica la versión activa en la app.
Errores comunes
- "Selecciona al menos un valor de atributo" — no puedes guardar una variante sin asociarla a un valor de cada atributo configurado.
- SKU duplicado — los SKUs deben ser únicos.
- "El atributo está en uso" al intentar eliminar — primero borra todas las variantes que lo referencian.
Siguientes pasos
- Productos y servicios — el producto base.
- Almacenes y existencias — stock por variante.
- Valor de inventario — el reporte sumar variantes.
Manifiesto de capturas
assets/inventario/12-form-atributo.png— atributo "Talla" con valores S/M/L.assets/inventario/13-generar-variantes.png— botón generar y preview de las 6 variantes.assets/inventario/14-tabla-variantes.png— tabla con SKU, valores, precio y stock por variante.
Última actualización: