Loading...
Chingola, Zambia · +260 969 787 323
Webmail Support All systems operational Operational
Sempya Systems
Guides

HR in Sempya CloudERP: onboarding, leave and access, step by step

Setting up HR properly in Sempya CloudERP: who gets which rights, complete employee records, staff and contractors, holidays, leave from types to approval, onboarding checklists, contract end reminders and leavers.

Setting up HR properly in Sempya CloudERP: who gets which rights, complete employee records, staff and contractors, holidays, leave from types to approval, onboarding checklists, contract end reminders and leavers.

This guide is for the people who look after staff in Sempya CloudERP: HR, the office manager, and whoever approves leave. It goes through every set-up step in order, then shows the daily work: applying for leave, approving it, onboarding someone new and recording a leaver.

Do the parts in order. Leave depends on complete employee records and a holiday list, and notifications depend on employees having email addresses. Most problems people meet with leave come from a step earlier in this list being skipped.

How to find a screen. Every screen below is named in bold. Type the name into the search bar at the top of Sempya CloudERP and pick it from the list, for example type Leave Type and choose Leave Type List. Click + Add to create a new one.

Who does the set-up. Someone with the HR Manager role. A few steps (fiscal year, user roles) need a System Manager; those steps say so.

The set-up checklist

# Step Why it matters
1 Decide who gets which rights HR Manager sees everyone's personal and salary details
2 Complete every employee record Leave approver, email and user login are needed before anyone can apply
3 Set up staff and contractors the right way Contract staff need an end date; independent contractors are suppliers
4 Create the fiscal year and holiday list for each year Leave days are counted against the holiday list
5 Set up leave Leave types, policy, period and balances
6 Switch on leave emails Approvers hear about requests, staff hear the answer
7 Build an onboarding checklist Every new person gets the same steps, each with an owner
8 Get reminded before contracts end No contract runs out unnoticed
9 Record leavers properly Their access stops and their record is kept

The daily work is at the end: applying for leave, approving leave and leave reports.


1. Decide who gets which rights

A role decides what a person can see and change. Give each person the smallest role that lets them do their job.

Role What it allows Who should have it
Employee See their own employee record, apply for leave, make expense claims Everyone with a login
Leave Approver Approve or reject leave for the people who name them as approver Heads of department, supervisors
Expense Approver Approve expense claims for the people who name them Heads of department, finance
HR User Create and edit employee records, leave, onboarding The HR officer or assistant
HR Manager Everything in HR, including settings, salary details and other people's statutory numbers One or two people only
System Manager Users, roles and system settings Your system administrator

Check who has HR Manager today

  1. Open Role and open HR Manager.
  2. Look at the users who have it. You can also open User List, add the filter Role = HR Manager and see them all at once.
  3. For each name, ask: does this person need to see everyone's personal and salary details? If not, move them down to HR User or Employee.

Change a person's roles (System Manager)

  1. Open User List and open the person.
  2. Go to the Roles & Permissions section.
  3. Untick the roles they should not have, tick the ones they need, and Save.
  4. The change applies the next time they open a page.

Personal email addresses (for example a gmail address) should not hold HR Manager. Give the person a company address, or remove the role.

Make sure staff see only their own record

When an employee record is linked to a user, Sempya CloudERP normally creates a User Permission that limits that user to their own employee record. Check it:

  1. Open User Permission List and filter Allow = Employee.
  2. Each staff user should have one line, pointing at their own employee record.
  3. HR staff and approvers who must see other people's records should not be limited this way. On their own employee record untick Create User Permission, and delete their line here.

2. Complete every employee record

An employee record that is missing its approver, email or login stops leave and notifications working for that person. Fill in all of these for every active employee.

Field (tab) Why it is needed
First Name, Last Name, Gender, Date of Birth, Date of Joining (Overview) Required by the system
Company, Department, Designation, Branch (Overview / Company Details) Reports by department; onboarding templates per department
Employment Type (Overview) Full-time, Contract, Part-time and so on; leave policy depends on it
Reports To (Company Details) The organisation chart and approvals
Leave Approver, Expense Approver (Attendance & Leaves / Expense) Leave and expense requests go to this person. A leave request cannot be saved without one
Holiday List (Attendance & Leaves) Leave days are counted against it. Leave it blank only if the company default is right
Company Email or Personal Email, and Prefered Contact Email (Contact) Without an email nobody receives leave notifications
User ID (Overview) The employee's login. Without it they cannot apply for leave themselves
Contract End Date (Company Details / Joining) For contract staff: the end-date reminder uses it
NAPSA number, NHIMA number, TPIN (Statutory numbers) Payroll and statutory returns
Bank details (Salary) Payroll payments

Find the gaps quickly

  1. Open Employee List and filter Status = Active.
  2. Click the settings icon on the list and add the columns Leave Approver, User ID, Company Email, Reports To, Employment Type and Contract End Date.
  3. Any blank cell is a gap. Add a filter such as Leave Approver is not set to see only the people missing that field.

Fill many records at once

Typing 30 records one by one takes a long time. Use the spreadsheet instead:

  1. Open Data Import and click + Add.
  2. Document Type: Employee. Import Type: Update Existing Records. Save.
  3. Click Export Template, choose the fields you want to fill (keep ID), tick Export Data and download it.
  4. Fill in the blanks in the spreadsheet. Do not change the ID column.
  5. Attach the file, click Start Import, and read the result. Fix any row that failed and import again.

Give an employee a login

  1. Open the employee record.
  2. In User ID, click Create User (or open User List, + Add, enter their work email and full name, Save, then pick that user in User ID on the employee).
  3. Give them the Employee role (see step 1).
  4. They receive an email to set their password. If email is not set up for them yet, a System Manager can set a password on the user under Change Password.

3. Staff and contractors

There are two kinds of contractor, and they go in different places.

Kind Where they go Why
Contract staff: people you employ for a fixed period and pay through payroll Employee, with Employment Type Contract (or Piecework, Intern, Apprentice), and a Contract End Date They get leave, payslips and statutory deductions like other staff
Independent contractors: people or firms who invoice you Supplier, not Employee You pay their invoices; they do not get leave or payslips

For contract staff:

  1. Set Employment Type to the right type.
  2. Set Contract End Date. Without it the end-date reminder cannot work.
  3. If the contract is renewed, change the Contract End Date to the new date and attach the new contract to the employee record (paperclip icon, top right).

For independent contractors who also need to log in (for example to fill in timesheets), create a user with only the roles they need. Do not give them Employee if they are not employees.


4. Fiscal year and holiday list, every year

Both have to exist before the year starts. A leave request for January cannot be counted properly without next year's holiday list.

Create the fiscal year (System Manager or Accounts Manager)

  1. Open Fiscal Year and click + Add.
  2. Year Name: 2027. Year Start Date: 1 January 2027. Year End Date: 31 December 2027.
  3. Under Companies, add your company. Save.

Public holidays in Zambia: the rules that matter

Public holidays are set by the Public Holidays Act. What that means for the holiday list:

  • Sunday rule. A public holiday that falls on a Sunday is observed on the Monday after it. Put the Monday in the holiday list, because that is the day staff are off. A holiday that falls on a Saturday is not moved.
  • Moving dates. Good Friday, Holy Saturday and Easter Monday follow Easter. Heroes' Day is the first Monday of July and Unity Day the Tuesday after it. Farmers' Day is the first Monday of August. Work these out again every year; do not copy last year's dates.
  • Extra days. The President can declare an extra public holiday by statutory instrument, for example for a general election or national mourning, sometimes only days before. Add it as soon as it is gazetted (see below).
  • Saturday workers. Holy Saturday, and any holiday that lands on a Saturday, only matter if your staff work on Saturdays. If they do, keep those rows in the list so the day is not counted as leave.
  • Leave over a holiday. A public holiday inside someone's annual leave is not taken off their leave balance, as long as Include holidays within leaves as leaves is unticked on the leave type (step 5.1). Maternity leave runs in calendar days, so tick it on Maternity Leave.
  • Working on a public holiday. Pay or time off for staff who work on a public holiday follows the Employment Code Act and their contract. If you give a day off instead, the employee makes a Compensatory Leave Request for the holiday worked; once approved it adds a day of Compensatory Off to their balance. The system only accepts the request if the employee is marked present that day, so HR first records it: open Attendance, + Add, pick the employee and the date, set Status = Present, save and Submit. If you pay extra instead, record it in payroll as overtime.
  • Different sites or shifts. If some staff keep a different pattern (for example a site that works Saturdays, or staff based outside Zambia), give them their own holiday list and set it on their employee record or on their shift type.

Sample holiday list: Zambia 2027

Date Day Holiday
1 January Friday New Year's Day
8 March Monday International Women's Day
12 March Friday Youth Day
26 March Friday Good Friday
27 March Saturday Holy Saturday
29 March Monday Easter Monday
28 April Wednesday Kenneth Kaunda Day
1 May Saturday Labour Day
25 May Tuesday Africa Freedom Day
5 July Monday Heroes' Day
6 July Tuesday Unity Day
2 August Monday Farmers' Day
18 October Monday National Day of Prayer
25 October Monday Independence Day, observed (24 October is a Sunday)
25 December Saturday Christmas Day

Check this list against the Government Gazette before you use it, and add any day declared during the year. Download it ready to import: zambia-public-holidays-2027.csv.

Load the holiday list: option A, import the file (quickest)

  1. Download the CSV above. Open it in Excel if you need to change anything, and save it as CSV again. Keep the first row exactly as it is: those are the column names the system expects. The list name, From Date and To Date go on the first row only; every other row is one holiday.
  2. Open Data Import and click + Add.
  3. Document Type: Holiday List. Import Type: Insert New Records. Save.
  4. Click Attach next to Import File, choose the CSV, and save. The preview shows one holiday list with 15 rows. Fix anything shown in red.
  5. Click Start Import. When it says Successful, click the link to open the new holiday list.
  6. On the list, add the weekly offs as in option B step 3, and save.
  7. Finish with option B steps 5 and 6.

If the import says a holiday list with that name already exists, either delete the empty one or change the name in the file.

Load the holiday list: option B, type it in

  1. Open Holiday List and click + Add.
  2. Holiday List Name: for example Zambia 2027. From Date: 1 January 2027. To Date: 31 December 2027.
  3. Add weekly offs. Under Add Weekly Holidays, pick Sunday and click Add to Holidays. If Saturday is not a working day, do the same for Saturday. If staff work half a day on Saturday, do not add Saturday; half days are handled per leave request.
  4. Add public holidays. Click Add Row in the Holidays table for each holiday in the sample list, with its date and description.
  5. Save. The table should show about 52 Sundays (plus 52 Saturdays if you added them) and the public holidays.
  6. Open Company, open your company, and set Default Holiday List to the new list from 1 January. Employees with a holiday list on their own record need it changed there too (use Data Import to change them all at once).

When a holiday is declared, or one is missing

  1. Open the year's Holiday List, click Add Row, enter the date and the reason (for example Public holiday declared by statutory instrument), and save.
  2. Leave already approved over that day is not recounted. Open Leave Application, filter by the dates around the holiday and Status = Approved. For each one, click Cancel, then Amend, and submit it again: the day is given back to the employee's balance.
  3. Tell staff, so that nobody applies for leave on that day.

5. Set up leave

Leave in Sempya CloudERP is built from five pieces. Set them up in this order:

  1. Leave Type: annual, sick, maternity and so on, with its rules.
  2. Leave Period: the leave year, usually the same as the fiscal year.
  3. Leave Policy: how many days of each type a group of staff gets.
  4. Leave Policy Assignment: gives the policy to each employee, which creates their balance.
  5. Leave Application: the request itself, approved or rejected.

Nobody can apply for leave until steps 1 to 4 are done for them.

5.1 Create the leave types

Open Leave Type, click + Add for each type, fill in the settings below and save. A leave type that already exists (for example Casual Leave or Sick Leave) can be opened and corrected instead of created. The day counts follow the usual reading of the Employment Code Act, 2019. Check them against your own employment contracts and collective agreements before you use them; a contract may give more, but not less.

Leave Type Name Maximum Leave Allocation Allowed per Leave Period Other settings
Annual Leave 24 Tick Is Earned Leave, Earned Leave Frequency Monthly (2 days a month). Tick Is Carry Forward if unused days carry into next year; set Maximum Carry Forwarded Leaves and Expire Carry Forwarded Leaves (Days) to your rule
Sick Leave per your contract Untick Is Carry Forward. Ask for a medical certificate in your leave rules
Maternity Leave 98 (14 weeks) Allow Leave Application After (Working Days): about 260 (one year's service). Maximum Consecutive Leaves Allowed: 98. Tick Include holidays within leaves as leaves
Paternity Leave 5 Maximum Consecutive Leaves Allowed: 5
Compassionate Leave 12 Untick Is Carry Forward
Family Responsibility Leave 7 Untick Is Carry Forward
Mother's Day 12 Tick Is Earned Leave, Earned Leave Frequency Monthly (1 day a month). Maximum Consecutive Leaves Allowed: 1. Give it only in the policy for female staff
Leave Without Pay 0 (no limit) Tick Is Leave Without Pay. Payroll then deducts these days
Compensatory Off 0 Tick Is Compensatory, for staff given time off for working on a rest day

Settings worth knowing on every leave type:

  • Include holidays within leaves as leaves: leave this unticked for annual leave, so a public holiday inside someone's leave is not taken off their balance.
  • Allow Negative Balance: leave unticked, so nobody can take more days than they have.
  • Allow Encashment: tick only if your policy pays out unused leave.

5.2 Create the leave period

  1. Open Leave Period and click + Add.
  2. From Date: 1 January. To Date: 31 December. Company: yours. Tick Is Active. Save.
  3. Create next year's period too, before January.

5.3 Create the leave policies

Most companies need two or three policies, one per group of staff with the same entitlements.

  1. Open Leave Policy and click + Add.
  2. Title: for example Full-time staff or Contract staff.
  3. In Leave Allocations, add a row for each leave type and the number of days a year (for example Annual Leave 24, Compassionate Leave 12, Family Responsibility Leave 7).
  4. Save, then Submit. A policy cannot be used until it is submitted.

Leave types with a fixed trigger (maternity, paternity) can be in the policy too; the rules on the leave type stop them being misused.

5.4 Give each employee their policy

Use the Leave Control Panel to do everyone at once:

  1. Open Leave Control Panel.
  2. Dates Based On: Leave Period, and pick this year's leave period.
  3. Allocate Based On Leave Policy: tick it, and choose the policy.
  4. Filter the employees (for example Employment Type Full-time), tick the ones the policy is for, and click Allocate Leave.
  5. Repeat for each policy and group.

To do one person (for example a new joiner), open Leave Policy Assignment, + Add, pick the employee, the policy and the leave period, Save and Submit.

Annual leave set as earned leave builds up by 2 days at each month end. Someone assigned mid-year gets the days for the months already worked.

5.5 Record leave already taken this year

If you start using leave part-way through the year, record the days each person has already taken, so their balance is right from day one:

  1. Open Leave Application and click + Add.
  2. Pick the employee, the leave type and the dates already taken, and set Status to Approved.
  3. Save and Submit.

Only HR can enter leave in the past. In HR Settings, leave Restrict Backdated Leave Application unticked while you do this, or tick it and set Role Allowed to Create Backdated Leave Application to HR Manager, so staff cannot backdate their own requests.

5.6 Check the rules in HR Settings

Open HR Settings, section Leave Settings:

  • Leave Approver Mandatory In Leave Application: keep it ticked. Then every employee must have a leave approver (step 2).
  • Prevent self approval for leaves even if user has permissions: tick it, so an approver cannot approve their own leave.
  • Show Leaves Of All Department Members In Calendar: tick it if staff should see who else in the department is away.

5.7 Try it

Before telling staff, take one test request all the way through: an employee applies, the approver approves, and the balance goes down in the leave balance report. Then cancel the test.


6. Switch on leave emails

Two emails go out: one to the approver when someone applies, one to the employee when the request is approved or rejected.

  1. Open HR Settings, section Leave Settings.
  2. Tick Send Leave Notification.
  3. Leave Approval Notification Template: choose Leave Approval Notification.
  4. Leave Status Notification Template: choose Leave Status Notification.
  5. Save.

If the two templates are not in the list, open Email Template, create them, and use fields such as , , , and ``.

Emails only reach people whose employee record has an email address and whose approver has a login with an email. Check step 2 first.


7. Build an onboarding checklist

An onboarding template is a checklist that every new person goes through. Each task has an owner and a due date, so nothing depends on someone remembering.

Create the template (once)

  1. Open Employee Onboarding Template and click + Add.
  2. Pick the Company, and the Department and Designation if this template is only for one kind of job. Leave them blank for a template everyone uses.
  3. In Activities, add one row per task. For each, give the task a name, choose who does it (User, or Role for "whoever has this role"), and Begin On / Duration in days from the joining date. A typical list:
Activity Done by Begin on (days)
Signed contract received and attached HR 0
Copy of NRC or passport attached HR 0
NAPSA, NHIMA and TPIN numbers recorded HR 0
Bank details recorded for payroll HR / Accounts 0
Sempya CloudERP login created, Employee role given System administrator 0
Work email set up System administrator 0
PPE and uniform issued Stores 1
Tools, laptop or phone issued Department head 1
Safety and company induction done HR 2
Leave policy assigned HR 2
Probation review booked Department head 5
  1. Save.

Onboard a new person

Onboarding starts from the job offer, so the person first goes in as a job applicant. This takes two minutes and keeps the offer letter with their record.

  1. Job Applicant: open Job Applicant, + Add. Enter the person's name, email and the designation, and save.
  2. Job Offer: open Job Offer, + Add. Pick the job applicant, the designation and the offer date. When the person has accepted, set Status to Accepted, then save and Submit. Attach the signed offer or contract.
  3. Employee Onboarding: open Employee Onboarding, + Add. Pick the Job Applicant and the Job Offer; the name and designation fill in. Enter the Date of Joining, Onboarding Begins On and the company, and choose the Employee Onboarding Template. The activities fill in from the template. Tick Notify users by email so each owner hears about their task.
  4. Save and Submit. Each activity becomes a task assigned to its owner, with its due date. To see them, click View → Task.
  5. Click Create → Employee to make the employee record from the onboarding, then complete it as in step 2.
  6. Owners mark their tasks done. The onboarding shows Completed when all its tasks are done, or HR clicks Mark as Completed.

People who are already working for you and were never onboarded do not need this. Complete their employee record as in step 2 and use the checklist above to see what is missing.


8. Get reminded before contracts end

  1. Make sure every contract employee has a Contract End Date (step 3).
  2. Open Notification and click + Add.
  3. Name: Contract ending in 30 days. Document Type: Employee. Send Alert On: Days Before. Reference Date: Contract End Date. Days Before or After: 30.
  4. Condition: doc.status == "Active".
  5. Recipients: add the HR Manager role, and the field Reports To if the manager should hear too.
  6. Subject: Contract for ends on . Write a short message, tick Enabled and save.

You can add a second notification for 7 days before. To see every contract ending soon at any time, open Employee List and filter Contract End Date is within the next 3 months.


9. Record leavers properly

When someone leaves, record it in the system rather than deleting anything. Their history stays, and their access stops.

  1. Optional but recommended: create an Employee Separation Template (like the onboarding one) with tasks such as return laptop and phone, return PPE, clear advances, disable login, final pay. Then create an Employee Separation for the person from that template.
  2. On the employee record, set Relieving Date and Reason for Leaving, change Status to Left, and save.
  3. Disable their login: open User List, open the user, untick Enabled and save. Do this on the last working day.
  4. Final pay is worked out with a Full and Final Statement and the last payslip.

Do not delete employee records. Keep them for at least six years for tax and labour records.


Applying for leave (staff)

On a computer:

  1. Sign in to Sempya CloudERP and open Leave Application, + Add.
  2. Pick the Leave Type, the From Date and To Date. Tick Half Day if it is half a day. The system shows your balance and how many days the request uses, skipping weekends and holidays.
  3. Write the reason, attach a document if needed (for example a medical certificate), and Save. Your approver is filled in from your employee record.

On a phone: open your company's Sempya CloudERP address followed by /hrms, sign in, and choose Leaves → Request a Leave. You can add it to your home screen from the browser menu.

Once your approver has decided, you receive an email and the request shows Approved or Rejected.

If the request will not save:

  • Leave approver is required: HR needs to set your leave approver.
  • Insufficient leave balance: you have fewer days left than you asked for.
  • No leave allocation: HR has not given you a leave policy yet.

Approving leave (approvers)

  1. Open the link in the email, or open Leave Application and filter Status = Open. You see the requests where you are the approver.
  2. Open a request. Check the dates, the balance shown, and the leave calendar for overlaps in the team.
  3. Set Status to Approved or Rejected and click Submit. The employee is told by email.

To change an approved request (for example the person came back early), open it, click Cancel, then Amend, correct the dates and submit again. The balance is corrected automatically.


Leave reports

Report What it shows
Employee Leave Balance Each person's opening balance, days allocated, taken and left, for a date range
Employee Leave Balance Summary One line per person, every leave type side by side
Leave Ledger Entry Every change to a balance, for checking a figure
Leave Application calendar view Who is away on which days (open Leave Application, switch the view to Calendar)

Print or download any report with the menu at the top right of the report.


If something here does not match what you see in your system, contact Sempya at support@sempya.co.zm.

Business email
Your own domain, hosted in Zambia
K 55/mailbox/mo, ex-VAT

Migration from Google or Microsoft included, backed up nightly.

See business email →
← All blog posts