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 tenant, Mosce ERP activa automáticamente estos seis módulos base (disponibles desde el plan FREE):

• Facturación (invoicing)
• Cotizaciones (quotations)
• Clientes (clients)
• Productos (products)
• Reportes (reports) - reportes básicos
• Configuración (settings)

El resto del catálogo arranca apagado y debes activarlo a mano.

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

Si tu plan es FREE solo puedes operar los seis módulos base. STARTER habilita ocho módulos adicionales, PROFESSIONAL suma Contabilidad y Reportes Avanzados, y ENTERPRISE incluye además E-commerce.

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.