Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
HTML Wrap
classsection group
div
classinternalnote

Do not delete this page - MYOB Practice navigates to it from within the product.

This page links from the validation error banner in NZ tax returns.

HTML
<span data-swiftype-index="true">
HTML Wrap
classcol span_3_of_5

New Zealand only

This page shows you how to fix errors and warnings you may see when preparing, validating or filing a tax return.

UI Text Box
typewarning

Make sure you validate your return before you file it and after you've fixed any errors.

1. Find out what's wrong

The validation and rejection errors are displayed on top of your tax return. To see more details of the errors, click Show all and click the expand arrow () next to the error.

You can also click the error message, and when possible, it'll take you to the field where the error has happened.

If you've got a rejected return, make sure you select Send for rework before fixing it.

2. Fix the error

Click below to see common errors and how to solve them.

UI Expand
titleCommon errors with solutions
UI Text Box
typetip

To quickly find an error on this page, use your browser's search tool (Ctrl+F) and type the error code or message.

UI Text Box
typeinfo

Can't see your error here? Let us know the error code in the feedback option at the bottom of this help page.

it's a transfer, make sure all fields for a transfer are completed. The IRD number field can't be blank.
  • If no transfer is required, remove the transfer or section causing issues. If you can't see the transfer or section causing issues:
  • Click Add another section or Add another transferand leave it blank.Remove (Image Removed) the section/transfer causing the issue.

    Error code

    Error message

    Reason for error

    Solution

    4

    You aren’t permitted to access this

    You don't have the correct authorisation to file the return.

    Check the following: 

    21 

    XML failed. The return can’t be filed due to an error in the return.

    Transfer section is missing information or details aren't entered correctly.

    • If the transfer is required, check that all fields are completed.
    • If no transfer is required, add a new transfer and remove the one causing issuesremove (Image Added) the transfer. If you can't see the refund section:
      1. Add a temporary large tax credit amount to create a refund scenario to reveal the refund section.
      2. Click Add another transfer and leave it blank.
      3. Remove () the transfer causing the issueany transfers that you don't need.
      4. Delete the temporary tax credit.
    Beneficiary, settlor, shareholder, partner or partner owner is missing information, or details aren't entered correctly.
    • If the section is required, check that all required fields are completed.
    • If no beneficiary, shareholder or partner is required, remove the section that's causing issues. If there's only one section or it looks like there's no data in the section:
      1. Click Add another section and leave it blank.
      2. Remove (Image Removed) the first section.
    • a section isn't required, remove (Image Added) it. You can't file a return with a section that has no data or incomplete data.

    The entered IRD number isn't valid, or the IRD number hasn't been entered for a transfer, beneficiary, settlor, shareholder or partner.

    • If you know the IRD number, make sure it is valid. An IRD number must be 9 digits. If the IRD number is only 8 digits, add a leading zero (0). Remove any spaces, hyphens or other characters.
    • If you don't know the IRD number and the IRD number is for:
      • a shareholder or partner, or
      • a beneficiary in a return before 2022
      You can enter nine zeros, or copy and paste the following: 000000000

    For beneficiaries (from 2022 onwards), settlors and transfers, you must have a valid IRD number and can't use nine zeroes (000000000).

    IR10 has a negative Other Expenses.

    Make sure IR10 Total expenses has been added and Other Expenses is a positive amount.
    IR526 is blank. An IR526 can't be filed if there are no donations.
    • If your client didn't make any donations for the year, don't file the return.
    • If your client made donations, enter the donations before filing the return.
    IR215 is blank. An IR215 doesn't need to be filed if there is no additional income or adjustments to be declared. Learn more about adjusting income for Working for families and student loans.
    • If there is no additional income or adjustments to report, delete the IR215.
    • If there is additional income or adjustments, complete the relevant fields in the IR215.

    IR7 only

    If there are many partners with very small percentages being allocated, the tax credits may be negative for a partner. This usually affects the first partner.

    Adjust the tax credits so no partner's credits are negative.

    104

    Invalid filing period 

    This can happen if you're trying to file a return for a period that isn't open in myIR. It can happen for any return type, but typically occurs for an IR6 or IR526. 

    Check if myIR shows the period that the return is being filed.

    If myIR doesn't show the period, send IR a secure mail to request that the period be generated. After IR has done this, file the return again. 

    105No filing obligations foundIR has set the income tax return to 'not required to file'.

    If you believe a return should be filed, contact IR to ask them why they have set the status to 'not required'.

    107A return for this period already exists

    The tax return can't be sent through MYOB Practice Tax as it has already been filed with IR through an alternative method, including IR's automatically issued income tax assessments.

    If the return needs to be amended, you need to file the amendment in myIR.

    135 

    IRD number failed IR's validation check - it must be valid, 9 digits, and have no other characters

    The IRD number entered isn't valid. This could be for a transfer, beneficiary, shareholder or partner.

     

    • If it's a transfer, beneficiary, shareholder or partner, check that all fields that require an IRD number have a valid IRD number. IRD numbers can't have hyphens. Enter a leading zero if the IRD number is only 8 digits.
    • If you don't know the IRD number and the IRD number is for a beneficiary (for 2020 and 2021), shareholder or partner, enter nine zeros, or copy and paste the following: 000000000
      The nine zeros can be used in multiple fields.
    • If
    • a section isn't required, remove (Image Added) it. You can't file a return with a section that has no data or incomplete data.

     

    141

    Invalid attachment type

    This can happen when you're trying to file an IR4J for a company that's part of a group. The group's representative needs to file the imputation return for the group. An IR4J doesn't need to be filed by imputation group members.

    Delete the IR4J then file the IR4 return again. If you believe an IR4J is required, contact IR.

    The company is listed as non-active.
    142

    Filing obligation hasn't been met

     

    This occurs when the return type isn't the return type IR expects.

    For example, IR expects an IR4 and you’re attempting to send an IR7.

    In myIR, check the return type that IR would expect:
    • If myIR has the incorrect information, send a secure mail on myIR requesting that the issue be corrected.
    • If myIR has the correct information, you'll need to update MYOB Practice Tax. You will need to delete the return, update the client's compliance settings and then add the correct return type.
    156Transfer amount must be greater than 0

    The credit transfer amount must be a positive number. You can't file a return if any transfers have a blank amount or 0.00 amount.

    • If the transfer is required, check that each transfer has all fields correctly entered.
    • If no transfer is required, remove the one causing issuesremove (Image Added) the transfer. If you can't see the refund section, add a new blank transfer and then remove the one causing issues:
      1. Add a temporary large tax credit amount to create a refund scenario to reveal the refund section.
      2. Click Add another transfer and leave it blank.
      3. Remove () the transfer causing the issueany transfers that you don't need.
      4. Delete the temporary tax credit.
    400Bad requestWe couldn't connect to IR's gateway services.Try filing the return again later.
    2011Portfolio income entity income total tax credits can't be greater than the allowable PIE income total tax credits

    IR3 (2020) only

    The Portfolio incoming entity (PIE) tax credits claimed is greater than allowed.

    Adjust the return's credits and file the return again.

    To calculate how many PIE tax credits your client is eligible to claim, use this formula:

    [(tax on taxable income/taxable income) x PIE income]

    Learn more about handling PIE income in tax returns.

    2012Can't claim both look-through company non-allowable deductions and look-through company prior year non-allowable deductions

    The look-through company non-allowable deductions and look-through company prior year non-allowable deductions fields can't both have non-zero amounts.

    Adjust the amounts so that:

    • only one field has a non-zero amount, or
    • both fields are blank.
    2013Losses claimed this year can't be greater than losses brought forwardThe amount in losses claimed is larger than the amount in losses brought forward.

    Reduce the number of losses claimed so that it's:

    • the same or less than the losses brought forward, and
    • the same or less than the current year's total income before losses.
    2016Customer not entitled for early payment discount eligibilityIR3 and IR3NR only
    IR has determined that the early payment discount doesn't apply to this client. Learn more about the eligibility criteria.
    In the Tax calculation section, change the Entitled to claim an early payment discount option to No.
    2019Part year end date must be contained within the return period

    The end date entered for the part year falls outside the start and end dates of the client's financial period. In a 2022 return:

    • for a March balance month client, the dates will need to be between 01/04/2021 and 31/03/2022.
    • for a non-standard balance date, the date range must relate to the actual financial year not the tax year. e.g. a client with a December balance month must have dates that are between 01/01/2021 and 31/12/2021
    Check the part year end date entered and update to make sure it falls between the clients actual financial year.
    2032Dividend income total imputation credits does not equal sum of income attribution share of imputation credits

    IR7 only

    This error can occur when one or more of the imputation credits fields in the Income/(Loss) attribution section have been edited. As a result, the sum of all the imputation credits allocated to the partners or owners doesn't equal the amount in total dividend imputation credits (in the New Zealand dividends section).

    Adjust the imputation credits allocated to the partners or owners as necessary to make sure the total matches the amount in the New Zealand dividends section.

    Alternatively, click reset () to change the edited amount back to the automatically calculated amount.

    2039The total income attributed must be equal to the total income/(loss) after expenses

    IR7 only

    This error can occur if you've edited any of the income fields in the Income/(Loss) attribution section. As a result of editing the fields, the sum of one or more of the income fields doesn't equal the total of the income field in the corresponding section of the return.

    1. In the return, click Validate.
    2. Review the red error messages to establish which income field(s) in the Income/(Loss) attribution section are over or under allocated when compared to the total of the corresponding income field in the return.
    3. Adjust the allocation to the partners or owners as necessary.
      Or, alternatively, click reset () to change the edited amount back to the automatically calculated amount.
    2050Non-resident withholding tax on total interest can't be 0 when total interest resident withholding tax is not 0

    IR3NR only

    The country of residence selected has more than one NRWT rate for interest. You need to determine the rate that applies.

    In the Interest section of the main form at the field Non-resident withholding tax (NRWT) rate, select the relevant option.
    2051Non-resident withholding tax on total dividends can't be 0 when total dividend credits is not 0

    IR3NR only

    The country of residence selected has more than one NRWT rate for dividends. You need to determine the rate that applies.

    In the Dividends section of the main form at the field Non-resident withholding tax (NRWT) rate, select the relevant option.
    2053Total portfolio income entity tax credits can't be greater than tax on taxable income

    IR3NR only

    The Portfolio investment entity (PIE) tax credits entered is greater than allowed.

    Adjust the return's credits and file the return again.

    To calculate how many PIE tax credits your client is eligible to claim, use this formula:

    [(tax on taxable income/taxable income) x PIE income]

    Learn more about handling PIE income in tax returns.

    2058Invalid provisional tax option

    IR3, IR3NR, IR4 and IR6 only

    The provisional tax option hasn't been selected.

    In the affected tax return's Provisional tax section, select the provisional tax option.

    2067

    Total partnership attribution of income must equal 100

    IR7 only

    The attribution of income between partners needs to equal 100%.

    Check the percentage in the attribution of income for each partner.

    If the total attribution between partners doesn't equal 100%, adjust the return.

    2074One shareholder can't have remuneration as well as shareholder loss offsets or subvention payments

    IR4 only

    One shareholder can't have both remuneration, and subvention or loss offsets because:

    • Remuneration can only be paid to a person.
    • Subvention and loss offsets only happen between companies in the same group.

    For each shareholder, check which of the remuneration, subvention and loss offsets are valid, and remove the amounts for the fields that don’t apply

    2075

    No is selected for Estate or trust paying tax on beneficiary's income. Remove the beneficiary's Tax on taxable income amount, or select Yes.

    IR6 only

    A beneficiary has an amount in Tax on taxable income, but the Estate or trust paying tax on beneficiary’s income field has No selected, which contradicts this.

    For each beneficiary, check that Tax on taxable income has a value. If they have a value entered, check that Yes is selected for Estate or trust paying tax on beneficiary’s income.

    If the trust isn't paying the tax, remove the value in Tax on taxable income.

    2152Partner IRD is required when specifying partner donation amounts

    IR526 only

    When some of the receipts are allocated to the partner, the partner's IRD number must be entered.

    In the Partner's details section of the IR526 Tax credit claim form, enter the partner's IRD number.
    2227

    Residential rental indicator is required

    IR3, IR3NR, IR4, IR6 and IR7 only

    The Residential rental income indicator hasn't been selected. If your client has residential rental income or deductions, you're required to select the indicator and provide a value.

    In the tax return or Residential rental income workpaper or schedule, select the Residential rental income indicator.
    2337Loss brought forward has a value but business loss continuity has not been selected

    IR4 only

    When there are losses brought forward, regardless of whether the losses are claimed, an option must be selected for the question about the business continuity test in the Losses section. Learn more about the business continuity criteria.

    To Is the company carrying forward losses under the business continuity test? in the Losses section, select Yes or No to the question as appropriate.
    2339Settlor commencement date cannot be in the future

    IR6 only

    There must be a valid date for a settlor's date of birth or commencement date for non-individuals. It can't be a date later than today's date.

    Check the date of birth or commencement date. If it's in the future, change it to a valid date.
    2341Settlor IRD number failed IR's validation check - it must be valid, 9 digits, and have no other charactersThe settlor IRD number is invalid.

    Check that you've entered the correct IRD number for each settlor. IRD numbers can't have hyphens. Enter a leading zero if the IRD number is only 8 digits. Settlors can't have nine zeroes (000000000).

    2343TIN required for the selected jurisdiction

    IR6 only

    A Tax identification number (TIN) is required for settlors unless the option TIN not required is selected. For more details, see page 8 of the IR6 guide.

    • If the TIN is required – in the Tax identification number field, enter the TIN for the jurisdiction selected.
    • If the settlor isn't required to hold a NZ IRD number or a TIN in another jurisdiction, select TIN not required.
    2344The value should be "TINs are issued" for NZ

    IR6 only

    The TINs are issued option hasn't been selected for the question Tax identification numbers (TINs) are not issued by jurisdiction. If you select NZ for the Jurisdiction of tax residency for a settlor, you're required to select TINs are issued.

    If the tax jurisdiction is NZ, at the question Tax identification numbers (TINs) are not issued by jurisdiction for a settlor, select TINs are issued.
    2345Other description must be provided when Other has a value

    IR6 only

    In the Settlement section, when you've entered an amount in the Other field, you need to provide information about the nature of the settlement.

    In the Other description field, enter a description for the amount.
    2346One or more reasons must be selected when residential rental interest has been claimedIf any interest is being claimed for residential rental interest, a reason must be selected. Check IR's website for more information on interest limitation rules and the reasons for interest claimed.In the Residential rental interest section, select one or more of the six available interest claimed reasons.
    2347No beneficiary name has been enteredIR6 only
    A beneficiary section exists, but no name has been entered.
    • If the beneficiary is required, check that the name has been entered.
    • If the a beneficiary isn't required, remove the section causing issues. If you remove (Image Added) it. You can't see the beneficiary section, add a new blank section and remove the one causing issues:
      1. Click Add another section and leave it blank.
      2. Remove (Image Removed) the section causing the issue.
    • file a return with a section that has no data or incomplete data.
    2348A beneficiary date of birth or commencement date is required

    IR6 only

    A beneficiary doesn't have a value for Date of birth or commencement date. Unless the trust is exempt from compliance, the date of birth, or commencement date for non-individuals must be supplied for all beneficiaries.

    Make sure all beneficiaries have a date of birth or commencement date.
    2349No value has been provided for beneficiary tax jurisdiction

    IR6 only

    A beneficiary doesn't have a value for 'Jurisdiction of tax residency'. The jurisdiction must be supplied for all beneficiaries, unless the trust is exempt from compliance

    Select the relevant country in the list for Jurisdiction of tax residency for any beneficiary that doesn't have a country already selected.
    2350The value should be "TINs are issued" for NZ

    IR6 only

    The TINs are issued option hasn't been selected for the question Tax identification numbers (TINs) are not issued by jurisdiction. If you select NZ for the Jurisdiction of tax residency for a beneficiary, you're required to select TINs are issued.

    If the tax jurisdiction is NZ, at the question Tax identification numbers (TINs) aren't issued by jurisdiction for a beneficiary, select TINs are issued.
    2351Beneficiary IRD number can’t be blank

    IR6 only

    Beneficiaries must have an IRD number entered if the jurisdiction is New Zealand, and the trust isn't exempt from compliance.

    A valid IRD number must be entered when the jurisdiction of tax residency is New Zealand, unless TIN not required is selected. From 2022, you can't enter nine zeroes (000000000) for a beneficiary IRD number.
    2352Beneficiary IRD number failed IR's validation check - it must be valid, 9 digits, and have no other characters

    IR6 only

    A beneficiary IRD number doesn't have the required number of characters or has invalid characters.

    Check that you've entered the correct IRD number for each settlor. IRD numbers can't have hyphens. Enter a leading zero if the IRD number is only 8 digits. From 2022, you can't enter nine zeroes (000000000) for a beneficiary IRD number.
    2358No value has been provided for settlor tax jurisdiction

    IR6 only

    A settlor doesn't have a value for Jurisdiction of tax residency. The jurisdiction must be supplied for all settlors.

    In Jurisdiction of tax residency, select the relevant country for any settlor that doesn't have a country already selected.
    2359The value of at least one of the settlement fields must be non-zero

    IR6 only

    For settlements made this year, if No is selected for Zero value settlement in the settlement section of settlor details, then at least one of the fields in the section (cash, financial arrangements, land, buildings, shares and ownership interest or other) must have a value.

    Learn more about additional trust reporting requirements and also refer to pages 7-9 of the IR6 guide for settlor requirements.

    • If there was a settlement this year of value, enter an amount in one or more of the settlement fields.
    • If the settlement this year was valued at nil, change the Zero value settlement setting to Yes.

    The numerical code for each error matches a particular Inland Revenue rejection error code.

    3. Validate again and file the return

    Validate the return again, and if there are no errors, you can file the return.

    UI Text Box
    typetip

    If you find more errors, repeat the process from Step 1.

    HTML
    </span>
    HTML Wrap
    width15%
    classcol span_1_of_5
     
    HTML Wrap
    floatleft
    classcol span_1_of_5
    Panelbox
    namemagenta
    titleRelated topics
    HTML Wrap
    classsidebarlinks

    Known issues in MYOB Practice tax - NZ

    Preparing a tax return - NZ

    Filing a tax return - NZ

    MYOB Practice home

    ...