The Morocco payroll module calculates pay for employees under a Moroccan contract: CNSS and AMO contributions, CIMR supplementary pension, income tax (IR), payslips, the payroll journal and the statements needed for returns. It is separate from Swiss payroll, Canadian payroll and preliminary payroll, and is subscribed to and installed on its own. This article gives an overview of the module — its screens, the permissions it requires and the contracts it covers — and points you to the detailed articles. It is intended for administrators and payroll managers.
The module at a glance #
Once installed, the module adds the Morocco payroll menu entry with three screens, plus a tab on the profile of the employees concerned:
- Payroll periods: one month per employer. You open it, calculate it (as many times as needed while it is open), then close it. Payslip PDFs are then published to the employees’ files. See Calculating, closing and publishing the month’s payroll.
- Employers: the numbers printed on payslips and returns (CNSS, IF, ICE, trade register, CIMR) and net pay rounding, for the company and each sub-company. See Setting up Morocco payroll.
- Payslip: the payslip template, per employer and per language. See Setting up Morocco payroll.
- The Morocco payroll tab of the employee profile: the CNSS number, the agreed net base salary, CIMR and dependants for the contract. See Preparing an employee’s Morocco payroll record.
The module settings are also available under Settings › Morocco payroll, which groups four tiles: Employers, Remuneration types, Payslip and Deadlines and reminders. The statements for the CNSS and the tax authority are described in Monthly statements and returns.
Before you start #
- The module must be subscribed to and installed: App Store, Moroccan payroll card, Install button. It is billed per month and per employee with an active Moroccan contract in that month.
- The module is open to the administrator and the payroll manager. The catalogue has three permissions, and the Administrator and Payroll Manager roles receive them at every tier:
- Set up the employer (CNSS, IF, ICE, RC, CIMR) and the payroll deadlines: the Access tier lets you read the Employers, Deadlines and reminders and Payslip screens; the Execute tier lets you save them.
- Moroccan payroll tab of the employee profile: CNSS number, CIMR and dependents of the contract: Access to read the tab and simulate pay, Execute to save the record. This permission follows the scope of your role: you only see the tab for people in your population.
- Calculate and close the month’s payroll, read the payslips: Access to read periods, payslips and statements; Execute to open a month, calculate it, close it, and produce and publish the PDFs.
- The Morocco payroll tab never opens on your own profile through a self-service shortcut: it is not an employee area. Employees receive their payslips in their documents.
Installing the module #
- Open the App Store from the dashboard.
- In the Illizeo Modules tab, find the Moroccan payroll card (category Payroll & compensation) and click it.
- The module page opens on the Overview tab: description, features and information (plan, version, update date, category).
- Click Install. The Morocco payroll menu entry and the Settings › Morocco payroll tile appear for roles holding the permissions.
The Assigned people tab on the same page lets you choose who the module is open to.
Which contracts Morocco payroll covers #
You do not select employees one by one: Morocco payroll finds its contracts itself.
- A contract is Moroccan when its office is located in Morocco. If the contract has no office, the person’s office applies; failing that, the company’s country.
- A contract is included in a month if it started no later than the last day of the month and did not end before the first day. Joining or leaving mid-month gives a pro-rated salary (see Preparing an employee’s Morocco payroll record).
- Draft profiles and external contracts (not paid by the company) are excluded.
- An employer is a sub-company, or the company itself for contracts without a sub-company. Each month is calculated per employer.
- A person with several contracts has one Morocco payroll record per Moroccan contract.
Morocco payroll only calculates in dirhams (MAD): a salary or payment entered in another currency is neither converted nor counted; it blocks the contract’s payslip.
The monthly payroll cycle #
- Set up once: each employer’s numbers, the treatment of your remuneration types, the payslip template and the reminder deadlines.
- Keep records up to date: CNSS number and CIMR in the Morocco payroll tab; salary, bonuses, advances, loans and overtime on the Salary tab, shared by all payrolls. Overtime paid by the Attendance module is picked up automatically.
- Open and calculate the month in Morocco payroll › Payroll periods. Incomplete contracts are listed under To complete before closing.
- Close: payslips are frozen and their PDFs produced. If a validation workflow is active, a second manager approves the closing.
- Publish the payslips to each employee’s Payslips folder; employees are notified.
- Download the statements for the month (payroll journal, CNSS statement, CNSS payment slips, income tax withheld) and, at year end, the annual salary statement.
What each profile sees #
- The administrator and the payroll manager see the whole module: periods, payslips, statements, settings and the Morocco payroll tab of employees in their population.
- A role with only the Access tier reads periods, payslips, statements and settings, without action buttons: no Open the month, Calculate or Save.
- Employees do not see the module. They receive their published payslips in their documents, Payslips folder, and a notice tells them.
Good to know #
- The calculation follows a dated rate schedule (CNSS and AMO rates, ceiling, income tax brackets, professional expenses, seniority, overtime) published by Illizeo. Until a schedule has been validated by Illizeo, each payslip carries the note “Rates to be validated”.
- The module does not yet calculate the annual income tax adjustment, exemption caps specific to each allowance beyond those you set on remuneration types, deductions from net taxable salary (housing loan interest, etc.), or pay for agricultural workers and expatriates.
- Every action (opening, calculating, closing, publishing, saving a setting or a record) and every viewing of a payslip or statement is logged, without amounts or numbers.
- Morocco payroll does not file anything with the CNSS or the tax authority itself: it gives you the statements to enter on Damancom and SIMPL-IR.
Frequently asked questions #
I can’t see the Morocco payroll menu entry. Why? #
The module is not installed in your space, it is not open to you (Assigned people tab in the App Store), or your role does not hold the Calculate and close the month’s payroll, read the payslips permission.
An employee does not appear in any period. What should I check? #
Check that their contract’s office (or, failing that, their own office) is in Morocco, that the contract covers the month, and that the profile is not a draft. Without a Moroccan contract, the profile does not show the Morocco payroll tab either.
Can I use Morocco payroll and Swiss payroll in the same space? #
Yes. The two modules are subscribed to separately, and each only calculates contracts in its own country.
