Módulos

Mosce ERP está organizado en módulos (Facturación, Inventario, Contabilidad, etc.). Cada tenant arranca con un set base activo y tú decides cuáles más encender, dentro de los que permite tu plan.

Tiempo de lectura: ~6 min

Cuándo usar esto

• Acabas de provisionar el tenant y quieres limpiar la barra lateral dejando solo lo que vas a usar.
• Subiste de plan y quieres habilitar módulos que antes estaban bloqueados.
• Un módulo (por ejemplo Punto de Venta) ya no aplica para tu operación y quieres que deje de aparecer en la navegación de todos los usuarios.

Antes de empezar

• Necesitas el permiso modules:manage. Por defecto lo tienen el Propietario y el Administrador del tenant.
• Conoce tu plan actual. Lo ves en Ajustes › Módulos (cada tarjeta muestra una etiqueta Requiere plan STARTER / PROFESSIONAL / ENTERPRISE cuando tu plan no alcanza).

Cuáles vienen activos por defecto

Cuando se crea el negocio, Mosce ERP activa automáticamente los módulos disponibles desde el plan FREE:

• Facturación (invoicing)
• Cotizaciones (quotations)
• Clientes (clients)
• Productos (products)
• Reportes (reports) - reportes básicos
• Configuración (settings)
• Caja (cash-management)
• Inventario (inventory)
• Compras (purchases)
• Proveedores (suppliers)
• Punto de Venta (pos)

Comisiones de Ventas (commissions) también arranca activo, pero requiere plan STARTER. Fiscal (e-CF), Tareas y Contabilidad arrancan apagados y los activas a mano cuando tu plan los incluye.

El registro de auditoría ya no es un módulo activable: la recolección está siempre activa para todos los planes. Quién puede ver el registro depende del plan y de los permisos del usuario - ver Registro de auditoría.

Catálogo completo y plan mínimo

Los reportes avanzados (balance general, estado de resultados, flujo de caja, antigüedad de cuentas por cobrar, cambios en el patrimonio y resultados por centro de costo) están disponibles en todos los planes, sin necesidad de activar ningún módulo adicional.

Con el plan FREE dispones de once módulos. STARTER suma tres más (Fiscal, Tareas y Comisiones de Ventas) y PROFESSIONAL suma Contabilidad, para un catálogo completo de quince.

Paso a paso

1. Abre Ajustes › Módulos (o ve a /settings/modules).
2. Cada fila muestra el nombre del módulo, una descripción corta, una etiqueta de estado (Activo / Inactivo) y un switch a la derecha.
3. Para encender un módulo, mueve el switch a la posición activa. Si el módulo requiere un plan superior, el switch aparece deshabilitado y verás la etiqueta Requiere plan <TIER>; primero tienes que cambiar de plan en Facturación y suscripción.
4. Para apagar un módulo activo, mueve el switch a inactivo. Apagar siempre está permitido aunque tu plan ya no incluya el módulo (por ejemplo si bajaste de plan).
5. Verás un toast confirmando Módulo activado o Módulo desactivado. El cambio se persiste de inmediato.

Resultado esperado

• El módulo aparece o desaparece de la barra lateral en pocos segundos.
• Las URLs propias del módulo (por ejemplo /inventory cuando apagas Inventario) dejan de funcionar: cualquier usuario que intente entrar es redirigido a /modules/disabled?module=<slug>, una pantalla que explica que el módulo está apagado.
• El cambio se replica a Auth0: el claim modules del JWT se actualiza para todos los miembros del tenant en el siguiente refresh de sesión, así los permisos del cliente quedan sincronizados con el servidor.
• Para Contabilidad, encenderlo siembra automáticamente el plan de cuentas y los ajustes contables iniciales en una sola transacción. Si la siembra falla, el módulo queda apagado y tienes que reintentar.

Errores comunes

• El switch está gris y no responde. O no tienes el permiso modules:manage (verás un texto en cursiva No tienes permiso para gestionar módulos) o tu plan no alcanza el minTier del módulo. En el segundo caso, sube de plan primero.
• Apagué un módulo y los usuarios siguen viéndolo en el sidebar. Pídeles que recarguen la página o cierren sesión y vuelvan a entrar para refrescar el JWT.
• Activé Contabilidad y aparece un error. Significa que la siembra del plan de cuentas falló (faltan mapeos por defecto). El módulo queda inactivo; contacta a soporte con el ID del tenant y reintenta cuando se corrija.
• Quería apagar Configuración. El módulo Configuración se puede apagar técnicamente, pero hacerlo te deja sin acceso a Ajustes. No lo apagues a menos que tengas un motivo claro. (El registro de auditoría no aparece en esta lista porque ya no es un módulo activable - su recolección está siempre activa.)

Relacionados

• Facturación y suscripción - cómo cambiar de plan para desbloquear módulos.
• Usuarios, roles y permisos - quién puede activar o desactivar módulos.
• Ajustes generales - datos del tenant y otras configuraciones globales.