This guide will discuss some common IRD lodgement errors, what causes them, how to provide the information for support to investigate them and where we can will will provide a solution.
Error - Undefined: undefined error
The below error is returned when lodging via Web Return lodgements and gateway services.
Error with Lodgement
IR return for (Client Name) period ending xxxx-xx-xx failed lodgement.
Reason: undefined: undefined -
- This could be due to the IRD Gateway Services being down or unavailable. Please try submitting the return again at a another time.
- There may be 'special characters' within the return narration fields that are causing the problem. Look for and remove any single quotes (') and ampersand (&) characters from the return. Try submitting the return again
Error - Invalid filing period
The below error is returned when filing any tax type (not just an IR3).
Error with Lodgement
IR3 return for period ending xxxx-xx-xx failed lodgement.
This error is returned by IRD when information doesn’t match correctly. This could be
- A change of balance date.
- The correct tax type has not been specified in Client IRD Links page.
- The IRD are not expecting a return for the year/period.
- The IRD message is not correct (known IRD issue)
1. Check with IRD that they have the correct information for your client
2. Check the correct tax types are selected in the Client IRD Links page.
3. Check MyIR and ensure the IRD are expecting a return for the year/period. Check for Start and cease dates for the entity in that period.
4. Contact APS Support if you have check the first two options and think this may be an incorrect msg sent by the IRD.
Error - Unauthorised Delegation
This is a general message which could have a variety of causes. Some common solutions to this issue are outlined in KA-04567
Error - Unauthorised Vendor
The return is too old to be lodged via Gateway Services. As per IRD, only returns for the current year and four years back can be submitted using Gateway Services. (e.g. if 2021 is the current year, returns back to 2017 year can be lodged).
Error - IR215 - Validation error
Read more about this error and solutions in article - KA-04627
Error - dividendIncome totalRWTCredits cannot be greater than dividendincome totalGrossDividends
Read more about this error and solutions in article - KA-04615
Error - Cannot claim lossesClaimedThisYear when a loss made in this income year where expenses exceeds income in IR6,IR3,IR4 & IR7
Read more about this error in article - KA-04572
Error - IR4 subventionPaymentsToFrom cannot be greater than 0 for profit companies
Read more about this error in article -KA-04599
Error - lossCarriedBackPriorYear must be 0 when there is no LCB indicator on the previous tax period
Read more about this error in article -KA-05057
Error - IR526 'Invalid Filing Period' when trying to lodge
Read more about this error in article - KA-04651
Error - partYearStartDate must be contained within the return period
Read more about this error in article - KA-05069
Error with Lodgement - read ECONNRESET
Read more about this error in article - KA-05068
Error: IRD Response: XML request failed validation - undefined
Read more about this error in article - KA-05112
Bad Gateway means there is invalid data or unexpected data in the information being sent to the web. These errors can be specific and relate to a known bug or they could be more general and relate to data in your database or related to a specific client.
Please log a support case with a screenshot of the error, details of the file and client as well as your log file. You can find your log file using the instructions in KA-04619
Filing obligation not met
The form submitted did not meet the filing obligation for the period, as per the IRD's records. This could happen if there is no primary form submitted or if the incorrect primary form was submitted.
The form you are attempting to send the IRD differs to what they are expecting. For example, you may be trying to lodge an IR7, where the IRD are expecting an IR4 return for that IRD number.
Please check MyIR and compare the expected details with what you are trying to send, in terms of form type and balance date etc.
Check MyIR to see if the return has already been received, or if the IRD has issued an Auto Calc (PTS or auto assessment) for the Tax payer.
If the return has already been lodged via Gateway Services, you will be able to lodge an "Amended Return". Please follow the steps in this article: KA-04703
If the IRD has issued an Auto Calc, then please lodge the IR3 via MyIR. In the future, we will be amending the software to allow you to lodge the IR3 after IRD has issued an Auto Calc.
Please see a work around for this issue in Article: KA-04718
No Filing Obligation Found
A return has been submitted for a client who does not have a filing obligation - they have a "not required" in their return profile.
Solution: Tax Agents should send a secure mail to IR if a different view of this obligation is held.
Unable to Lodge an IR4 without an IR4J attached
For more information on this issue see Knowledge Article: KA-05030
Missing Amendment Details
In this situation the return may have accidentally been submitted to IRD twice.
The initial return is successfully received by the IRD. The second time the return is submitted, it has correctly failed with the message about Missing Amendment Details
To get the "Lodgement-Failed" return back in sync with the IRD follow these steps:
- Click on "View Return Details".
- From the "IRD Actions" menu do a "Retrieve" and then a "Status" update.
This will gather data from IRD and update the APS status to the appropriate current return status.