Harvester Payroll Help Centre
What Harvester Payroll help can I find?
Find practical answers for employee setup, payroll processing, PAYE, NAPSA, NHIMA, payslips, reports, imports, backups and other Harvester Payroll tasks. Search by keyword or topic, then open a Topic Title for the full answer and any related training video.
Browse Help Topics / Results Open help answers here after searching above
| Key Word |
Topic Title Click to open |
Description / Full Help Page |
|---|---|---|
| Napsa Report for Accumulated Napsa |
How do I print a report for Accumulated Napsa Totals.
Click this Topic Title above to open the full help page
and view any related training video if available.
|
To view the actual "Accumulated Napsa Totals"
Go to the Second Print Options Page (More Reports) and view the Napsa that is accumulated for any or all of your employees.
Use the "NAPSA Accumulated" Report from the NAPSA Section of the "More Reports" page. This will show all accumulated Totals in a single report that you can export to Excel for all years to date.
It is very useful to use these values for Seasonal workers when you would like to print their Leave Certificates and you want to see how much NAPSA was accumulated over the season.
|
| National Health Insurance NHIS or NHIMA |
National Health Monthly Return
Click this Topic Title above to open the full help page
and view any related training video if available.
|
Enter your NHIS "Employer" Account Number by going to settings and then company settings. Please do not enter the preceding letters 'NHIS' for your Company Health Number on Company-Settings page. Some employers have been issued a numeric-only NHIS employer number. In Harvester, go to Settings and then Company Settings and uncheck "Does NHIS precede Health No?" so the export matches the required format." Each member (employee) will also be given a membership number. This employee number can be entered on the Edit-Employee page. Some numbers are 14 digit numbers and others are a combination of "NHA" plus a 10 digit number.
For example: 12341911077853 or NHA1911077853
To obtain an updated listing of each of your unique employee membership numbers, please login to the NHIMA website and click on "returns" and then click on "Upload Return" and finally click on the "Download Sample From Employees" in order to get your existing, unique employee-membership numbers.
Monthly NHIMA Contribution CSV Upload
Important: Please use the report National Health Upload CSV and not the National Health Datareport.
Click the report link National-Health-Upload-Csv.
Click the Export Excel button and this will create a CSV (Comma delimited) file ready for direct upload to NHIMA.
Once you have downloaded the CSV file, do not re-save it before uploading to NHIMA.
Why?
If you open the CSV in Excel and then save it again, Excel may:
Remove leading zeros from NHIS numbers (e.g. 0123456789 becomes 123456789), and
Reformat some values.
This will cause the NHIMA upload to fail.
You may open the CSV in Excel to view it, but if you do, do not save it again - just close Excel and upload the original downloaded file to NHIMA.
This is due to the fact that re saving a CSV file in excel sometimes causes the format to change. For example the long NHI numbers in "Column D" might revert to Scientific notation and all look the same!
In other words, once you have exported your file, it is ready for upload and you do not even need to open it before you upload it to NHIMA.
Note: Sometimes you may find that you still get certain columns of data, like the Employee number on the NHIS upload report, reverting to a scientific notation format where it does not show the actual number. If you literally upload the exported CSV file(without first opening the CSV file) then the upload file should work as it is. If this does not seem to work, then open the exported CSV file in Excel and then use the Excel program to save as a CSV file type. This process will often fix such "format errors" with CSV files.
If you want to verify or do a manual edit of the CSV file, then right click the file and open with Notepad and then you can see the true CSV format that the NHI system wants.
If you do open your CSV file in excel and you see the numbers for NHI for each employee are showing in Scientific notation, do not be concerned. If you put your cursor on one of the numbers (by selecting any cell in "Column D" in excel) and then you look at the formula bar above, you will notice that it actually is storing the number correctly because the formula bar will show the actual 14 digit Number. (The display is just in Scientific notation)
When you pay for National Health, you do not need to download the NHIS template that they provide each month.
For the few employees who have kept the older 10 digit numbers, please enter the letters NHA preceding the number example: NHA5555555555
Note: The health number must not start with ' before the number.
If you have a ' before the number, please remove the '.
So in harvester put the letters NHA instead of the ' or simply remove it so that you just have a numerical number.
Make sure when you Submit to save, its just a number with no blanks saved after it and there is no '.
Then prepare the upload and you will see it will save it correctly.
After you have entered the employee Membership Numbers supplied by the NHIS to you for each employee on Harvester as well as your unique company Number (the 10 digit number following the letters 'NHIS') then you can simply generate the export report and use this to upload to their system.
The report does NOT show the grand totals. Hence you should use the other Health Report called National-Health-Data and export this for your own records. It will be saved in an Excel format and have the total contributions of all employees in the total row. Your payment amount will be double this value.
To make it easier to enter all the employee Membership Numbers, you may use the Quick Table Employee Edit to do batch saves of 15 employees at a time. Tick the tick box for Health and fill in the health number on the employee grid and save up to 15 employees' Health data info at a time.
To make it easier to enter all the employee Membership Numbers, you may use the Quick Table Employee Edit to do batch saves of 15 employees at a time. Tick the tick box for Health and fill in the health number on the employee grid and save up to 15 employees' Health data info at a time.
NB please make use of the Bulk employee update feature by using a Harvester-generated, excel import template.
Type Update or Import in Help and look for the help on "Batch Upload or Update Import of Existing Employees from Excel"
Your existing names, surnames etc are all generated in this Update_Template file. Make sure that you use the same format for employee data in each column of the template file by observing the way your existing data is saved in your downloaded template file. For the NHIMA employee numbers to update your online employees properly, keep the existing format (in CSV) so numbers look like this 14 digit number example: 55,555,555,555,555.00
(once updated online the NHIMA Numbers will look normal)
If you have already processed the wages for the current month before you started enabling employees for NHI then you need to re submit the payment. So after you have ticked the check box for each employee go to edit payments and re submit the current month payment to recalculate so that NHI will show for all those employees who have the tick box checked on NHI. It will remember your setting for the next month.
Note harvester does not do the initial registration of your employees. It does the monthly returns once you have received your registration employee NHA numbers.
Note that the NHI upload report does not and must not have the grand totals for it to work on uploading to the NHI web site when you upload your employee contributions. The other "health" report is good to save for your own records and this has the grand totals at the bottom.
Each employer needs to register all the employees with the NHIS (National Health Insurance Scheme). Harvester does not register your employees for you. This needs to be done once-off by you. However its very helpful to use the full summary report that Harvester produces in excel to copy and paste the relevant columns into the "Bulk Member Registration Sample" that NHIS provide on their website under "Employees".
|
| National Health NHIS Employee Upload NHIMA Return |
How do I update Harvester for the new NHIMA platform?
Click this Topic Title above to open the full help page
and view any related training video if available.
|
Enter your NHIS "Employer" Account Number by going to settings and then company settings. Please do not enter the preceding letters 'NHIS' for your Company Health Number on Company-Settings page. Some employers have been issued a numeric-only NHIS employer number. In Harvester, go to Settings and then Company Settings and uncheck "Does NHIS precede Health No?" so the export matches the required format."
The Monthly Contribution CSV Upload:
NB. You must choose the report called "National Health Upload CSV" and not the "National Health Data" report.
Click the report link called National-Health-Upload-Csv and then simply click on the "export" EXCEL button to create a CSV file-type for direct upload to NHIMA.
Once you have DOWNLOADED the CSV(Comma delimited.csv), do not re-save the CSV file before uploading.
ie Do NOT open your exported csv file and re-save before uploading as your upload file won't work".
You can open the file in EXCEL BUT because it is a CSV file, DO NOT SAVE IT, just view it.
This is due to the fact that re saving a CSV file in excel sometimes causes the format to change. For example the long NHI numbers in "Column D" might revert to Scientific notation and all look the same! If you do open your CSV file in excel and you see the numbers for NHI for each employee are showing in Scientific notation, do not be concerned. If you put your cursor on one of the numbers (by selecting any cell in "Column D" in excel) and then you look at the formula bar above, you will notice that it actually is storing the number correctly because the formula bar will show the actual 14 digit Number. (The display is just in Scientific notation)
Note: Sometimes you may find that you still get certain columns of data, like the Employee number on the NHIS upload report, reverting to a scientific notation format where it does not show the actual number. If you literally upload the exported CSV file(without first opening the CSV file) then the upload file should work as it is. If this does not seem to work, then open the exported CSV file in Excel and then use the Excel program to save as a CSV file type. This process will often fix such "format errors" with CSV files.
If you want to verify or do a manual edit of the CSV file, then right click the file and open with Notepad and then you can see the true CSV format that the NHI system wants.
After you have entered the employee numeric Membership Numbers (the 14 digit number) supplied by the NHIS to you for each employee on Harvester, then you can simply generate the new export CSV report and use this to upload to their system.
To make it easier to enter all the employee numeric Membership Numbers, you may use the Quick Table Employee Edit to do batch saves of 15 employees at a time. Tick the tick box for Health and fill in the health number on the employee grid and save up to 15 employees' Health data info at a time.
NB please make use of the Bulk employee update feature by using a Harvester-generated, excel import template.
Type Update or Import in Help and look for the help on "Batch Upload or Update Import of Existing Employees from Excel"
Your existing names, surnames etc are all generated in this Update_Template file. Make sure that you use the same format for employee data in each column of the template file by observing the way your existing data is saved in your downloaded template file. For the NHIMA employee numbers to update your online employees properly, keep the existing format (in CSV) so numbers look like this 14 digit number example: 55,555,555,555,555.00
(once updated online the NHIMA Numbers will look normal)
For the few employees who have kept the older 10 digit numbers that NHIS for some reason have kept the same, please enter the letters NHA preceding the number example: NHA5555555555
Note: The health number must not start with ' before the number.
If you have a ' before the number, please remove the '.
So in harvester put the letters NHA instead of the ' or simply remove it so that you just have a numerical number.
Make sure when you Submit to save, its just a number with no blanks saved after it and there is no '.
Then prepare the upload and you will see it will save it correctly.
Any employee who is over 65 is not accepted for NHIMA. In this case please remove the employee using the National Health check box on "Edit-Employee".
|
| Net pay as fixed amount |
How do I pay a specific after tax NET pay
Click this Topic Title above to open the full help page
and view any related training video if available.
|
Everything is taxable. This is very important as it's PAYE law.
To get a fixed NET wage:
First add all the extras (if there are any ) and the employee's fixed monthly salary and then pay the employee using the normal monthly payment-capture and note what the net pay is.
If it's less than your desired NET payslip amount then you need to add more to the gross and then re submit the payment. It's probably best to increase or decrease the fixed salary accordingly. To start with use a rough plan of 1.37 times the net amount to work out what the rough gross wage before tax will be.
Once you change the fixed salary the gross and net will also change after you re submit the payment. (use edit payments to do this and note that you may not get an exact NET amount due to the tax computations but you will be able to get the NET to within about K5.)
People don't normally work backwards from net pay but this would be the best method to follow if you are wanting to pay an employee this way.
It might take a few times (of editing the current payment) to get the fixed amount correct so that the net payslip is as you would like. At least for the next and subsequent months it will be pretty close for the first time you process the pay (if in the following months the extras remain the same).
Note: on the edit-payments form if you click on the employee number you will be taken straight to the specific payslip in order to check the Net and then by pressing the back arrow on your browser you will return to the same place you were on the edit-payments screen.
|
| Net Pay not on payment capture screen |
Why is the Net Pay not on payment capture screen?
Click this Topic Title above to open the full help page
and view any related training video if available.
|
You can see the Net-Pay on the edit payment screen.
Unfortunately you do not see the Net pay as you enter values on the payment capture screen.
The online system waits for you to "submit" so that your net wage calculation is updated and calculated on the cloud.
However you will see the Net-Pay value if you edit any submitted payment.
|
| NHIS or NHIMA duplicate error record |
What do I do if I see the 'duplicate record' error when i upload to NHIMA?
Click this Topic Title above to open the full help page
and view any related training video if available.
|
What do I do if I see the 'duplicate record' error when I upload to NHIMA?
Check first that you have upload the exported CSV file directly. ie you have not been editing the csv file before uploading to NHIMA.
Use the EXCEL export button to create an .XLSX fle and then 'Save As' filetype .CSV for direct upload to NHIMA.
Once you have saved the excel file as CSV(Comma delimited.csv), do not re-save the CSV file before uploading.
ie Do NOT open your exported csv file and re-save before uploading as your upload file won't work".
This is due to the fact that re saving a CSV file in excel sometimes causes the format to change. For example the long NHI numbers in "Column D" might revert to Scientific notation and all look the same! If you do open your CSV file in excel and you see the numbers for NHI for each employee are showing in Scientific notation, do not be concerned. If you put your cursor on one of the numbers (by selecting any cell in "Column D" in excel) and then you look at the formula bar above, you will notice that it actually is storing the number correctly because the formula bar will show the actual 14 digit Number. (The display is just in Scientific notation)
If you want to verify then right-click the file and open with Notepad and then you can see the true CSV format that the NHI system wants.
When you open the text file you can easily see if they are all unique NHI numbers and not duplicates.
Note:
You may also check your CSV file by opening the actual CSV file and putting your cursor on the NHA member ID field (eg cell D1). Then press the "down-arrow key" and move through all your data rows and you will be able to check in the display area of excel (the formula bar above) for the actual numbers and they should be 14 digits. This is how Excel actually stores those numbers.
|
| NHIS or NHIMA number missing or not showing on upload |
Why is an employee with a NHA number not showing on upload
Click this Topic Title above to open the full help page
and view any related training video if available.
|
Why is an employee who has an NHA number not showing on the upload?
You may have entered the NHA number of the employee and marked the employee as paying NHIS but the employee NHA number is not appearing on the excel-download off Harvester.
The employee has NHIMA deducted, but there is no NHA employee number?
On Harvester, using the Quick-employee-table-edit or the Edit-Employee page, check there are no blank spaces before or after the end of the NHA number in the NHA employee field.
The number may be there, but it could be followed by blank spaces.
If you put your cursor in the field for NHA number, then use the right arrow key to move to the end of the field and then backspace to delete the spaces.
Note: The health number must not start with ' before the number.
If you have a ' before the number, please remove the '.
So in harvester put the letters NHA instead of the ' or simply remove it so that you just have a numerical number.
Make sure when you Submit to save, its just a number with no blanks saved after it and there is no '.
Then prepare the upload and you will see it will save it correctly.
|
| NHIS or NHIMA number or TPIN duplicate |
NHIS or TPIN duplicate error on Harvester
Click this Topic Title above to open the full help page
and view any related training video if available.
|
There is only allowed to be one NHIMA NHIS number and TPIN per employee:ie no duplicates.
To find which employee was assigned the duplicate number remember the following:
It may have even been allocated to one of your terminated employees.
Go to Reports and under the "General-Reports" section, look for the Personal-Details report. You can export the report to excel if its hard to find it by scanning through the report. (in excel you can also sort your employees by the Healthno)
To select a report for ONLY employees who have been Terminated:
Use the "Status" Search option above the report to select for employee Terminated and then press the Search Button once you have selected "Terminated" employees in the "Status" Search option.
|
| Non Company-Wide Extras for individual employees |
Why can't I add Custom Extras Company Wide
Click this Topic Title above to open the full help page
and view any related training video if available.
|
Adding Custom Extras for Individual Employees when extra is NOT a "Company Wide Extra".
If you try to add a custom Extra to an individual employee you may notice the message "Extras that are NOT company wide extras can be assigned to individual employees".
The option to Add or Assign extras to employees is only available for Extras that have NOT been defined as "Company-Wide".
The "Company Wide Extras" must be added under "Settings" and then "Extras". These extras are only for those custom extras that you would like to apply for EVERYONE within the company and therefore you can not add them to individual employees.
If you have already added a "Company Wide Extra" then you do not need to go to the individual employee to add the same extra as as they would already be applied to everyone.
If you would like to only specify certain extras for certain Individual Employees, then you need to add an extra that is NOT specified as the Type "Company-Wide". This can also be done under "Settings" and then "Extras". Then these extras may be added individually to the employee.
|
| NRC Numbers |
How do I enter an employee where there is no NRC Number?
Click this Topic Title above to open the full help page
and view any related training video if available.
|
Harvester will indicate that a NRC number is required to save an employee. This is still true even with a passport number or Social Security Number entered.
This is correct as the NRC number is a unique field.
You can not enter an employee without an NRC number. This is to stop ghost workers, duplicate employee entries or employees using the same NRC Number.
If there is no NRC Number? By law all Zambian employees must have an NRC Number but this does not always happen.
Leave the default NRC Number even though it is officially non-real and auto generated. A Zambian employee has to get an NRC number, so this is a temporary measure.
A passport number may be used for NAPSA returns instead of NRC but this is allowed only for Non-Zambians. Harvester will ignore the auto generated NRC Number for online NAPSA submissions.
Note: See help on NAPSA Passport Numbers.
|
Harvester Payroll Training Videos
Browse short, step-by-step Harvester Payroll videos. Each video has a dedicated page connected to the relevant Help topics, with an option to continue watching on YouTube.
Open Training Videos Hub