Payday Filing - Unauthorised Delegation

A common error we see with IRD payday filing is where PayHero accounts are connected to the wrong myIR accounts, or to an account that doesn't have access to do payday filing. When you authorise with myIR, PayHero is not told what myIR login was used, and cannot tell if there is a problem until we come to file a pay. An 'Unauthorised Delegation' error returned from the IRD when we file the pay is saying that the myIR account doesn't have permission to do the filing.

When IRD return this error to us, we'll notify you of the issue on your dashboard:

You'll need to follow the troubleshooting steps below to resolve the issue, then resend the pays to IRD under the Tax section of PayHero, as shown at the bottom of our article on Payday Filing.

There are a few things that can cause the Unauthorised Delegation error:

New Companies

If you're a new company, ensure that you are registered as an employer with the IRD.

Filing Permissions

You need to ensure you have the correct permissions for payday filing. This can sometimes become an issue if you have had a change of staff, and the myIR access for the employee who initially connected PayHero to IRD has been removed because they are no longer employed.

If your myIR login does not have the 'owner' role then you will need to get the owner to grant you new access. This article explains how to go about this. Alternatively, use the myIR login with the owner role when you connect PayHero to IRD.

If you're a tax agent, ensure that the myIR user you are using has filing access for the company.

Connected to a Different myIR Account

Another common way this occurs is if your PayHero account is connected to a myIR account for a different person or company. This can often occur if you're automatically logged in by IRD to the latest myIR account you used. You may have been logged into your personal myIR account or a myIR account for another company. Then when you do the authorisation step in PayHero, instead of going to the login page for IRD, you're automatically logged in to the previous company and so the link is going to the wrong place.

To correct you should go to Manage > Integrations and Disconnect from payday filing, then authorise again. If you're still automatically logged in (so aren't prompted for a myIR username and password) then you should open a new window, go directly to myIR on the IRD website, then explicitly log out. Now repeat the authorisation from PayHero, and this time you'll have to log in to myIR.