Modules

Mosce ERP is organized into modules (Invoicing, Inventory, Accounting, etc.). Each tenant starts with a base set active, and you decide which others to turn on, within the ones your plan allows.

Reading time: ~6 min

When to use this

• You just provisioned the tenant and want to tidy up the sidebar, leaving only what you're going to use.
• You upgraded your plan and want to enable modules that were previously locked.
• A module (for example Point of Sale) no longer applies to your operation and you want it to stop appearing in every user's navigation.

Before you start

• You need the modules:manage permission. By default the Owner and the tenant Administrator have it.
• Know your current plan. You can see it in Settings › Modules (each card shows a Requires STARTER plan / PROFESSIONAL / ENTERPRISE label when your plan isn't enough).

Which ones are active by default

When the tenant is created, Mosce ERP automatically activates these six base modules (available from the FREE plan):

• Invoicing (invoicing)
• Quotations (quotations)
• Customers (clients)
• Products (products)
• Reports (reports) - basic reports
• Settings (settings)

The rest of the catalog starts off and you must activate it manually.

The audit log is no longer a module you can toggle: collection is always active for all plans. Who can view the log depends on the plan and the user's permissions - see Audit log.

Full catalog and minimum plan

If your plan is FREE you can only operate the six base modules. STARTER enables eight additional modules, PROFESSIONAL adds Accounting and Advanced Reports, and ENTERPRISE also includes E-commerce.

Step by step

1. Open Settings › Modules (or go to /settings/modules).
2. Each row shows the module name, a short description, a status label (Active / Inactive), and a switch on the right.
3. To turn a module on, move the switch to the active position. If the module requires a higher plan, the switch appears disabled and you'll see the Requires <TIER> plan label; you first have to change plan in Billing and subscription.
4. To turn off an active module, move the switch to inactive. Turning off is always allowed even if your plan no longer includes the module (for example if you downgraded).
5. You'll see a toast confirming Module activated or Module deactivated. The change persists immediately.

Expected result

• The module appears in or disappears from the sidebar within seconds.
• The module's own URLs (for example /inventory when you turn off Inventory) stop working: any user who tries to enter is redirected to /modules/disabled?module=<slug>, a screen that explains the module is off.
• The change is replicated to Auth0: the JWT's modules claim updates for all members of the tenant on their next session refresh, so the client's permissions stay in sync with the server.
• For Accounting, turning it on automatically seeds the chart of accounts and the initial accounting settings in a single transaction. If the seeding fails, the module stays off and you have to retry.

Common mistakes

• The switch is gray and doesn't respond. Either you don't have the modules:manage permission (you'll see italic text You don't have permission to manage modules) or your plan doesn't reach the module's minTier. In the second case, upgrade your plan first.
• I turned a module off and users still see it in the sidebar. Ask them to reload the page or sign out and back in to refresh the JWT.
• I activated Accounting and an error appeared. It means the chart-of-accounts seeding failed (missing default mappings). The module stays inactive; contact support with the tenant ID and retry once it's fixed.
• I wanted to turn off Settings. The Settings module can technically be turned off, but doing so leaves you without access to Settings. Don't turn it off unless you have a clear reason. (The audit log doesn't appear in this list because it's no longer a toggleable module - its collection is always active.)

Related

• Billing and subscription - how to change plan to unlock modules.
• Users, roles, and permissions - who can activate or deactivate modules.
• General settings - tenant data and other global configuration.