Categorías
Agrupar productos por categoría para reportes, filtros del catálogo y proveedor habitual.
Resumen: las Categorías son el árbol con el que organizas tu catálogo. Sirven para filtrar productos, agrupar reportes y vincular el proveedor habitual de un grupo de productos. Soportan jerarquía padre/hijo.
Tiempo de lectura: ~4 min
Cuándo usar esto
Lee este artículo si necesitas:
- Crear el árbol inicial de categorías de tu catálogo (por ejemplo Bebidas → Refrescos → Cola).
- Reasignar productos a otra categoría.
- Vincular una categoría a un proveedor por defecto para acelerar las órdenes de compra.
- Eliminar una categoría que ya no usas.
Antes de empezar
- Necesitas el permiso
categories:createocategories:update. - Si vas a vincular un proveedor a la categoría, créalo primero en Proveedores.
- Para construir un árbol, planifica primero las categorías padre antes que las hijas.
Paso a paso
Crear una categoría
- Entra al módulo. En la barra lateral pulsa Operaciones → Categorías. (captura: árbol de categorías)
- Pulsa "Nueva categoría" en la cabecera.
- Llena el formulario.
- Nombre (obligatorio) - texto visible (ej.
Bebidas). - Slug (obligatorio) - identificador URL-amigable. Se genera automático desde el nombre (
bebidas); puedes editarlo. Solo letras, números y guiones. - Descripción (opcional) - nota interna para el equipo.
- Categoría padre (opcional) - selecciona otra categoría existente. Déjalo vacío si es de primer nivel. Esto crea la jerarquía.
- Proveedor (opcional) - proveedor habitual de los productos de esta categoría. Pre-llena el proveedor en órdenes de compra cuando seleccionas productos de esta categoría.
- Orden de aparición - entero (0, 1, 2…). Las categorías de menor número se muestran primero.
- Activo - apaga el switch para ocultar la categoría sin eliminarla.
- Nombre (obligatorio) - texto visible (ej.
- Pulsa "Crear".
Construir una jerarquía
Mosce ERP soporta árbol de categorías sin límite de profundidad. Para crear Bebidas → Refrescos:
- Crea primero Bebidas (sin padre).
- Crea Refrescos y en Categoría padre selecciona Bebidas.
- Repite el patrón para los niveles que necesites.
Al editar una categoría, no puede ser su propia padre ni descendiente (el selector la excluye automáticamente).
Asignar productos a una categoría
La asignación se hace desde el producto, no desde la categoría:
- Entra a Operaciones → Productos y abre el producto que quieres clasificar.
- En la sección Categorización, selecciona la categoría.
- Guarda los cambios.
Para reasignar muchos productos, edítalos uno por uno; no hay acción masiva en esta versión.
Editar una categoría
Pulsa el ícono de lápiz en la lista. Cambia nombre, padre, proveedor o estado y pulsa Actualizar.
Eliminar una categoría
Pulsa el ícono de basura. La eliminación tiene dos restricciones explícitas:
- No se puede borrar si tiene subcategorías. El sistema responde con
CATEGORY_HAS_CHILDREN. Reasigna o elimina las hijas primero. - No se puede borrar si tiene productos asociados. El sistema responde con
CATEGORY_HAS_PRODUCTS. Reasigna esos productos a otra categoría (o quítale la categoría) antes.
Cuando ya no tiene hijas ni productos, la eliminación es definitiva (no es soft delete).
Resultado esperado
- La categoría aparece en el selector cuando creas o editas un producto.
- El árbol se respeta en filtros y reportes que agrupan por categoría.
- Si vinculaste proveedor, las órdenes de compra de productos de esa categoría preseleccionan ese proveedor.
Errores comunes
| Error | Causa | Solución |
|---|---|---|
| "Solo letras, números y guiones" en el slug | El slug tiene espacios, tildes o símbolos. | Usa solo a-z, 0-9 y -. El generador automático ya cumple esta regla. |
CATEGORY_HAS_CHILDREN al eliminar | La categoría tiene subcategorías activas. | Borra o reasigna las hijas primero. |
CATEGORY_HAS_PRODUCTS al eliminar | Hay productos asignados a la categoría. | Edita esos productos y cambia su categoría, luego reintenta. |
| El árbol no aparece como esperaba | El campo Orden de aparición es 0 en todas. | Edita las categorías y asigna distintos números para forzar el orden. |
Notas
- El margen de utilidad se configura por tenant (en Ajustes) y opcionalmente por producto o por cliente. No hay margen por categoría en esta versión.
- Las categorías inactivas no aparecen en el selector de productos pero los productos ya asignados conservan la referencia.