» Home » technology » software » easyfile » SARS easyFile Employer Problems – Troubleshooting

SARS easyFile Employer Problems – Troubleshooting

For easyfile Forms Viewer issues go here

This page is my reference and a free resource in which I’ve attempted to explain in the simplest way possible something that is rather complex. It is for those who want to do it on their own. If you can’t come right on your own, with these instructions as a guide, do not call me, to get me to explain how it works.
Don’t call me if you not prepared to pay, “quick questions” are never “quick”, as I need enough information to make an informed decision and that usually takes time.
I have not “saved” any tips or tricks although I use a different more technical method myself. Absolutely everything I use to fix easyFile is somewhere on this page. Need help but don’t want to pay, then read carefully and post a question if you can’t find an answer or take a look at the easyFile facebook group – https://www.facebook.com/groups/easyfile/

Please understand people, I’m no psychic and I do not practice voodoo or magic. Figuring out what is wrong is just like any other profession. I have to know what the situation is.
It is like you asking me, “How do I get to Timbuktu?”, without me knowing where you are and more crucially, you not knowing where you are I cannot possibly direct you. At least half of what I do when I get on people’s PC’s is figuring out where the PC is at.
So it is not that I won’t give you an answer, it is that I can’t give a meaningful single sentence answer.

Want to say thank you for help, please post a review to any of the following sites

Are you tired of fighting with easyFile? Contact me on my cell 084 584 7268 to schedule a time to get it fixed. R700.00 (I am not VAT registered) for a guaranteed fix. No fix, no fee! Work on servers is 1.5x the fee

How to install easyfile 7.1.8

7.1.8 includes the easyfile forms viewer 1.3.1

I personally prefer not to auto update. I’ve seen more issues with automatic updates, than a manual download and install. Make sure to always do a backup before you start.

Standard Simple Installation Instructions

First try an install without any of the tweaks below

  • Backup – always make sure you have decent backups
  • Uninstall all current versions of Java
  • Download 7.1.8 and run it, make sure to let it install Java when it asks. If that does not work then try the next method.

Tweaked Installation if Simple Fails

  • Backup – always make sure you have decent backups
  • Uninstall “ALL” Java versions
  • Uninstall current easyfile version
  • Uninstall current Adobe Air version
  • Reboot your PC
  • Download 7.1.8: via DropboxGoogle Drive or SARS Direct Link – (7.1.8 Release Notes) [04.10.2021]
  • Once downloaded right-click the filename & at the bottom select Unblock – if there is no Unblock move to the next step
  • Right click the “Setup_EMP_717_WIN.zip” file and Extract Files, from the extracted folder double-click “Setup Employer.exe” to run
  • Let it install Java as well as Air

I’ve had some issues with Kaspersky Internet/Total Security & Trend Micro blocking Java from running. Kaspersky AV doesn’t cause any issues.

I’ve also had issues with Avast & now AVG blocking the java when exporting IRP5’s. If you use Avast or AVG and you get no PDF files when you export, try pause your anti-virus and run again. You can see if easyfile is being blocked in Avast & AVG by going to Menu > Settings > Blocked & Allowed Apps – make sure that the offline.jar is not blocked

If you still can’t get it running, then your problem is more complex and I can only assist by getting on your PC to troubleshoot what the issue may be.


Disabling the Firewall in Windows 10, 8, 7 and Server 2016 or 2019

  1. Open Control Panel
  2. Click System and Security link
  3. Click Windows Firewall or Windows Defender Firewall
  4. Click Turn Windows Firewall on or off
  5. Select the bubble next to Turn off Windows Firewall (not recommended) in both the private and the public section.
  6. Click the OK button to save changes
  7. Remember to Turn On once you are done

Turning Windows Defender off in Windows 10

  1. Open the Start menu
  2. Click Settings
  3. Click Update & Security
  4. Click Windows Security
  5. Click Virus & threat protection
  6. Click Virus & threat protection settings
  7. Toggle off “Real-time protection

Uninstalling JAVA Versions

Try uninstalling all versions of Java before installing easyfile using the following tool – https://java.com/en/download/help/uninstall_java.xml

easyFile Newsletter

The newsletter will be used to notify people of fixes, new releases or issues.

Are you having problems with installing SARS easyFile-employer to your Windows PC, here are some possible fixes, tip’s & tricks to try?

Please send me your fix, if you had an error and you managed to sort it out. I’ll post it for other people’s benefit.

“Not interested in wasting your time on trying to fix easyFile. I can fix it for you, so you can get on with what is important to you.
I’ve seen too many people waste loads of time and still not come right.” Details at the bottom of the page

ActiveX Internet Explorer Issues – don’t use lightly

If you find your easyfile.dbz is not opening, it may be an issue with Internet Explorer blocking Java from running. You can test this by opening Internet Explorer and typing the following address in your address bar https://www.java.com/en/download/installed.jsp?detect=jre, you will need to authorise the java for it to run.

This might resolve your issue or you may have to dig a little deeper.

This command may need to be run from an elevated command prompt.

REG ADD "HKCU\Software\Microsoft\Windows\CurrentVersion\Policies\Ext" /v VersionCheckEnabled /t REG_DWORD /d 0 /f

More radically - not too be used without understanding
REG ADD "HKCU\Software\Microsoft\Windows\CurrentVersion\Policies\Ext" /v VersionCheckEnabled /t REG_DWORD /d 0 /f
REG ADD "HKCU\Software\Microsoft\Internet Explorer\VersionManager" /v DownloadVersionList /t REG_DWORD /d 0 /f
REG ADD "HKCU\Software\Microsoft\Internet Explorer\Safety\ActiveXFiltering" /v IsEnabled /d 0 /f
REG ADD "HKLM\SOFTWARE\Wow6432Node\JavaSoft\Java Update\Policy" /v EnableJavaUpdate /t REG_DWORD /d 0 /f
REG ADD "HKLM\SOFTWARE\Wow6432Node\JavaSoft\Java Update\Policy" /v NotifyDownload /t REG_DWORD /d 0 /f
REG ADD "HKLM\SOFTWARE\Wow6432Node\JavaSoft\Java Update\Policy" /v UpdateSchedule /t REG_DWORD /d 0 /f
REG ADD "HKLM\SOFTWARE\Wow6432Node\JavaSoft\Java Update\Policy" /v UpdateMin /t REG_DWORD /d 0 /f
REG ADD "HKLM\SOFTWARE\Wow6432Node\JavaSoft\Java Update\Policy" /v UpdAvailNotifyCnt /t REG_DWORD /d 0 /f
REG DELETE "HKLM\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run" /v SunJavaUpdateSched /f
del "C:\Users\%username%\AppData\Local\Microsoft\Internet Explorer\VersionManager\versionlist.xml"

EMP201 or EMP501 hangs at 0% error

Disconnect your internet connection. You can do this by removing your network cable or turning off your wireless.
Now start easyFile, open your company and go to the Notification Centre, it will give you an error.
Now reconnect your internet, it will ask to download the EMP 501, click OK

I’ve often heard people say “easyFile is not easy!” and that people prefer to do EMP 201 entries in eFiling.

Please be aware that it is from past feedback, that I am able to give assistance, so please let me know if you come right and what you found the issue was.

Ensure that you have backed up your data before attempting any of the following troubleshooting tips.

EMP501 Declaration not displaying

Your EMP501.swf might be corrupt. Exit easyFile, find the EMP501.swf [The file is in your easyFile folder under FlexForms.], delete it and then re-start easyFile, it will install a new copy. If you are still having problems, clear your Temporary files. Google it for your Operating System.

Clearing the Temporary Folder

  1. Press the Windows Button + R to open the “Run” dialog box.
  2. Enter this text: 
  3. Click “OK.” This will open your temp folder.
  4. Press Ctrl + A to select all. 
  5. Press “Delete” on your keyboard and click “Yes” to confirm.
  6. All temporary files will now be deleted.
    Note: Some files may not be able to be deleted. If you are prompted about files that are missing or in use, click the check box next to “Do this for all current items” and click “Skip.”

User’s and Passwords

Please keep these in a safe place, you will not be able to access your data if you lose your login details.
Passwords require Upper and lower case as well as a number and special character. Just don’t use “&
Make sure to add a hint, it might come in really handy if you get stuck.

Forgotten your Password

You will always have an ADMIN user as it is an easyFile default. You can try open easyFile then put in your username, use ADMIN if in doubt and then click “Forgot Password?” and it will supply the hint you added when you first created the users.
Still stuck, click “Secure Reminder” this will ask you to login to Efiling and supply a password.

Older versions of easyFile as well as Java & Forms Viewer

Click on the blue box below to go to my archive of older versions. If you have a version I do not have, please send to my email or share via OneDrive, DropBox, Drive etc

Which JAVA version should I have?

It no longer matters whether you have 32-bit or 64-bit Windows. You need the 32-bit Java version that installs with 7.1.8 which is Zulu JRE (8u252) or

What versions of Adobe Reader and Air

I’ve tested up to

  • Adobe Air download here – stick with for best compatibility
  • Adobe Reader DC 21.007.20091, download here or here – make sure to deselect the Optional offers [You need the 32-bit version, 64-bit version with give errors]
  • Forms Viewer 1.3.1, download here
  • JAVA Zulu JRE version, will run with the latest version of JAVA as long as the Zulu JAVA is also installed

Connect if Disconnected

  • In Internet Options, under the security section turn off SSL 3.0 and turn on TLS 1.0
  • Go to Internet Options (Either through Control Panel or from the Tools menu in Internet Explorer). From here, click the connections tab and make sure that Never dial a connection is checked
  • Disconnect your internet connection. Now login to easyFile and open a company, enter the declaration screen and then reconnect your internet.

easyFile Employer – security certificate error

When trying to log into a taxpayer’s profile, you get the message

“Revocation information for the security certificate for the site is not available. Do you want to proceed, yes or no?”

To fix, do the following:

  • Open Internet Explorer
  • Click the gear in the upper-right side of the page “Tools” or Alt+X, select “Internet options”
  • Choose the “Advanced” tab
  • Click “Reset”
  • Check the “Delete personal settings” box and click “Reset” to finish

Fix for EMP201 hangs or gets stuck on 100% whilst updating

Thanks to Ryjin: Had endless issues with the EMP 201 update. It stayed stuck on 100% and would NOT let me into easyFile. Best way to get around this is to: logon without an internet connection. Enter the declaration screen and then reconnect your internet!! This will update accordingly and you will finally be able to work!! Yay!!

This can also be a permissions issue, you need to make sure EMP201.swf is writable, it is in the \Local Store\FlexForms folder. Look below for more information on the sata store location for the different versions of Windows.

Setting up easyFile EMP201 to work with eFiling

In order to make use of the EMP201 function on easyFile™ Employer, you need to ensure that your EMP201 is registered and activated on your eFiling profile. You also need to make sure your user rights are set up correctly so that you can submit and pay your EMP201 using easyFile™ Employer. You must synchronise your easyFile Employer information with your SARS eFiling website profile. Once your SARS eFiling profile is setup, and the relevant EMP201 reference number activated, synchronise the software.

Does your PC have multiple drives or partitions?

Ensure that you install to the C:\ drive, huh, yeah! you heard me. You need to ensure that you install SARS easyFile Employer AND Java to your C:\ drive. [This will only show up on PC’s with multiple drives or drive partitions.] You can do this by selecting the Advanced checkbox when installing Java, and selecting your install location when prompted.

Windows 7, easyFile database location

The EasyFile.dbz database is stored in “C:\Documents and Settings\[user name]\Application Data\easyFileEmployer.???\Local Store\”
The ??? is a unique number string for your PC.

Windows 8, 8.1 & 10, easyfile database location

Folder is C:\Users\[user name]\AppData\Roaming\easyFileEmployer.???\Local Store\
The ??? is a unique number string for your PC.

Easyfile login issues

You won’t believe it – your efiling password can use an ‘&’ but easyFile doesn’t like it. So eFiling is fine with the ‘&’ sign but not easyFile. The staff at SARS helpline (0860-12-12-18) directed me to click on “secure reminder”. Use your SARS efiling login name and password. Their system then generated a password that worked.

General info

Different Errors

Adobe Air Installation Issues

Having problems with your machine saying you need Administrator permissions to install Adobe Air. Got to the following page, download the Microsoft Fix and run it, select the appropriate responses and then try install again.

Full story – “C:\Program Files (x86)\Common Files\Adobe AIR\Versions\1.0\Adobe AIR Application Installer.exe” – ignoreExpiredCertificateTimestamp

If Air won’t install run in Windows 8 compatibility mode as administrator.

Remove File Association

Open elevated command prompt

For your payroll file

assoc .21=


Additional Information

Final Straw – Reached the end of your tether – I can help fix easyfile

  • Have you read through the whole thread and still can’t get easyfile working?
  • or just can’t be bothered wasting your time

I offer a guaranteed service to get easyfile up and running for R700 or [R1400 after hours] (I’m not a VAT vendor). Payment due on completion of repair.

It takes me from 15 min to 2 hours to get easyfile working.

Here’s how I work

  1. WhatsApp, call or email me to explain your issue and arrange a time to repair. I prefer a phone call or WhatsApp as I can run through questions to get a clearer picture of the issue
  2. If you have TeamViewer installed, skip to step 3, to get TeamViewer.com, click the green “Download TeamViewer” button. Install the software making sure you select “for personal use”
  3. Send me the TeamViewer ID and password via WhatsApp, the password changes each time you reboot so only send 30 minutes before the scheduled repair time.
  4. I’ll get onto your PC and get easyfile to the point where you can open your files
  5. You send me your billing details & email address
  6. I’ll generate an invoice and email it to you
  7. You pay
    I have a 95-99% success rate. Mainly because I don’t give up until it’s fixed. The most hassle I’ve had was with a an Apple Mac running Windows 7 Home under Parallel’s and the database backup turned out to be corrupted.


184 thoughts on “SARS easyFile Employer Problems – Troubleshooting”

  1. Hi Grant,

    Do you know if there is a way to export a flat file (.csv format probably) from the easyfile database? We manually load around 700 certificates through the year for once of freelancers, and it will be easier to do a final check on a spreadsheet, rather than easyfile.


  2. Hi there, please give me the steps to follow when doing the resubmission to easyfile for 2017. I’m so scared that I will recreate new IRP5 numbers etc………and I just need to resubmit due the the Easyfile stuff up.

  3. Hi there.

    If I have multiple pay frequencies, how would I import this into easyfile? I have monthly, fortnightly and fortnightly casual employees, but I cant seem to import more than one certificate

  4. Thank You So much for this page. This is the second time in a year that you’ve saved me a sleepless night. If I was that kind of woman I’d’ve offered you a lapdance. Alas…

    Here have a virtual Cookie instead

  5. Grant, amazing help… had “certificate invalid error”, then Java updates failed, etc. Followed your steps, eventually uninstalled all Java versions, Adobe Air and Easyfile itself, restarted machine and ran it all again. Fingers were crossed hard, but success! Thanks for the awesome service…

  6. Hi. Is it possible that EasyFile is unstable. I did 17 IRP5s over the last 2 days. I have gone back to check on them and some have dissappeared and at least one has mixed information between 2 different employees on IRP5’s that were following on from each other. I know they have dissapeared because they started with number 1 to 17, and now 5 and 6 are just not there and 10 and 11’s information is mixed and 10 is not there.

  7. Hi, I have an error while importing the tax year end file. “Invalid value for code 6010”. any advise, please help

  8. 6010 – Go to the error log, it will tell you how many records you should have. Then in the upload file, right at the bottom by 6010 you change the number to what it should be

  9. Hi thank you so much for your page and help, this was my 3rd bi-submission and if it wasnt for your page I would have had endless sleepless nights. Appreciate your help. Do you have any FAQ on how to understand the PAYE Dashboard please? As well as the ETV, it does not give me the option to view. I submitted our recon and it shows successfully submitted. On my dashboard I only have one red light and the Liability shows R3.00. I also have some figures in the AA88 section (this is the section I dont understand) what does this all mean? Any advice would be appreciated, thank you.

  10. HI I am unable to download the IRP5/IT3 Certificates for 202002, the screen opens on preparing export operation… but hangs and nothing happens, any idea how to fix this?

  11. Grant – The living legend. Thanks for helping to demystify this short sited and horrible App. Worked like a bomb as of 09/06/2020

  12. Hi, I am unable to open the PDF IPR5 documents that was exported from Easyfile. The error I receive is “There was an error opening this document. Access denied.” How do I fix this?

  13. Hi there, I merged a company with our easyfile and since then all the companies has disappeared on Easyfile, if I go into the app data they are all there but just doesn’t show on easyfile itself, how can I correct this problem please? I have restored a back up, re installed the application, nothing has worked so far

  14. Hi, I have and error trying to synchronize easyfile with the efilling, after login getting message what can I sync only All is available, after clicl sync getting beloww message:
    An error occurred.
    Please attempt this operation again.
    If this error continues, please contact the eFiling helpdesk on
    0800 00 SARS (7277).

    Technical Detail:
    Endpoint: https://secure.offline.sarsefiling.co.za:443/ITAMessageBroker/messagebroker/amfsecure
    [object ProfileSyncResponseBean]

    could you please help how to proceed ?


  15. For what its worth, Im running an HP Probook and after struggling for hours to get version 705 to restore from a backup, (clean install on a new windows installation) I uninstalled all the HP additional software and this worked, I suspect it was the HP client security software causing database access… (just my 2c)

  16. I have submitted easyfile and generated irp5’s. Only 1 irp5 is showing in the directory. What can be the problem. If I look at my payroll software printouts, all the irp5’s were generated on there.

  17. Hi Grant
    Thank you for this wonderful page!!!

    I however do not see my problem listed here. It seems similar to what Adrian was struggling with though. When you open an IRP5 generated from easyfile it tells you: “could not open because it is either not a supported file type or because the file has been damaged”. I’ve also noticed that I am unable to view any IRP5’s generated, EMP501, or even SARS notices?

  18. Hi Grant
    I am having the same problem as Karyn, not being able to generate an IRP5 certificate generated from Easyfile. Same error message.
    Thank you.

  19. I also have an issue with PDF’s from Easyfile, saying the same thing not supported file type yet it definitely is a PDF.

  20. HI , I fixed the of issue as above . i backed up easyfile , deleted the whole thing , reisntalled the whole thing , and everything is fine , khalid

  21. I am trying to fill voluntary over deduction tax on a manual tax certificate on easy file employer . i cannot seem to create the certificate.
    i have been creating these certificates for the past 8 years. Please can someone help me.

  22. Hi, I am unable to save EMP501 and IRP5’s on Disk for submission from Eayfile. I can’t login on efilling and I’ve been advised by SARS complain Department to submit using the disk. I am able to select the file but “Save to Disk” button is grey.

  23. Hi, I have submitted the 2020/02 period and still no certificates have been received by Sars. apparently there are liability on paye errors and more. they say I can go on Easyfile to see all the errors, where can I see this list of certificate errors?

  24. I have submitted 202002 EMP501 on Easyfile I am unable to generate IRP5s from Easyfile. Is this because of the discontinuation of Adobe Flash Player. How do I export IRP5?

  25. When I try to open an interim submission EMP501 generated from easyfile it tells you: “could not open because it is either not a supported file type or because the file has been damaged”. Please help as I can’t see how I can even go back onto Easyfile to reproduce this 501.

  26. I’m trying to open Emp501 202008 declaration but not showing on drop list menu under declaration

  27. Hi, I’m trying to submit 202102 I’m receiving correspondence on ETV with all list of employees not assessed duplicate, I tried to resubmit but still getting same massage, how to I fix this on Easyfile.

  28. Please uninstall your easyfile, java and adobe and then reinstall, with the easyfile it will ask you if you want to instal Zulu something, say yes and hey presto the EMP501 is printable!!!! Thanks for the advice

  29. Christin Sebastin

    Hi, Please can you assist me.

    1. How do I view previous EMP501’s submitted.

    2. How to I remove EMP501’s that were requested in error.

    Your assistance will be highly appreciated.

    Thank you

  30. As per Anne: uninstall easyfile, java and adobe and then reinstall, with the easyfile it will ask you if you want to instal Zulu something, say yes and hey presto the EMP501 is printable!!!! Thanks for the advice.

  31. I am having the same issues as Serena and Lee-Anne…only 1 IRP5 printing and I cannot even open it.

  32. Hi Grant. Thank you for your website. It has definitely helped me this year. I have an issue which I cant seem to find an answer to. After submitting the EMP501 and generating the IRP5’s I received a letter from SARS saying there was a PAYE VALIDATION OUTCOME error on 1 employee. The only reason I can think of is that this employee hasn’t been getting a salary since Nov 2020 due to no income in the company but he hasn’t been terminated because as soon as the company starts making money again he will take a salary. Can you please shed some light? Have you come across this error and how did you fix it? It would be greatly appreciated. Thank you.

  33. Hello,

    I have a problem logging into [email protected] it accept my User Name and Password but after a while it return to the logon pad without entering into the application.



  34. Good evening, I am having the exact same issue as Serena and Lee-Ann. I cannot open the emp501 and it only gives me a link to one employee’s irp5 and still it won’t open. Thanks, Lizette

  35. Hi I’m having trouble printing the IRP 5 Certificates I click on view but nothing is happening thnx Sonja

  36. Hi there, I cannot generate the IRP5’s on the system utilities. It does everything that it looks like it should be doing, but when I access the file that has been saved, I cannot open any of the IRP5’s (actually there is only one IRP5 listed?) and the system says Adobe could not open because it is either not a supported file type or because the file has been damaged. Please help!

  37. The ETI value claimed pull through on the IMP501 recon, but does not pull through to the last page of the recon. It shows we short paid with the ETI value. What did we do wrong?

  38. Hi, I have submitted the 2020/02 period and still no certificates have been received by Sars. apparently there are liability on paye errors and more. they say I can go on Easyfile to see all the errors, where can I see this list of certificate errors?

  39. SARS has recently merged my 3 e-filing profiles into one . When going into Easyfile do do the EMP501 etc it says that my password is incorrect when trying to submit the declaration. To me it seems that easyfile is not talking to e-filing. Any suggestions?

  40. i cannot find a place of how to submit. have been doing it for years – now suddenly i cannot submit. file uploaded no errors, EMP501 captured, and reconciled. but i cannot find how to submit

  41. Morning. I am receiving reminders from SARS for the EMP501’s but the problem is, I already submitted some of these recons via Easyfiile. After investigating, some of the recons are not showing on the SARS SOA…It seems the recons from 06/05/2021 up to date are the problem. Any ideas? Thank you

  42. Hi there, I cannot generate the IRP5’s on the system utilities. It does everything that it looks like it should be doing, but when I access the file that has been saved, I cannot open any of the IRP5’s (actually there is only one IRP5 listed?) and the system says Adobe could not open because it is either not a supported file type or because the file has been damaged. Please help!

  43. Hi, I have exact same issue as Frans. ETI utilised is not populating/ pulling through at bottom of EMP501

  44. Morning. After EMP501 update this morning I am unable to open the EMP501 pre-pop declaration. All it says is “[email protected] cannot obtain your EMP501 Declaration information online
    SARS might have financial values for the EMP501. Note that the data at SARS may be different and may lead to the EMP501 form not being accepted by SARS. We strongly suggest you retry the request later in order to pre-populate the EMP501”.

    Please advise what I can do to fix this.

  45. Elaine Lamprecht

    Good morning, I received letters from Sars regarding Validation – SARS identified discrepancies in one or more certificates. A file containing the problematic certificates has been sent to the channel from which it was sumbitted.
    I used [email protected]
    On [email protected] there is nothing
    Can you anyone help with this please?

  46. Hi Grant, when submitting I get a message : Validation Failed Reference Number does not exist or User does not have rights to taxpayer. Can you please help?

  47. Log into efiling, click on view portfolio and see the easyfile login name… sometimes it has a _2 after it and use that in easyfile with your current efiling password

  48. Someone at SARS advised to fill in the ETI utilized with no cents, eg if your ETI utilized is 10.50, only put in 10, the balance will then carry forward. If the amouts were omitted say for Oct and not carried forward to Nov, remove the cents with Sept ETI utilize and the balance will be carried forward.

  49. ETI Problem - Charles

    Hello Grant – Charles here. I am Having issues with ETI submissions all 3 of them. After populating the declaration and its now time to submit You first get an error message that says Certificates imported do not tie up etc – In response i took out the Cents 0.92 difference but in doing so when i get past this stage – i try to submit again then The Period within which i would have made the Change will come with another error message -THE RFC FOR THIS PERIOD CANNOT BE PROCESSED. – [Be it 202003, 202008,202010,202101 – Every time it will complain about the period i would have chosen to make this adjustment—ITS a Total Predicament] – Please assist.

  50. Hi Charles. Your import file with ETI has a monthly ETI total (7004) and a grand total (4118). You need to add up the monthly ETI and make sure it agrees with the grand total. You can’t drop cents as your value you claimed will be more than the value per IRP5.

    If your ETI utalised does not pull through to the last page on your IMP501, you drop the cents on the IMP501per month ETI utalised.

  51. Hi I seem to be having a backup issue. When i back up it doesnt zip the file. Is there a way to fix this?

  52. I have the same problem as Debbie Naidoo. “Hi there, I cannot generate the IRP5’s on the system utilities. It does everything that it looks like it should be doing, but when I access the file that has been saved, I cannot open any of the IRP5’s (actually there is only one IRP5 listed?) and the system says Adobe could not open because it is either not a supported file type or because the file has been damaged” Please help!

  53. Good Day, I am struggling with my submission. On the 3rd screen (Financial Particulars) on the bottom my Annual ETI Utilised is blank, however on the 2nd screen (ETI Details) it pulls through the amounts and reflects what we utilized. Please could you advise on how to fix it? If we submit based on what is currently pulling through then it’s not taking the ETI into account.

  54. Morning, I am receiving “Payroll Taxes Validation Error” Correspondance from SARS on only 2 of the 3 companies I submitted. On the Validation report from Easyfile, on some of the employees it states “Duplicate”. What does that mean? SARS website recommended a Re-Submission, which I did. Gone around in circles for 2 weeks, can’t seem to correct it?

  55. The easyfile login name is correct. I am able to syncronise under utilities using the login name and password, but I cannot pull my EMP201 data using the same login details- why would this be- do you think I should uninstall and reinstall?

  56. I have the same problem as Kimche Nel – Declaration on easyfile will not prepopulate from efiling and it suggest I try later… Is the problem with SARS?

  57. Tharina Vermeulen

    Good day, how do I export or download the taxes validation file to Excell? It opens in Notepad and I cannot see what the faults are. I use Firefox as browser, the file does not download or give an option to download, only “save”.

  58. Hi, I have imported my Payroll file into Easyfile. I see all the created certificates. When I go to the Declaration, the total amount calculated on the ETI on code 4118 differs from the submitted amount (it’s less than what we have claimed from SARS). In addition to this, it also pulls the incorrect PAYE liability amount through to the 3rd page. It uses the PAYE liabilty before ETI utilised amount. I have called SARS and they advised me to capture the certificates manually – it is almost 300 certificates. I have tried to drop the cents as advised previously but still not making any difference.

  59. Christelle Maritz

    Hi. I’m also still struggling with “The ETI value claimed pull through on the EMP501 recon, but does not pull through to the last page of the recon. It shows we short paid with the ETI value.” I’ve tried everything as suggested. I’ve even started with a blank easyfile and putting in my own values that are rounded and test with changing the IRP5s to only show rounded amounts. But even now the ETI utilised doesn’t pull through to the last page and it looks like tax is owed. Any suggestions? Really worried now about the submission.

  60. Hi
    Any suggestions on how to resolve the issue of not generating the IRP5’s? When I go into the folder where I have saved it to, it only shows one IRP5.

  61. Hi. Please could you assist. I’m trying to open EMP501 202008 declaration but not showing on drop list menu under declaration. Any idea what the problem could be? Thank you.

  62. Hi, I had to submit EMP501 manually. For medical tax credits I used 4474, 4005 & 4116 – it still didn’t pull through to the declaration though. In the reason field I explained that the medical tax credits didn’t pull through. It still came through as outstanding and due on the statement of account. Is there another code that I should have used?

  63. Hi
    After submitting an EMP501, I received correspondence from SARS that there are outstanding info on Easyfile. Seems the 202008 declaration was never submitted. I tried requesting the declaration after importing the payroll file, but it doesn’t show on the dropdown list. How can I fix this?
    Thank you

  64. Hi there. I’m looking for a solution on a message received ‘Recon failed Compliance’ after submitting my EMP501. Please advise on where to look for the problem.

  65. Hi there, I submitted the EMP501 recon two weeks before the due date. It shows on e-filing as filed. I was able to download and print the IRP5 certificates but now SARS is saying the same recon 2021/02 is outstanding. How is that possible as it shows filed on e-filing. Do I need to request a correction and resubmit or???

  66. Hi there, Im looking for help…when I want to open the EMP501 declaration it gives me an error Unable to locate [email protected] Forms Viewer, Please make sure [email protected] Forms Viewer has been installed before attempting this operation again. What does this mean and how can I fix it please.

  67. Philip Janse van Rensburg

    Hi Grant, I have filed the EMP501 via easyfile, generated the certificate, etc with no problem. It is however no pulling through to efiling as if it was not filed? Is there a waiting period and I should just he patient? Or is something wrong with the sync between easyfile and efiling? Thanks

  68. Hi Grant my easyfile (I have updated to 7.1.4.) keeps telling me that I do not have easyfile forms viewer ?

  69. Open easyfile and go to “Utilities” and click “System Configuration”, at the bottom next to Path click “Install” next to [email protected] Forms Viewer Application. If it won’t install here, you will need to try reinstalling easyfile.

  70. Brilliant resolution. Not even SARS themselves could help me. Thank you so much – it worked 100%. It is just beyond me that SARS cannot put something on how to do it on their website. Cannot thank you enough.

  71. Hi, I received an email from SARS stating a technical issue with the Full re-submission function on [email protected] Not all of our IRP5 certificates were received by SARS and we need to submit again. Anyone else with the same issue?

  72. #1009: This is usually due to missing info or an incorrect character in a field. Essentially easyFile is expecting something & getting an unexpected result & throws an error. [If you are having the issue under Employees, make sure you have the country under the employee’s address details and then generate the certificate again.]

  73. good day,

    Error message : ‘reference number does not exist or user does not have the rights to taxpayer” – when i try to request an EMP501 declaration.
    Reference number is correct . We have checked all user rights settings -seems correct.
    Any other suggestions please?
    thank you

  74. Hi Everyone,

    So currently trying to open an EMP501 file with the status “Saved” instead of the “Submitted” status.

    It will not open if the status is “Saved” but if submitted it will open without problems.

    Anyone care to explain why this is the case please.

  75. Hi Grant,

    I’m getting the following error when I try to click on “File and Close”

    “Save function has failed. Mandatory information not found in XML for EMP501. Please close [email protected] Forms Viewer and request a new EMP501 form form SARS with [email protected] Employer application. If this problem persists, Please contact the Call Centre on 0860 12 12 19”

    Nothing is showing in the EasyFile Forms Viewer. I can only see 3 dots moving

    Do you perhaps know what could be causing this issue?

    Thank you

  76. This is an issue I do not have a solution for as yet. My testing lead me to believe it is an issue on SARS side. It only happens on some companies. I have a client with 20 companies and only 1 has this issue.

  77. Hi Grant,
    I am trying to download an EMP501 for 202002. I am unable to view any of the EMP501 submissions in Utilities/Generate IRP5s. When I click ‘View’. I get the little clock and then it disappears and nothing is opened for viewing. When I Export, the file downloads but I get an error opening it. “Adobe Acrobat Reader could not open -file name- because it is either not a supported file type or it has been damaged (for example it was sent as an email attachment and was not correctly decoded).
    If I go to ‘Declarations’ and select the select the submission, it logs onto efiling and then when I want to print the file it goes to [email protected] forms viewer and I get the message ‘Please remember to save before printing and check [email protected] Employer/DividendTax. [email protected] Employer/DividendTax will render a printable .PDF’.
    Where do I find [email protected] Employer/DividendTax?
    Any assistance will be appreciated.

  78. Hi Grant,
    I tried the tweaked installation process for version 7.1.5 and I still get the Application Install error message: ” Sorry, an error has occurred. The application cannot be installed due to a certificate problem. The certificate does not match the installed application certificate, does not support application upgrades, or is invalid. Please contact the application author.”
    I’d appreciate your help

  79. Hi Grant,

    i am trying to do the SARS recon (EASYFILE) for 1 MARCH 2021 TO 31 AUGUST 21, but must download the version 715. When doing this I get a message saying the the certificates ar invalid and do not match. it also says I have update JAVA but still the same message. what am I to do? thanks

  80. Hi Grant,
    I have upload easyfile on my computer, all went well. Typed in company details and the manual staff irp5. saved work, logged out and want to carry on the next day. Login and an error code ” easyfile company select…easyfile could not change to the selected employer. Error #1009
    What to do now.?

  81. Good day Grant

    I have just submitted a nil declaration and when I check if all is ok under EMP501 Status Dashboard and then Update it gives me the following:

    “EMP501 10018 n/a invalidated with error code 10018.”

    What does this mean, please?

  82. Hi Grant, I have just updated from 7.1.5 to 7.1.6 and both versions are telling me that I need [email protected] Forms Viewer to view my EMP 501 from the Declaration page. When you Google it, it takes you to some dodgy sites, so very hesitant. Do you have a solution?

  83. Hi Grant
    I have the same problem with the update. I press update on EASYFILE runs to 100% and then message pop up ‘ ” Sorry, an error has occurred. The application cannot be installed due to a certificate problem. The certificate does not match the installed application certificate, does not support application upgrades, or is invalid. Please contact the application author.”
    Please could you assist me

  84. I successfully updated to the new version. Completed my EMP 501 (not a nil declaration), but got the same error as Charmaine when I checked for updates “EMP501 10018 n/a invalidated with error code 10018.”

    Is there a way to correct this error?

  85. Hi Grant

    I have a problem on easyfile Log in , I put in my user name and password then it acts as if it about to open before freezing .I have tried unsuccessfully to uninstall and reinstall results are still the same .

    Please help

  86. The simplest solution is to restore a backup. If you don’t have a current backup then I can take a look to see if I can resolve the issue via AnyDesk.
    If the restore fails then there might be an issue with how your easyfile is installed. Remember to backup and to multiple locations.

  87. The error “10018 n/a invalidated with error code 10018” is because I submitted too early – even though SARS website said submissions were open. The next question is, how do I resubmit – technically SARS haven’t received this submission.

  88. Hi I am struggling to download the new easyfile form viewer 1.3.1. The error state the following dpath is not define? Can someone please assist

  89. Hi Grant, after I have downloaded the easyfileFW from your link, I just get a blank screen. should I perhaps wait longer. when I try to view my saved declaration it gives me a message that a new version of the form is available. SARS HTML EMP501 version 2021.00.18. When I click on Download Now. It gives me an error that the download failed

  90. Yes I have uninstalled easyfile and reinstall it. I’ve noticed from previous questions that I should go utilities and install the FW from there and it still did not word. Then I uninstalled again easyfile and easyfileFW, installed your version form onedrive and installed again easyfile. Still no luck

  91. If you install easyfile after installing FW 1.3.1 it will overwrite it with 1.3.0 from the easyfile installer. Just download and install FW 1.3.1 and you should be done.

  92. I have installed FW 1.3.1 and after the message ‘Installation Completed. Please click OK to continue.’ I get a blank screen which I exit. Then login to Easyfile and when I click on view on my submission I get the following message: ‘Form Update Required. In order to continue operations you need to download the new version of the form. SARS HTML EMP501 form version 2021.00.18 is now available.’ When I click on Download Now I get the following message: ‘Download of EMP501 2021.00.18 failed.’ What do you suggest I do?

  93. Good day Grant, I am still not able to view my declaration. After I installed Easyfile Employer, I installed the EasyfileFW file. When I click on view on declaration I get a message to install
    SARS HTML EMP501 version 2021.00.18. When I click on Download Now. It gives me an error that the download failed. How do I get passed this problem.

  94. Hi My EasyFile is on the new update – 7.1.6, but I cant view my EMP501 on the declaration tab, FileViewer did install and the path is located under the system configuration. The link on my desktop opens a blank screen. We did uninstall Easyfile and Fileviewer, but still cant view the declarations. Any sugestions?

  95. Hi Grant, trust you are well. Reading through the last comments it looks like we are all having the same issue. I’m on the latest build of Easyfile 7.1.6 with FW1.3.1 installed. Everything works fine the system is stable, I can view, import, edit and capture certificates but once I navigate to the declaration tab to view the EMP501 it opens FW, 3 blue dots appears(white background) and it just loops. Funny, if I press print in FW it actually opens the 501 but the input fields are locked as I still need to complete them. System specs, Win10, AVG and Express VPN(both turned off) no other JAVA versions installed on the system except for the one bundled with Easyfile. This is the first time I cannot get it to work since we started using Easyfile in 2013. I’ve uninstalled and installed the software numerous times over the last two day with no results – honestly think its a software issue…. Please share your thoughts.

  96. Hi Sieg
    Firstly, thanks for your comprehensive message it makes for less guesswork on my part.
    Does or did the company you are working on have any special characters in its name or other company data? That includes ‘”/?><#*&^@! etc

  97. Hi Grant

    Also still getting the same issue with the 3 dots but nothing displaying

    It seems they removed it now but before I could go into a “Developers Tools” tab and I got a xml.import error

    I think it could be because at the end of the line it has the word ,false ) and I think it needs a apostrophe( ‘ ) next to the false

    Could it be from SARS’s side?

    Thank you

  98. Morning Grant,
    Thanks for your time and feedback. Actually the company did have special characters(@ and /) not in the name itself but under the “business address” which I removed but still getting the same results. After removing the characters I saved, logged off, rebooted machine, disabled VPN and all the firewalls logged in again same problem. As mentioned earlier I can view the 501 under Utilities “Generate IRP5’s/IT3’s” as its saved. I also disconnected from my LAN so I can work in “offline mode” same problem – this is really baffling with a hint of annoyance. Hopefully there is an update coming soon to iron this out? 🙂

  99. Hi Grant,

    I have the exact same problem as Sieg. Two of our companies that can’t open the declaration have an apostrophe in the company name, other companies work fine. I have removed the apostrophe from the name in “Edit Employer” tab to see if the declaration opens. However, it is still stuck at the loading screen, and I have refreshed the declaration before opening. I have checked that address’s etc. don’t have any special characters either.

    Is there anything else I need to do?

    Any suggestions would be much appreciated.

  100. Hi Sieg
    I have a potential fix for this but I’ve only tested it on a single company so far.
    I’ve got another two clients at the moment to test on so I’ll see how effective it is over the next day or two and then I’ll probably do a write up about it over the weekend.

  101. Hi, How do i get pass this issue? “SARS HTML EMP501 version 2021.00.18. When I click on Download Now. It gives me an error that the download failed.”

  102. Good day Grant

    I uninstalled Adobe Air, Java and Easyfile, reinstalled, imported my backup and import the payroll file, when going to Reconciliations Declaration, it says to install Forms version 1.3.1 downloaded your above link installed and then given: Error writing to file: Verify that you have access to that directory

    September 23, 2021 at 11:12 am
    Hi, How do i get pass this issue? “SARS HTML EMP501 version 2021.00.18. When I click on Download Now. It gives me an error that the download failed.”

    I get the same error, might it be that we are behind a proxy server(No I cannot disable the proxy server but when I connect directly to the internet via Wi-Fi I can download the EMP501 file, problem is not al computers can connect directly to the internet and neither does our director want us to do this.)

  104. “Hi Sieg
    I have a potential fix for this but I’ve only tested it on a single company so far.
    I’ve got another two clients at the moment to test on so I’ll see how effective it is over the next day or two and then I’ll probably do a write up about it over the weekend.”

    Hi Grant,

    Any update on the above on how to fix it?

    Thank you

  105. Hi! Grant – Trust you are doing well. I hope you will be able to assist me. Noticed that other users experienced the same problem but I could not find a solution on the replies. I have downloaded several times the new [email protected] version upgrade 7.1.6 by uninstalling [email protected] and re-install. I have successfully installed FW 1.3.1 from the Utilities menu – System config per your guidance from your webpage. When I want to view a saved EMP501 declaration I’m still getting ‘Form Update Required with message “In order to continue operations you need to download the new version of the form i.e. SARS HTML EMP501 form version 2021.00.18 is now available”. When clicking on Download the form version 2021.00.18 I get the following message: ‘Download of EMP501 2021.00.18 failed.’ Your further guidance will be appreciated.


    Jeepers you are amazing!

    Easyfile is NOT freaking Easyfile and twice a year I scream out loud for a few weeks how much I hate IRP5’s. From SARS to employees they all go out of their way to make things difficult. I think I have resolved most of my problems from your notes and hints a few years in a row now. I really appreciate you the sharing the information, fixes and hints.


  107. H Grant,

    I hope you are well.

    Is there perhaps any update on how to fix the problem above:
    “SARS HTML EMP501 version 2021.00.18. When I click on Download Now. It gives me an error that the download failed”

    Kind regards

  108. Hi Bridget
    You are now the 2nd person to have this issue today. I’m guessing SARS are having server issues and so the download is not working at the moment.

  109. Hi there

    When I try to view a past EMP501 submission on my newly updated easyfile, I get the following error message:

    “Note: in order to continue operations you need to download the new version of the form. SARS HTML EMP501 form version 2021.00.22 is now available” There is a download buttoon but when I press it i get an immediate error message reading: “Download of EMP501 2020.00.22 failed.”

    I have tried to see whether I can download a newer version of form viewer but can’t find any. As I said, I updated to the easyfile that was released today.

  110. Good day

    I am trying to run the update but it’s giving me an error -saying there is a certificate problem. How do I fix this? I have tried eveything above.

  111. Hi Grant, for some reason I am unable to install adobe acrobat reader and am using an alternative – however it does not save my EMP501 or IRP5 giving the error – ‘PDF cannot be displayed: error code: Adobe Reader not detected.

  112. Hi Grant, could you please advise why we cannot see any log information on version Easyfile 7.1.7. No new or historical logs are showing for Import Payroll File, Delete Payroll File, Pre-Submission validation Report. Thank you!

  113. Hi Grant, thank you very much! Your tweaked installation process helped me to successfully install Easyfile, I refer to your website every six months and it has helped me every time!

  114. Hi Grant. I have successfully updated and downloaded all the new versions. When I go to declaration, and click on view, a new window pops up, I then make the necessary changes etc, however there is nowhere an option to save or proceed, I can only close the window and then none of the changes are made. Please help.

  115. Hi Grant,

    im getting the the following error

    “Note: in order to continue operations you need to download the new version of the form. SARS HTML EMP501 form version 2021.00.22 is now available” There is a download button but when I press it i get an immediate error message reading: “Download of EMP501 2020.00.22 failed.”

    do you perhaps have the install file for the new version? if not how do i move past this error?

  116. Hi Grant, i can view historical EMP501 declaration (i.e 202102) but cannot view the the current one (202108). easyfile v7.1.7, forms v1.3.1

  117. More than likely your AV or Firewall blocking the download. I do have it available but I have not documented how to replace it as yet.
    Try disable your AV and firewall and then download.

  118. Hi – I am having a problem printing the Declaration to save it so my manager can review it. I can save it, then when i print the screen opens up but is totally black. It has the close button at the top. I have uninstalled and reinstalled Adobe, and Easyfile more than once. Please i would really appreciate it if you could help me. Many thanks, Liesel

  119. There are multiple possible reasons for this. It is frustratingly difficult for me and I’m sure for you to find the resolutions as often I have so little info to go on. I know nothing about your setup other than you are having a rather broad issue. Have you tried a tweaked install?

  120. Hi Grant, we uninstalled every version of Java and followed the “Tweaked Install” to the letter. Downloaded a fresh version of 7.1.7 , let it install java, air, and forms on its own. The problem persists as below on any company on the 202108 data. We even disabled the firewall and antivirus. Are there any other suggestions? Regards Petro

  121. Path for easyfile Forms Viewer Application: should be

    Replace “user” with whoever is the user on the PC

  122. I need to resubmit my 2016 EMP501 via Easyfile. So firstly I corrected the incorrect ETI amount on one of the employees’ certificates by clicking on “Add ETI”. Then I corrected the 4118 source code so that this amount agrees with the total amount as at “Add ETI”.

    When I click on “Save certificate”, it gives me the following error message: Source code (7007) not valid for Tax Year 2016. I searched what source code 7007 is for and found that it is “ETI hours”. The 2016 EMP501 has no place where the ETI hours could have been entered, so I have no idea how this error happens.

    Could you possibly help me?

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.