Mosce ERP · Centro de ayuda
Operaciones

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:create o categories: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

  1. Entra al módulo. En la barra lateral pulsa Operaciones → Categorías. (captura: árbol de categorías)
  2. Pulsa "Nueva categoría" en la cabecera.
  3. 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.
  4. Pulsa "Crear".

Construir una jerarquía

Mosce ERP soporta árbol de categorías sin límite de profundidad. Para crear Bebidas → Refrescos:

  1. Crea primero Bebidas (sin padre).
  2. Crea Refrescos y en Categoría padre selecciona Bebidas.
  3. 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:

  1. Entra a Operaciones → Productos y abre el producto que quieres clasificar.
  2. En la sección Categorización, selecciona la categoría.
  3. 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

ErrorCausaSolución
"Solo letras, números y guiones" en el slugEl 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 eliminarLa categoría tiene subcategorías activas.Borra o reasigna las hijas primero.
CATEGORY_HAS_PRODUCTS al eliminarHay productos asignados a la categoría.Edita esos productos y cambia su categoría, luego reintenta.
El árbol no aparece como esperabaEl 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.

Relacionados