Add your staff
Get your people into MekongHRM. There are three ways, and which is right depends on how many you have and whether you already hold their phone numbers.
Before you start
- The
employee.createpermission for adding people by hand, oremployee.importfor the Excel route. The Owner and HR roles hold both. - The
employee.view_sensitivepermission to see and fill in the ID documents, the NSSF number, the work permit, the salary account and the attachments. Owner and HR hold it; Manager does not.
Steps
A few people: add them by hand
- Open People and press Add an employee.
- Fill in Name, Phone number and every other field marked with a star. **Fields marked * are required.**
- Press Add an employee at the bottom.
The phone number is what links them to Telegram without anybody approving anything, which is why the record cannot be saved without it.
When the name you typed is in Latin letters, you can also give the name in Khmer script under Khmer name. It is optional. It shows under the main name on their record, every box that searches for people finds it, it is printed on the payslip beside the main name, and it has a column of its own in the tax and NSSF filings.
There is no box for a staff number: MekongHRM gives every new person the next number itself, one more than the highest in the company. Staff numbers are shown with leading zeros to a fixed length, so number 123 appears as 00123 everywhere — on screen, in the Mini App, on payslips and in exported files. Typed or imported, 123 and 00123 are the same number.
You land on their record afterwards, where you can set their unit, their manager, their usual shift and the rest.
Correcting a record
Open People and click a name. Everything about them is there except their pay, which is behind its own permission and lives on the payroll screens.
The staff number is given by the system. Only the Owner can change it, on the record; everybody else sees it read-only. When it is changed, the new number must be free, and the old one is never given to anybody else. Every change is written to the activity log. The Excel import can also set a staff number of your choosing on a record it creates, for a company moving its numbering over from an old system.
What the record holds
The record is laid out in groups:
- Who they are — the name and the Khmer name, the staff number, the phone number, the date of birth, the gender, the Marital status, the nationality (Cambodia unless you choose another), the place of birth, the current address, where they live as Google Map Lat,long, pasted as it is copied from Google Maps, a personal email, and their Annual leave balance, which is shown and not edited here. Once the point is in, Open in Google Maps shows the spot on Google Maps.
- Where they work — the branch, the unit, the manager, the Province of work, and the Job position, picked from your company's list (see Branches and departments). The province is chosen from Cambodia's 25 provinces and capital, and it is the person's own: it does not follow the branch. Beside it, the person's Position group, picked from your company's list of groups. The group is the person's own, independent of the position, and always has a value: a new record starts in Staff.
- Their employment — the Employment, Full-time unless you choose Part-time; their Status — working, suspended or resigned — where a suspension is started and ended (see *Suspending somebody* below) and a leaving is not; the Started date, the Probation ends date and Passed probation with the date it was confirmed, Confirmed on; the Yearly evaluation; the contract type and, for a fixed-term contract only, the dates the contract starts and ends; and the date seniority counts from. For somebody who has resigned, it also shows their First day off, How they left and Reason, all given on the Leaving page.
- Additional information — the Insurance, shown and not edited here, because it is set on the salary card of the payroll app; the Fixed allowances, from the salary card, each with the date it starts from, shown only to somebody who holds
payroll.view_salary; and the Attachments. - Documents — the ID document (a Khmer national ID card or a passport), its number and expiry date, the NSSF number, and for foreign staff the work permit number and its expiry date.
- Salary account — the bank, chosen from the banks and wallets used in Cambodia (ABA, ACLEDA, Wing and the rest) or Other with its name typed in, the account number and the account holder's name.
- Emergency contact — who to call: a name, the relationship and a phone number.
- Attendance — the usual shift, the device PIN, and the two attendance settings.
Documents and Salary account are only shown to somebody who holds employee.view_sensitive over that person, and changing them also takes employee.edit. For anybody else the two groups are simply not on the page. See Roles and permissions.
Marital status and tax dependants
Marital status is a switch: on is Married, off is Single, and the word beside it says which. It starts off for a new person and always has one of the two; it is never left blank. Under it is Dependant spouse, a box ticked when the spouse counts as a dependant; it is always shown, and can be ticked only while the switch says married. Dependant children, a choice from 0 to 10, is always there: anybody can claim their children, whatever their marital status, a single parent included. These are the dependants their salary tax is worked out with; the payroll app reads them from here and shows them on the salary card without a box of its own. Turning the switch off clears the dependant spouse and leaves the children as they are. What counts as a dependant is in Relief for dependants.
Required fields
The form will not save while a field marked with a star is empty: the phone number, the gender, the current address, the province of work, the position, the employment type, the start date and the probation end. The ID document number is required too, but only of somebody who holds employee.view_sensitive and employee.edit, since nobody else can see that field. Fill in what the record requires: {fields}. names what is missing.
Whatever stops a save is written in red under the field it is about, and the cursor moves to the first of them: a required field left empty, a phone number that cannot be read, a phone number or Clocking machine number another record already holds, a contract that ends before it starts. The line at the top, The record was not saved. Fix the highlighted fields., only says that there is something to fix. Correcting a field clears its message.
A record made before these fields were required still opens as it is. It saves again once the missing fields are filled in, the next time somebody edits it. To find those records, filter the staff list by Incomplete record.
Attachments
Under Attachments, keep the papers that go with a person: a signed contract, a scan of their ID, the proof of a dependant. Attach a file takes a PDF, an image or an office document of up to 10 MB. Each file opens through a link that works for a short time only, so a link copied out of the page stops working soon after. Remove asks you to confirm first.
Attachments are kept until you remove them. Seeing them takes employee.view_sensitive, because contracts and ID scans are here; adding or removing one takes employee.edit as well.
The photo
The head of the record shows the person's photo, or their initials when there is none; the same small circle sits beside their name in the staff list. Anybody who may edit the record clicks Add photo (or Change photo) and picks a JPEG, PNG or WebP picture. The browser crops it to the middle square and shrinks it before sending it, so a photo straight off a phone is fine. Remove photo takes it off the record. A replaced or removed photo is deleted from storage, not kept.
This photo is the company's, on the record. It is separate from the one an employee sets for themselves in the Mini App.
Reminders before a contract or work permit runs out
For a fixed-term contract with an end date, and for a work permit with an expiry date, the bot reminds the employee themselves: 30 days before the date, and again on the day. Each reminder is sent once, in the employee's own language, and asks them to contact HR about it. Nobody else is told — not HR and not their manager: the person whose papers they are is the one who has to see to them. A contract and a permit due on the same day arrive as one message. The message has no link, since an employee cannot open the web admin. An employee who has not linked Telegram gets no reminder; one that has not gone out yet goes out once they link. If you change the date, for instance because the contract was extended, the new date gets its own reminders.
A date typed in with fewer than 30 days to go gets its first reminder straight away. Reminders go out from 07:00, the local time of the person's branch. Somebody who has left gets none.
Probation
Under Their employment, Probation ends is the last day of somebody's probation. When you add a person and type their Started, the box fills itself with the day three months later: the same day of the month, or the last day of that month when it is shorter, so a start on 30 November ends probation on 28 February. Change it if their contract says otherwise. It is a required field, so it cannot be left empty.
Once a record has a probation end date, it is yours: correcting the start date later does not move it. A record with no end date that is given a start date gets the three-month default, as a new one would. The end date cannot be earlier than the start date.
When somebody passes their probation, tick Passed probation and give the date under Confirmed on. Annual leave starts there: the tick credits the rest of that year's leave at once, and removing it takes that back — see Annual leave.
Moving somebody to a different branch or unit is not a quiet change: it decides which shift they are on, where their check-in is measured from, and who approves their requests. They are told in writing when you save it — see Notices from your company.
Suspending somebody
Under Their employment, Status says whether somebody is working, suspended — since a date, or between two — or has resigned. If you hold employee.disable, the permission recording a leaving takes, the status carries the two actions a suspension has.
Suspend asks for the First day, a Last day if you know it, and the Reason, then asks you to confirm. Both days are part of the suspension. Leave the last day empty until you know it: the suspension then runs until you end it.
Back to work ends it: the suspension's last day becomes yesterday, and they are expected at work from today.
While somebody is suspended:
- they do not have to check in, nothing reminds them, and no day of the suspension counts as an absence, on the grid or on the timesheet;
- the days are not paid: the month's salary is shared out by calendar days, the way it is for somebody joining or leaving during a period — see The daily rate;
- a month suspended from its first day to its last earns no annual leave — see Annual leave;
- the record, the Mini App, their roles and their place in your plan's count all stay as they are.
Suspending and bringing back are both written to the activity log, with who did it; the suspension keeps its reason. The record lists every suspension, the most recent first. The staff list's Status filter has Suspended as a choice of its own.
When somebody leaves
Open Leaving in the People group of the menu and choose the person under Who is leaving; only people still working are offered. From somebody's record, Record leaving opens the same page with them already chosen. You give the First day off, choose How they left — Resigned or Terminated, which has no default and must be chosen — choose whether to Pay unused annual leave on the final payslip, and write the Reason. How the final pay is worked out is in Annual leave. Their record keeps the first day off, the type and the reason.
Before you confirm, the card lists what the leaving touches:
- Telegram groups they are still in. The bot asks Telegram about each group connected to the company. Ask the person to leave the ones listed: the bot cannot remove anybody. A group Telegram did not answer for is marked as not checked.
- Named in the approval set-up. Every place the approval set-up names them: a unit they manage or approve for, a flow step that names them, a delegation to or from them that is in force or still to come, the people whose own manager they are, and the company's backup approver. Each links to the screen where you change it, where there is one. With it, the number of requests waiting on them now: you do not have to move those, they move by themselves.
- Web roles. The roles they hold here.
When you confirm, their access to this company ends at once. Every role is taken away, each with its own line in the activity log, they are signed out of the web admin of this company, and the bot and the Mini App stop answering them for it, saying they no longer have access. Their other companies are not affected; if the bot was on this one, it moves to another company they still work for. Requests that were waiting on them go to whoever approves in their place — the unit above, and finally the backup approver — and the card in their chat loses its buttons. The device is told to forget them.
Their final payslip still arrives in their Telegram chat: sending it is the bot's job, and needs no access from them.
Afterwards, they appear under People who have resigned on the same page, the most recent leaving first. Follow up on their row shows Still to follow up: the groups they are still in and the approval set-up that still names them, until there is nothing left. Their record links there too.
Finding somebody
The list filters by name — the main name or the Khmer name — staff number or phone, and by branch, department, Province of work, Employment, whether they are still with you, whether their Telegram is linked, and whether they are On probation — their probation end date is today or later, today being your company's date. Under Record, Incomplete record keeps the people whose record lacks a required field, counting only the fields you can fill in yourself. The Probation ends column shows the date for the people still on probation, and stays blank for everybody else. The position column shows the person's position group after the position's name. After it come the department, the branch and the province of work, and after the probation date the Yearly evaluation date, blank when none is set. The count beside the filters says how many of the total you are looking at, so a filter that matches nobody does not look like a company with nobody in it.
Clicking a column heading orders the table by it; clicking it again turns it around. People with nothing in that column go last either way.
Exporting the list
Export to Excel, at the end of the filter bar, downloads the people the list is showing, with the filters and the search as they are. The file is the import template: the same columns, filled in the way the import reads them, so a file you export, correct and import into another company says the same thing. After the template's columns come whether the record is active, the day somebody left, and whether their Telegram is linked. Salaries and allowances are in it only on the payroll app's list, for somebody who may see salaries; identity documents, NSSF, work permits and bank accounts only for somebody who may see those. Each export is written to the activity log.
Deleting a record made by mistake
At the foot of somebody's record, Delete this record removes it — but only a record with nothing on it: one added by mistake, or a row an import made twice. A record that is linked to Telegram, has punches, days, requests, payslips or leave taken, manages a unit, approves for one, or holds a role cannot be deleted; the card lists every reason, and the way to end somebody's time with you is Record leaving, which keeps their attendance and pay readable. You confirm by typing the person's name. Their staff number is never given to anybody else, and the deletion is written to the activity log.
A whole company: import from Excel
- Open People, then Import staff from Excel.
- Press Download the template and fill the template in. Keep the first row as it is — that is the row the file is read by.
- Choose your file and press Check the file. Nothing is written yet.
- Fix whatever the report lists, and check again.
- When the report is clean, press the import button.
The template is in English, whatever language you use the app in, and comes with a second sheet, example, showing a few filled-in rows; only the first sheet, employees, is imported. The name is the only column a row cannot do without. The column after it, khmer_name, is the name in Khmer script, taken as you type it; leave it empty when there is none. Leave the staff number empty and the import gives that row the next number, in row order, counting on from the highest number in the company or in the file; fill it in and it must be digits only and not already taken. This is the only way to choose a staff number, and it applies only to the records the import creates. The probation end column, probation_ends_on, takes a date like the others; leave it empty and the row gets three months after its start date, the same default as adding somebody by hand. A manager is named by their staff number, which may be another row of the same file; a usual shift by its name as set up under Shifts. A department the company does not have yet is created by the import, under the manager's department when the manager sits elsewhere; an allowance it does not have is created too, with no tax, no NSSF and no overtime effect until payroll says otherwise. The check tells you what will be created before anything is written. Fill the template in rather than building your own sheet. Its columns are formatted as text, which is what stops Excel reading 012 345 678 as a number and dropping the leading zero — a number that arrives that way can never be matched to anybody. The date columns are the exception: they hold real dates, shown as dd/mm/yyyy, and a date typed as text in that shape is read too.
A row whose probation ended before the day of the import comes in as having passed probation on the day it ended, unless probation_confirmed_on gives another date, because annual leave starts at passing probation; a probation still running that day is left for you to confirm. leave_balance_days is what the old system had left: it goes on the leave ledger as the opening balance, and nothing is credited again for the time before the import — see Annual leave.
The template also has a column for each field of the record. gender takes male or female. marital_status takes single or married; left empty, it is read as single, except on a row that gives a dependant spouse, where it is read as married. dependant_spouse and dependant_children are the tax dependants, at most 10 children. nationality takes a country code such as KH, the country's name in English (Vietnam) or the nationality in English (Vietnamese); in the template it is a drop-down of every country, and the nationalities sheet lists each one with its code and its Khmer name, so you can look a code up. home_latitude and home_longitude take decimal degrees such as 11.556400, both or neither. work_province takes the province's code, such as siem_reap, or its name in English or in Khmer, in any case and spacing. position takes the position's name; one the company does not have yet is created, like a department, and listed in the check's "will create" before anything is written. position is the job position; position_group is the person's position group, a separate column. It takes the group's name, in any case; a group the company does not have yet is created in the same way and listed in "will create", and an empty cell means Staff. employment_type takes full_time or part_time. probation_confirmed_on and evaluation_date are dates. insurance_type takes nssf, nssf_adi, private or none, or yes and no, read as nssf and none; an older template's joins_nssf column is read as this one. personal_email, place_of_birth and current_address are taken as written. id_document_type takes national_id or passport, beside id_document_number and id_document_expires_on; then nssf_number, work_permit_number and work_permit_expires_on. contract_start_date and contract_end_date are for fixed-term contracts only. bank takes the bank's code or its name as listed, such as ABA, ACLEDA or Wing, in any case; anything else is kept as an "other" bank with that name. Then bank_account_number and bank_account_name, and the emergency contact in emergency_contact_name, emergency_contact_relationship and emergency_contact_phone. Dates are written dd/mm/yyyy, like the other date columns.
Every column that takes one of a fixed set of answers is a drop-down in the template — gender, marital status, contract and employment type, insurance, document type, currency, dependant children, the yes/no columns, nationality, work province and bank — and the nationalities, provinces and banks sheets list the long ones with their codes. You can still type an answer the importer reads, such as KH or fulltime; Excel only warns about it.
A row that leaves a required field of the record empty — the phone number, the gender, the ID document number, the current address, the province of work, the position, the start date, or the probation end when there is no start date to count it from — is still imported. The ID document number counts only when you hold employee.view_sensitive. The check lists each gap under {count} things the records will still need, both before the import and after it, so you know which records to complete; Incomplete record on the staff list finds them later.
The ID document, NSSF, work permit and bank columns need employee.view_sensitive. If you do not hold it and a row fills any of them in, the check refuses that row, and the import writes nothing until those columns are empty.
When attendance starts
Nobody owes attendance before they are in MekongHRM. A person's attendance starts on the later of two dates: their Started date, and the day their record was added — by hand, by import or through the join link. Before that day nothing is marked absent, on the attendance grid, in their Mini App or on the timesheet, so a company moving over can import staff hired years ago without anybody being absent for the years before. The days before it show blank rather than as days off.
Pay is not affected. The month's salary still counts from the start date, so somebody hired long ago and added in the middle of a month is paid for the whole month, with no absence for the days before they were added.
Let people add themselves
Send staff the join link from Company details, or print it as a QR poster. They press Start and share their phone number, and you approve them on People.
What you should see
Everybody appears in the list with Not linked beside them until they attach a Telegram account. The count beside the heading tracks that.
If something goes wrong
That phone number cannot be read. Check it and try again. — MekongHRM stores numbers in international form. 012 345 678 and +855 12 345 678 are both fine; anything it cannot read is refused rather than saved wrongly.
The form will not save. The reason is under each field that stops it, and the form moves to the first one. A required field left empty says Required.; an older record asks for them the first time it is edited.
Another staff record already has this phone number. — two people cannot share a phone number in one company, because the number is how Telegram finds who somebody is. Check which record holds it in the staff list, which filters by phone.
Probation cannot end before the start date. — the probation end date is earlier than the start date. The import reports the same row as Probation cannot end before the start date. Check both dates; usually one of them has the day and month swapped.
The import found duplicates. Two rows with the same staff number, or a number somebody already has. 7 and 007 count as the same number. Nothing is imported until every row is clean, so a partial list is never left behind.
A staff number is digits only — the staff number or manager column holds something other than digits, such as E-001 or a name. Write the number alone, or leave the staff number empty to have one assigned.
A single person has no dependant spouse: change the status or the spouse column — the row says single and gives a dependant spouse. A single person has no dependant spouse: change the status or the spouse column. Children are accepted on any row.
Not one of the 25 provinces — the province of work is not one of Cambodia's 25. Use the code, the English name or the Khmer name, and check the spelling.
Write nssf, nssf_adi, private or none — the insurance column holds something other than nssf, nssf_adi, private, none, yes or no.
Importing the ID, NSSF, work permit and bank columns needs the employee.view_sensitive permission. Leave them empty or ask the Owner. — the file fills in ID, NSSF, work permit or bank columns and you do not hold employee.view_sensitive. Empty those columns and import again, or ask somebody who holds it to import the file.
This is the only Owner. Give somebody else the Owner role first, then record the leaving. — a company always has an Owner. Give the Owner role to somebody else under Roles first, then record the leaving.
Another suspension already covers some of those days. — a person has one suspension at a time, and two never share a day. End the one that is running first, or choose other days.
The suspension starts before their start date. — a suspension cannot start before the start date on the record.
Nobody is linked yet. That is the next step: see Link a Telegram account.
Last checked 04/10/2026