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 business is created, Mosce ERP automatically activates the modules available from the FREE plan:

• Invoicing (invoicing)
• Quotations (quotations)
• Customers (clients)
• Products (products)
• Reports (reports) - basic reports
• Settings (settings)
• Cash (cash-management)
• Inventory (inventory)
• Purchases (purchases)
• Suppliers (suppliers)
• Point of Sale (pos)

Sales Commissions (commissions) also starts active, but requires the STARTER plan. Fiscal (e-CF), Tasks and Accounting start off and you turn them on manually once your plan includes them.

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

Advanced reports (balance sheet, income statement, cash flow, accounts-receivable aging, changes in equity, and profit and loss by cost center) are available on every plan, with no additional module to turn on.

The FREE plan gives you eleven modules. STARTER adds three more (Fiscal, Tasks and Sales Commissions) and PROFESSIONAL adds Accounting, for a full catalog of fifteen.

The billing module depends on your country

Billing is not a universal module: each country has its own, because each country has its own tax authority and its own document format. The country is chosen when the business is created and cannot be changed afterwards, so it also decides, once and for all, which billing module your business can enable.

What that means in practice:

• A Dominican business sees the Fiscal (e-CF) module on this screen and enables it once its plan includes it.
• A United States business does not see Fiscal (e-CF) as something it can turn on: if it tries, the application replies that this billing module belongs to another country. It is not a plan limitation nor a missing permission, and upgrading the plan does not unlock it.
• The Taxes section of a US business already has its own address in the application, with no content yet: it shows the notice Taxes for the United States are coming soon. It is there on purpose, so the address does not fail. It does not appear in the sidebar yet: it will once the section has something to manage.
• If you type another country's billing address by hand, the application takes you to the screen explaining that the module is not available, the same as with any module that is turned off.

Enabling electronic invoicing requires your RNC

In the Dominican Republic, the Fiscal (e-CF) module cannot be enabled if your business has no RNC registered. This is not a new product requirement: without an RNC there is no issuer before the DGII, so turning the module on without it only meant the problem showed up later, when you tried to invoice.

When you try to enable it without an RNC, the switch moves, the api refuses and it snaps back on its own, with this notice:

Configure your business RNC before enabling electronic invoicing.

Next to the notice there is a Configure RNC button. That is what breaks the circle: the RNC is configured inside the fiscal module, and with the module off you cannot reach that screen.

Registering the RNC from the notice

1. Press Configure RNC in the notice.
2. Complete the dialog:
   • RNC - 9 or 11 digits. You may type it with or without dashes: they are dropped on save.
   • Legal name - the legal name registered with the DGII. It is required.
   • Fiscal address - optional, the address registered with the DGII.
3. Press Save. The module becomes active immediately, without touching the switch again.

From there, the rest of the issuer configuration (trade name, branch, tax regime, default document type and environment) is completed in Fiscal → Configuration. See Fiscal configuration.

The RNC can be corrected from Fiscal → Configuration as long as you have not issued any document accepted by the DGII. Once an accepted one exists, the number printed on it is binding and the field stops accepting changes: from then on the correction goes through support.

The three reasons the dialog can reject you

And a fourth reason that never reaches the dialog: the currency

Electronic invoicing is only available for businesses operating in Dominican pesos, because the DGII requires document amounts to be expressed in pesos. That block applies earlier: if your business operates in another currency the switch is already locked and the RNC dialog never opens. The currency cannot be changed after the business is created either.

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.
• The Fiscal (e-CF) switch does not turn on and mentions an RNC. Your business has no RNC registered yet. Press Configure RNC in the notice itself and complete it there; there is no need to go to any other screen.
• It says the billing module belongs to another country. Your business does not operate in that module's country. The country is fixed when the business is created and is not changed; see General settings.
• 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.