Harvester Payroll Help Centre

Search answers for employee setup, Excel payroll imports, timebooks, PAYE, NAPSA, NHIMA, payslips, reports and AI reporting.

Browse Help topics

228 topics found.

Browse Help Topics / Results Open help answers here after searching above
Key Word Topic Title
Click to open
Description / Full Help Page
Multiple batch uploads or imports limit of employees How do I import a batch amount of employees after I have already used the feature 7 times?
Click this Topic Title above to open the full help page and view any related training video if available.
If you need to import more than 7 different batches of employees after you have already used this feature Seven times, then you need to contact support@harvesteronline.net You are allowed 7 batch uploads on the standard version as this module requires lots of Cloud processing. After a small upgrade cost of $30 you will be allowed to do Seven further batch employee imports. To avoid an upgrade cost, especially for smaller amounts of new employee imports do the following: First add the employees using edit employees and then use the Quick-Table-Employee-Edit to put further details of the new employees in quickly using the single page edit for multiple employees. In this way you do not need to use the batch import. For the batch employee import, we recommend you use this module for importing 40 or more employees at a time. However you may use it to import any amount of employees.
NAPSA Ceiling Do I need to change NAPSA brackets on the online system at the end of the tax year?
Click this Topic Title above to open the full help page and view any related training video if available.
No, you do NOT need to change NAPSA ceiling amounts or percentages on the online system at the end of the tax year. You do NOT need to change tax brackets either.
Napsa Employee SSN number does not match NRC Napsa error on upload for return
Click this Topic Title above to open the full help page and view any related training video if available.
If you see an error on the Napsa upload saying "SSN number does not match the NRC" or "Napsa employee number does not match": This is an issue with a specific employee's NRC number that can only be linked to the correct SSN number (Social Security Number) that is issued by NAPSA to each employee registered with NAPSA. Only NAPSA issues the Social Security Number and for the upload to work each employee must have the correct NRC number linked with the correct Social Security Number. If not, the file will fail to upload. Check that the Social Security Number is correct on Harvester online. Ask NAPSA what the correct SSN number for each employee is if you don't know it. To edit the Social Security Number on Harvester online, go to Edit-employee and then look under Personal Details for the 'Social Security No' field to edit or enter it. Note: Napsa WILL reject any employee where the Social security number they have on record does not match the NRC number. Even if you think you may have the correct Social Security number for an employee that Napsa has given you, it might not match the digital online record that they have. The Social Security number can only be provided by NAPSA and only AFTER an employee is fully digitally registered with them.
Napsa EmployER number mismatch Napsa error on upload for return - EmployER number mismatch
Click this Topic Title above to open the full help page and view any related training video if available.
If you see an error on the Napsa upload saying "EmployER number mismatch" This is normally an issue with a specific employee's SSN number (Social Security Number) that is issued by NAPSA to each employee registered with NAPSA. However this Number is linked with a specific EmployER number! Sometimes employees move from working for one company to another and if this has not been updated with NAPSA for the particular employee, then the file will fail to upload. Ask NAPSA to make sure the SSN number for the employee is linked with your NAPSA employER number. Also please make sure that you have registered your correct NAPSA employer number on the company settings page. The default is 33333 for all newly registered companies with Harvester Online and this needs to be edited to your employer number.
NAPSA Gratuity Severance Pay End of Contract Contributions Is NAPSA charged on Gratuity or end-of-contract payments?
Click this Topic Title above to open the full help page and view any related training video if available.
YES - NAPSA should normally be calculated on a gratuity or end-of-contract service payment where the employee is liable for NAPSA, subject to the normal annual NAPSA contribution ceiling. This question sometimes causes confusion because the PAYE treatment of gratuity and the NAPSA treatment are not the same thing. A payment being exempt from PAYE does NOT automatically make it exempt from NAPSA. WHAT DOES NAPSA SAY? NAPSA states that contributions are based on an employee's gross earnings. NAPSA explains that, for contribution purposes, earnings include benefits given by an employer in exchange for an employee's service. In its published guidance NAPSA specifically includes: - Basic salary - Bonuses - Commission - Severance pay - Overtime allowance - Leave allowance - Acting allowance - Commuted leave days - Other service-related earnings This is important when considering a gratuity or other payment made at the end of an employee's contract. GRATUITY UNDER THE EMPLOYMENT CODE ACT Section 73 of the Employment Code Act No. 3 of 2019 provides that an employer shall, at the end of a long-term contract, pay qualifying gratuity of not less than 25 percent of the employee's basic pay earned during the contract period. Where the contract is terminated in accordance with the Employment Code, the gratuity is prorated for the period of employment. Gratuity and severance pay are separate legal terms under the Employment Code and should not simply be treated as identical. However, gratuity is clearly an end-of-contract payment calculated from remuneration earned for the employee's service. For NAPSA purposes the important issue is whether the payment forms part of earnings or a benefit arising from the employee's service. NAPSA's own published guidance expressly confirms that severance pay is included in earnings for contribution purposes. THE NATIONAL PENSION SCHEME ACT 2026 The National Pension Scheme Act No. 72 of 2026 replaced the previous National Pension Scheme Act framework. The Act defines "earnings" broadly to include a wage, salary, allowance, bonus, commission, incentive and non-cash benefits that have a monetary value. Section 24 provides for employer and member pension contributions and states that the member's contribution is deducted from the member's earnings to which the contribution relates. NAPSA announced in August 2026 that Statutory Instrument No. 62 of 2026 brought the new pension reforms into effect. IMPORTANT - PAYE AND NAPSA ARE DIFFERENT Do not assume that because a gratuity or other payment has a particular PAYE treatment it is automatically exempt from NAPSA. NAPSA itself explains that PAYE exemptions do not automatically affect NAPSA deductions. NAPSA contributions are governed by the pension legislation and NAPSA rules relating to gross earnings. HOW HARVESTER TREATS THE PAYMENT Where an employee is subject to NAPSA, Harvester treats the gratuity/end-of-contract service payment as part of the earnings relevant for NAPSA contribution purposes, subject to the applicable NAPSA ceiling. If the employee has already reached the NAPSA contribution ceiling for that month, the normal ceiling will prevent additional NAPSA being charged above the statutory maximum. The employee and employer NAPSA portions remain subject to the normal NAPSA rules. OFFICIAL REFERENCES NAPSA guidance confirming that earnings include severance pay: https://www.napsa.co.zm/revision-in-contribution-ceiling-for-the-year-2025/ NAPSA earlier public notice explaining the same gross-earnings principle: https://www.napsa.co.zm/public-notice-revision-of-contribution-ceiling-and-pension-payments-for-2022/ National Pension Scheme Act No. 72 of 2026: https://zambialii.org/akn/zm/act/2026/72/eng@2026-06-12 NAPSA announcement on implementation of the 2026 Act: https://www.napsa.co.zm/news/details?id=dt91c3bb-5416-4a53-b521-73923e0ccf112 Employment Code Act No. 3 of 2019 - see section 73 on gratuity: https://www.parliament.gov.zm/sites/default/files/documents/acts/The%20Employment%20Code%20Act%20No.%203%20of%202019.pdf If there is uncertainty about the treatment of an unusual payment or employment arrangement, the employer should obtain confirmation directly from NAPSA.
NAPSA iCARE Tips for new NAPSA iCARE
Click this Topic Title above to open the full help page and view any related training video if available.
Monthly NAPSA Contribution CSV Upload Click the report link NAPSA-Electronic Return. Click the "Export" Excel button - this will create a CSV (Comma delimited) file ready for direct upload to iCARE. Once you have downloaded the CSV file, do not re-save it before uploading to iCARE. Why? If you open the CSV in Excel and then save it again, Excel may: Reformat some date values. This will cause the iCARE 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 iCARE. 1) Check your upload is in pure CSV format: If you right click your upload file and open with a text editor like notepad, then you should see all your data neatly in a row separated by commas. One row per employee. You will note and that each data field itself is just the data value and it is not enclosed in double quotes. Example: The Year will be 2025 and not "2025". If you see the double quotes then you have probably opened the downloaded file and saved it on your computer again which can change the format. Just download directly from Harvester and don't open it to save again. NB: Export from Harvester as normal: NB No re-saving or reformatting required. Simply download and upload without opening the CSV file. 2) Employees who have a second name. Employees who have a second name on their NRC. The second name now has to be stored in the first-name field by ensuring there is a space between the first and the second name within the same first-name field. The second name is not stored in the "other " name field. The other name field should remain blank on the upload. 3) If there is no birth day or month visible on the NRC: Add every employee's full birth date and use the 31st of December for the day and month.
NAPSA NRC or Passport How do I enter a Passport No for a non Zambian paying NAPSA?
Click this Topic Title above to open the full help page and view any related training video if available.
How do I handle employees on work permits but without NRC numbers? On edit employees at top right hand side enter the passport number. The NAPSA return will then use the Passport Number instead of NRC number. Note: Harvester will still say that a NRC number is required to save the employee, even with a passport number entered. This is correct. 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. Leave the default NRC Number even though it is officially non-real and auto generated. Only the passport number will be used for NAPSA returns so there is no need to worry about the NRC number. Harvester will ignore the auto generated NRC Number for online NAPSA submissions.
NAPSA over 55 years What do I do for employees who are over 55 years?
Click this Topic Title above to open the full help page and view any related training video if available.
For those employees older than 55, its best to remove the tick box 'NAPSA?' on edit employees. It says 'Do not remove' but in the case of an employee over 55 it is perfectly legal. In this case no NAPSA will be deducted off the employee and the same for the Employer. I do know that the employer can voluntarily pay the employer's portion of an over 55 year old employee for NAPSA, but this is not compulsory.
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.
NHIMA 2027 CONTRIBUTION BASIS (updated 13 November 2026) Harvester is prepared for the reported January 2027 switch from basic pay to gross pay. The 2026 rule remains 1% employee and 1% employer on basic pay. The 2027 Harvester Online setting is GROSS, subject to final NHIMA regulations and guidance about included earnings and the contribution split. Customers can view the yearly NHIMA basis on their read-only Tax, NAPSA and NHIMA Settings page; only a Harvester Level 10 administrator can change it. For the calculation explanation and examples, search Harvester Help for: NHIMA 2027 Basic vs Gross Pay. The NHIMA member-number and monthly return instructions below remain applicable. 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".

Learn at your own pace

Harvester Payroll Training Course

Watch step-by-step training videos, from New Company Setup to payroll processing, imports and reports. Each video connects to relevant Help topics.

New to Harvester? Start with the New Company Setup training.

Next steps

Next steps
Start 10-week Free Trial Choose a Plan Prices Customers & Partners PAYE & Net Pay Calculator

Get in touch

Email: support@harvesteronline.net

WhatsApp Text Only: +260969078711

Location: Plot E, Mazabuka, Zambia

by Sean Kelly : For the Glory of God