» Home » opinion » SARS easyFile Employer Problems – Troubleshooting

SARS easyFile Employer Problems – Troubleshooting

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.0

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, 7.1.0 will not run with the latest Java
  • Download 7.1.0 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.0: via DropboxGoogle Drive or SARS Direct Link – [15.12.2020]
  • 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_710_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.

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.

What is the latest version of easyFile

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.0 which is Zulu JRE (8u252) or

What versions of Adobe Reader and Air

I’ve tested up to

  • Adobe Air download here
  • Adobe Reader DC 21.001.20150, download here or here – make sure to deselect the Optional offers
  • Java Zulu JRE version, will not run with the latest

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.

https://www.sars.gov.za/ClientSegments/Businesses/My-Bus-and-Tax/Pages/[email protected]

44 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

Leave a Reply

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