Your complete illustrated payroll guide.

Welcome to Codeblix Payroll: everything you need to know to pay your people right, every single month. We'll follow one real company, from an empty system to staff, time, leave, the pay run, payslips, the bank, and every MRA return. This is your new payroll. Right now, it is completely empty: no staff, no pay runs, nothing to file. At the top, a setup checklist with seven steps will guide you. Tick them off, and you are ready for your first pay day. The menu on the left follows the way payroll really works. Each section opens into its own pages. People holds employees, onboarding, probation, documents and permits, training, performance and exits. Time holds clock in, timesheets and the roster. Leave holds requests, balances and the leave calendar. Pay holds pay runs, recurring items and loans, payslips and the bank sheet. Statutory holds every MRA return and the statement of emoluments. Reports and settings sit at the bottom. Every month follows the same eight steps. Set up once, keep your staff up to date, record time and leave, run the payroll, send payslips and pay the bank, file with the MRA, and read your reports. Part one: configuration. Open Settings, then Company and MRA profile. Type the employer name, your business registration number, and your employer registration number from the MRA. Add the declarant who signs the returns, a phone number and an email. These details print on every payslip and every return. Choose your employer category. A household employer, like a family with a maid, follows lighter rules, so the system adjusts automatically. Next, the payroll rules. Codeblix ships the Mauritius rules for each income year, from July to June. CSG is 1.5% for the employee and 3% for the employer, rising to 3% and 6% when monthly pay is above Rs 50,000. NSF is 1% and 2.5%, on pay capped at Rs 29,710. The training levy for HRDC is 1.5%, and PRGF is 4.5%, paid by you, the employer. Every rate has an effective date. When the budget changes the law, a new version starts on its date, and old months keep their old rates. Now the pay calendar. Lagoon Bay pays monthly, on the last working day of the month. A month has 26 working days, and a normal week is 45 hours. Overtime is paid at 1.5× on normal days, and 2× on public holidays. Pay groups let you treat staff differently, for example monthly staff and casual weekly workers. Pay items are the lines that appear on a payslip, and each one has its own paycode. Earnings: basic salary, allowances, overtime, commission, bonus and the end of year bonus. For each one, you choose whether it is taxable, and whether it counts for CSG and NSF. Two items can share a name. A transport allowance up to the exempt limit has one paycode, and the taxable part has another, so they are never mixed up. Deductions and employer contributions have paycodes too: PAYE, CSG, NSF, loans, advances, the levy and PRGF. Each paycode points to an account, so the payroll posts itself into accounting. Invite your team, and give each person a role. The payroll manager runs pay. HR officers manage staff and leave. Department heads approve time. The accountant sees costs, and every employee sees only their own payslips. By default, one person can prepare and approve a pay run. If you prefer, switch on: require a second person. Part two: your staff. Go to Employees and click Add employee. We will add Anaïs Laval. Personal details first: name, date of birth, and her national identity card number. Then the job: employee code, department, job title, the date she joined, and her shift. Finally, how she is paid: a basic salary of Rs 38,000 a month, into her MCB account. The tax tab holds what the MRA needs: her tax account number, and whether she is resident in Mauritius. If she gave you an employee declaration form, the EDF, tick it and enter her deductions. Without an EDF, PAYE uses a flat 15% above Rs 38,462. Her contribution code is worked out for you. S is the normal case. Codes for minors, seniors, the public sector and household staff are chosen from her facts, never guessed. Salaries change, so every change has a date. Anaïs was promoted on the first of September, from Rs 36,000 to Rs 38,000. The old salary is kept, never overwritten. Recurring allowances work the same way: her transport allowance of Rs 2,000 is added every month, until you end it. Do not type 48 people by hand. Upload your Excel or CSV file instead. Match your columns to ours, and check the preview. Two rows need attention: a missing bank account, and a duplicate ID card number. Fix them, import, and your whole team is in. Here is Lagoon Bay: 48 employees in six departments. Filter by department, search by name, or open anyone to see their record, their salary history and their documents. Part three: documents, permits and onboarding. Lagoon Bay employs a chef from abroad, Arjun Mehta. For a non-citizen, the record asks for more. His passport number and expiry, and his work permit or occupation permit, with its number, start date and end date. Scan the passport, the permit and the contract into his documents. Every document has a type and an expiry date. Codeblix watches every date for you. Arjun's work permit ends in 45 days. A passport expires in March. Dev's probation ends next month, and one contract is up for renewal. Each alert goes to the right person, early enough to act, and the dashboard shows them all in one list. When you hire someone, start an onboarding checklist. HR prepares the contract and the uniform. The new joiner adds their bank details, ID card copy and EDF from their phone. The manager books the induction. Each task has an owner and a due date. When the last one is ticked, the new joiner is ready for payroll. New joiners start on probation. Under People, Probation, your company sets its own rules: how long it lasts, and what applies during it. Lagoon Bay uses six months. Annual leave builds up from day one, but is taken after probation. And as a company rule, a new joiner earns one sick day after six months with no absence. Two weeks before the end, the manager is reminded to review. Dev had no absence, so his sick day is added, and he is confirmed with one click. You can also extend or end a probation, and the reason is kept. Part four: time and attendance. A hotel never sleeps, so start with shifts: morning, evening and night, each with its break and a 15 minute grace period. Then build the weekly roster. Drag a shift onto a day, or copy last week, and everyone knows when they work. At 6:56, Anaïs arrives and opens Codeblix on her phone. She taps clock in. The app checks she is at the hotel, records the time, and her shift starts. At the end of the day, she taps clock out. Staff without a phone use the fingerprint device at the staff entrance, which sends its punches in automatically. Back in the office, the attendance board shows today: who is in, who is late, who is absent, and who forgot to clock out. Kevin forgot to clock out last night. He sends a correction, his manager approves it, and the reason is kept with the record. Every clock in and clock out becomes a weekly timesheet. This week, Anaïs worked 53 hours: 45 normal hours, and 8 hours of overtime. Her manager checks the week and approves it. Approved hours, and only approved hours, flow into the pay run. How is overtime worked out? First, her hourly rate: Rs 38,000 × 12 months, ÷ 52 weeks, ÷ 45 hours, which is Rs 194.87. At 1.5×, one overtime hour pays Rs 292.31. Eight hours make Rs 2,338.46, and that lands on her payslip. Part five: leave. Codeblix suggests the usual Mauritius leave types, and you can change every one. Annual leave of 20 days, sick leave of 15 days, maternity leave of 14 weeks, paternity leave of 4 weeks, and bereavement and unpaid leave. For each type, set how it builds up, how many days carry into next year, and whether a manager must approve it. Balances are always up to date. For each person, you see what they are entitled to, what they carried forward, what they took, and what is left. Anaïs has 14.5 days of annual leave and 12 days of sick leave left. Anaïs wants three days off in November. On her phone, she picks annual leave and the dates, and sends the request. Her manager gets it straight away, sees who else is off that week, and approves it. Her balance drops to 11.5 days. Kevin is sick for four days. For more than three days in a row, a medical certificate is needed. He takes a photo of it, and it is attached to his leave. His sick balance goes down, and his pay is not touched. Unpaid leave is different. Priya takes two unpaid days, so her pay goes down. The deduction is her basic salary ÷ 26 working days × 2 days, Rs 1,523.08. It goes into the pay run by itself. Part six: the monthly pay run. It is the end of October. Go to Pay runs and click New pay run. Choose the month and the pay date. Codeblix fills in all 48 employees with their basic salary and recurring allowances. This is the worksheet: one row per person. Approved overtime came from the timesheets, and unpaid days came from leave. Nothing is typed twice. If you need to, you can still change a cell, and the reason is recorded. Some amounts repeat. Under Pay, Recurring and loans keeps track of them, so nobody types them again each month. A fixed commission can run for a set period. Lina gets Rs 2,000 a month from September to November. After November, it stops by itself. Other commission comes from records. Kevin's banquet commission is worked out from the banquets he served, so the payroll officer only checks it. Loans and advances follow a schedule. Jean-Marc took an advance of Rs 6,000, repaid at Rs 2,000 a month for three months. Codeblix counts each instalment, shows what is left, and ends it after the third one. Back on the worksheet, each of these appears by itself, with a note under the person's name. Under Kevin: banquet commission, Rs 3,500, from 12 banquets, ready to tick as checked. Under Jean-Marc: advance, instalment 1 of 3, Rs 4,000 left, ending in December. One-off amounts are still allowed. Sarah earned a one-off commission of Rs 500 this month, so it is typed here, with a reason. And any line can be changed for this month only. Click Calculate. In a second, every payslip is worked out. Let's open Anaïs. Her gross pay is Rs 42,338.46. CSG is 1.5% of her basic salary, Rs 570, because she earns under Rs 50,000. NSF is 1%, on pay capped at Rs 29,710, so Rs 297. PAYE is Rs 187. Her net pay is Rs 41,284.46. PAYE is cumulative over the income year. The first Rs 500,000 a year is tax free, then 10%, then 20%. Each month, Codeblix looks at the year so far, takes off her EDF deductions, and charges only what is due, so there are no surprises in June. Some contributions are paid by you, not deducted from staff: CSG at 3%, NSF at 2.5%, the HRDC levy at 1.5%, and PRGF at 4.5%. So Anaïs costs Lagoon Bay Rs 46,501.46 this month. The pay run shows the full employer cost for everyone. Before approving, Codeblix checks the run for you. Kevin's pay is 21% higher than September, because of his raise, overtime and commission. A new joiner has no bank account yet. Nobody has a negative net pay. Fix what needs fixing, and the checks turn green. Click Approve and pay. The run is locked, so no number can change by accident. Made a mistake? Nothing is edited after approval. You add a correction in next month's run, and the history shows both. Part seven: payslips, the bank and accounting. Here is the payslip. At the top, the employee, her ID, the period and the pay date. Then earnings, deductions, and her net pay. Below, what you paid on top as employer, and her leave balances. Download it as a PDF, or all 48 payslips at once. With one click, every payslip is emailed. Each employee also has My payslips on their phone. Anaïs sees only her own payslips, for every month she has worked here. Employees also have their own login, on a computer or on a phone. Anaïs signs in with her email. She sees her own dashboard, not the company's: her next pay day, her latest payslip, her leave balance, and her clock in for today. Her menu only shows her own things: payslips, time, leave, documents and her profile. She can download a payslip or her statement of emoluments at any time. Now pay the bank. The bank sheet lists every transfer: the employee, the bank, the account, and the amount. It adds up to the net pay of the run, to the cent. Download the file, upload it to your bank, and mark the run as paid. The payroll posts itself into Codeblix Accounting, with one journal. Salaries and employer costs go to expenses, by department. Net pay, PAYE, CSG, NSF and PRGF go to what you owe, until you pay them. Part eight: CSG and MRA returns. Every month, you declare PAYE, CSG, NSF and the levy to the MRA in one return. Codeblix prepares the file in the exact MRA format: one line per employee, with their contribution code and amounts. Download the file, log in to MRA e-services or MNS, and upload it. Then pay what is due. Back in Codeblix, record the acknowledgement number and the payment. Each return moves from prepared, to submitted, to acknowledged, to paid. The PRGF return works the same way: 4.5% for every eligible employee, prepared for you each month, ready to upload. In December, Codeblix suggests the end of year bonus for everyone eligible. It is one twelfth of the year's earnings. For Anaïs, Rs 37,500. It is taxed and charged on its own, so her December pay stays right. After the income year closes in June, every employee needs a statement of emoluments, by the 15th of August. Codeblix fills in the MRA's own form for each person: the emoluments line by line, exempt income, EDF reliefs, PRGF, and the tax withheld. Generate all of them, sign, and send them in one go. And once a year, the return of employees sums up the twelve locked months for the MRA. Codeblix checks every month is filed before it lets you prepare it. Part nine: training, performance and exits. Record every training: the course, who attended, the hours and the certificate. Because you pay the HRDC levy, approved training can be refunded. Codeblix keeps the evidence ready for your claim. Once a year, run performance reviews. Each person sets goals with their manager, rates themselves, and the manager adds a rating and comments. The result can lead to a raise, which goes into the salary history with its date. When someone leaves, open an exit case. Sarah resigned, with one month of notice. Codeblix works out her final pay: salary up to her last day, unused annual leave, and her share of the end of year bonus. The checklist covers the uniform and keys handed back, the PRGF exit statement, and her last payslip. Then her record closes, and her history stays. Part ten: reports. Reports answer real questions. What did payroll cost this month? Which department pays the most overtime? How much leave do we owe? Open any report, filter it, and download it to Excel or PDF. And here is the dashboard, now full of life: the next pay date, the cost trend, who is on leave today, and what needs your attention. Everything you set up is working, every month. Part eleven: meet Mia, your AI assistant. Click Ask Mia at the top. Mia knows your staff, pay runs and returns, and works only within your permissions. Ask her anything, in plain words. Nadia asks: why is Kevin's deduction higher this month? Mia explains: his raise on the first of October took his basic salary above Rs 50,000, so his CSG moved from 1.5% to 3%. She shows the numbers and a link to his payslip. Staff can ask Mia too. Priya asks how many leave days she has left, and books Friday off. Mia prepares the request. Her manager still approves it, and Mia never approves pay or sees another company. That is the whole cycle. HR keeps staff and leave up to date, managers approve time, the payroll manager runs and approves pay, finance pays the bank and the MRA. And every employee gets the right payslip, on time, every month. You're ready to run payroll. Need help? We're always here for you, at codeblix.com.