🗂️ Manual de Usuario — Configuración de Familias (Categorías)

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

Índice

1. ¿Qué es una familia?
2. ¿Por qué es importante configurar las familias?
3. Concepto de niveles y jerarquía
4. Cómo acceder
5. Crear una familia nueva
6. Campos del formulario
7. Editar y eliminar familias
8. Ejemplos completos por tipo de negocio
   • 8.1 Kiosco
   • 8.2 Verdulería / Frutería
   • 8.3 Ferretería
   • 8.4 Zapatería / Indumentaria
9. Orden recomendado para cargar familias
10. Preguntas frecuentes

1. ¿Qué es una familia?

Una familia es la categoría o grupo al que pertenece un producto. Sirve para organizar el catálogo de productos del negocio de forma ordenada y jerárquica.

💡 Ejemplo:
Bebidas es una familia de primer nivel.
Bebidas > Gaseosas es una subfamilia.
Bebidas > Gaseosas > Cola es una subfamilia de tercer nivel.

Cada producto debe tener exactamente una familia asignada. Por eso es importante tener las familias configuradas antes de empezar a cargar productos.

2. ¿Por qué es importante configurar las familias?

• Organización: permite ordenar el catálogo por rubros y subrubros
• Búsqueda y filtros: en ventas y reportes se puede filtrar por familia
• Obligatoria: el sistema requiere que todo producto tenga una familia asignada
• Reportes: las ventas y el stock se pueden analizar por familia

3. Concepto de niveles y jerarquía

Las familias se organizan en árbol jerárquico con niveles:

Nivel 1 (primer nivel — sin familia padre)
├── Nivel 2 (subfamilia de un nivel 1)
│   ├── Nivel 3 (subfamilia de un nivel 2)
│   └── Nivel 3
└── Nivel 2

Ejemplo para una ferretería:

Herramientas                    ← Nivel 1
├── Herramientas manuales       ← Nivel 2
│   ├── Percusión               ← Nivel 3
│   ├── Corte                   ← Nivel 3
│   └── Medición                ← Nivel 3
└── Herramientas eléctricas     ← Nivel 2
    ├── Taladros                 ← Nivel 3
    └── Amoladoras               ← Nivel 3

Electricidad                    ← Nivel 1
├── Cables                      ← Nivel 2
├── Llaves y tomacorrientes      ← Nivel 2
└── Iluminación                  ← Nivel 2

💡 Recomendación: usar 2 o 3 niveles es suficiente para la mayoría de los negocios. No es necesario crear una jerarquía muy profunda.

Regla del nivel

El nivel se calcula automáticamente: al seleccionar una familia padre, el sistema asigna automáticamente el nivel siguiente. No hay que ingresarlo manualmente.

4. Cómo acceder

1. En el menú lateral, ir a Familias (o Productos → Familias)
2. Se muestra el listado con filtros por nombre y nivel

┌─ Familias ──────────────────────────────────────────────────────┐
│ Filtros: [ Nombre...        ] [ Nivel ▼ ]          [🔍 Buscar]  │
├─────────────────────────────────────────────────────────────────┤
│  ID │ Nombre              │ Nombre corto │ Nivel   │ Padre      │
│ ────────────────────────────────────────────────────────────    │
│   1 │ Bebidas             │ BEB          │ Nivel 1 │ —          │
│   2 │ Gaseosas            │ GAS          │ Nivel 2 │ Bebidas    │
│   3 │ Golosinas           │ GOL          │ Nivel 1 │ —          │
│   4 │ Alfajores           │ ALF          │ Nivel 2 │ Golosinas  │
└─────────────────────────────────────────────────────────────────┘
                                              [+ Nueva familia]

Para crear una familia nueva hacer clic en ➕ Nueva familia.
Para editar, hacer clic en el nombre de la familia y luego en el ícono ✏️.
Para eliminar, hacer clic en el ícono 🗑️ (solo si la familia no tiene productos asignados).

5. Crear una familia nueva

1. Hacer clic en ➕ Nueva familia
2. Se abre el formulario
3. Completar los campos (ver sección siguiente)
4. Hacer clic en 💾 Guardar o 💾 Guardar y volver

6. Campos del formulario

┌─ Datos básicos ──────────────────────────────────────────────────┐
│                                                                    │
│  Nombre de la familia       │  Nombre corto                       │
│  ────────────────────────   │  ────────────────                   │
│  [Bebidas              ]    │  [BEB          ]                    │
│                                                                    │
│  ¿Es familia de primer nivel?   │  Nivel                          │
│  ─────────────────────────────  │  ─────────                      │
│  [SI ▼]                         │  [1] ← solo lectura             │
│  SI: sin padre | NO: depende de otra                              │
│                                                                    │
│  Familia padre  (aparece solo si NO es primer nivel)              │
│  ──────────────────────────────────────────────────               │
│  [Seleccionar familia padre...  ▼]                                │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

Descripción de cada campo

Campo “Nombre corto”

El nombre corto es una abreviatura única que identifica la familia en el sistema. Se usa en reportes y filtros rápidos.

• Debe ser único: si ya existe otro con el mismo nombre corto, el sistema muestra un error en tiempo real
• Se recomienda usar 2 a 6 letras en mayúsculas
• Ejemplos: BEB, GAS, GOL, ALF, HER, ELEC

Campo “¿Es familia de primer nivel?”

Al seleccionar NO, aparece el selector Familia padre para elegir de cuál depende. El campo Nivel se actualiza automáticamente.

8. Ejemplos completos por tipo de negocio

⚠️ Importante: siempre crear las familias de nivel 1 primero, luego las de nivel 2, y así sucesivamente. No se puede asignar una familia padre que todavía no existe.

8.1 Kiosco

Un kiosco tiene principalmente golosinas, bebidas, cigarrillos y servicios. Con 2 niveles es suficiente.

Familias de primer nivel (crear primero)

Subfamilias de nivel 2

8.2 Verdulería / Frutería

Un negocio de frutas y verduras trabaja principalmente con dos rubros. El nivel de detalle puede ser simple.

Familias de primer nivel

Subfamilias de nivel 2

💡 Para un negocio chico con poca variedad, puede ser suficiente usar solo el nivel 1: Verduras y Frutas.

8.3 Ferretería

Una ferretería tiene gran variedad de rubros. Se recomienda usar 2 o 3 niveles.

Familias de primer nivel

Subfamilias de nivel 2

Subfamilias de nivel 3 (opcional, para mayor detalle)

8.4 Zapatería / Indumentaria

Una zapatería o negocio de ropa organiza por tipo de artículo y género/edad.

Familias de primer nivel

Subfamilias de nivel 2

Subfamilias de nivel 3 (opcional)

9. Orden recomendado para cargar familias

Siempre respetar este orden:

1️⃣  Crear todas las familias de Nivel 1 (primer nivel = SI)
         ↓
2️⃣  Crear las familias de Nivel 2 (asignarles padre del Nivel 1)
         ↓
3️⃣  Si se necesita, crear las familias de Nivel 3 (asignarles padre del Nivel 2)
         ↓
4️⃣  Recién ahora → cargar productos y asignarles familia

⚠️ Si se intenta crear una subfamilia antes que su familia padre, el padre no aparecerá en la lista para seleccionar.

10. Preguntas frecuentes

¿Cuántos niveles puedo crear?
El sistema no tiene un límite fijo de niveles. Sin embargo, para la mayoría de los negocios con 2 o 3 niveles es más que suficiente. Una jerarquía muy profunda puede complicar la operación diaria.

¿Puedo mover una familia a otro padre después de crearla?
Sí. Al editar la familia se puede cambiar la familia padre. El nivel se recalcula automáticamente. Los productos ya asignados a esa familia no se ven afectados.

¿Puedo eliminar una familia que tiene subfamilias o productos?
No. Para eliminar una familia, primero hay que reasignar o eliminar todos los productos y subfamilias que dependen de ella.

¿El nombre corto puede tener espacios o caracteres especiales?
Se recomienda usar solo letras y números, sin espacios ni acentos. Ejemplos: BEB, GASO, CALZ2. El sistema valida en tiempo real si el nombre corto ya existe.

¿Qué pasa si dos familias tienen el mismo nombre (pero diferente padre)?
El sistema permite nombres iguales en familias distintas (ej: Infantil dentro de Calzado e Infantil dentro de Indumentaria). Lo que debe ser único es el nombre corto.

¿Puedo renombrar una familia ya en uso?
Sí. Al editar el nombre, los productos que ya tienen esa familia asignada se actualizan automáticamente.

¿Las familias se comparten entre sucursales?
Sí, las familias son globales para toda la empresa y se ven en todas las sucursales.

Resumen del flujo

Familias → Nuevo
  └─ ¿Es primer nivel? = SI
      └─ Nombre: "Bebidas"  |  Nombre corto: "BEB"
      └─ Guardar ✅

Familias → Nuevo
  └─ ¿Es primer nivel? = NO
      └─ Nombre: "Gaseosas"  |  Nombre corto: "GAS"
      └─ Familia padre: "Bebidas"  → Nivel: 2 (automático)
      └─ Guardar ✅

Productos → Nuevo producto
  └─ Categoría (familia): "Gaseosas" ← ya disponible para seleccionar

Manual generado para el sistema Yagware — Módulo de Familias
Ver también: Manual de Carga de Productos · Manual de Atributos de Variante