| Error Code |
Failure Reason |
Resolution steps |
| FORMAT_NINO |
The NI number you provided is invalid. A NI number consists of 9 characters (beginning with 2 letter,s then 6 digits, then a letter), e.g. TC663795B. |
In IRIS KashFlow, go to Settings > Income Tax Settings and check that the NI number and Self-employment ID are correct. |
| CLIENT_NOT_SUBSCRIBED |
The supplied user credentials failed validation. |
Contact your agent and check they have activated Final Declaration submissions in their HMRC portal. |
In IRIS KashFlow, go to Settings > Income Tax Settings and check the NI number and self-employment ID are correct. |
| AGENT_NOT_SUBSCRIBED |
The supplied partner credentials failed validation. |
Contact your agent and check they have activated Final Declaration submissions in their HMRC portal. |
| AGENT_NOT_AUTHORIZED |
The agent is not authorised to perform this action. |
Contact your agent and check they have activated Final Declaration submissions in their HMRC portal. |
| FORMAT_TAX_YEAR |
The format of the supplied tax year field is not valid. |
Ensure that your accounting year is in YYYY-YY format e.g. 2017-18. |
| RULE_TAX_YEAR_NOT_SUPPORTED |
The specified tax year is not supported, i.e it’s before the minimum tax year value. |
You cannot submit Income Tax Self Assessment returns for the specified year using Making Tax Digital, you must submit a manul return. |
| RULE_TAX_YEAR_RANGE_INVALID |
Tax year range invalid. A tax year range of one year is required. |
Make sure your accounting year is in YYYY-YY format e.g. 2017-18. |
| FORMAT_CALC_ID |
The format of the supplied calculation ID is not valid. |
Ensure that the calculation ID is correct. |
| RULE_INCORRECT_OR_EMPTY_BODY_SUBMITTED |
An empty or non-matching body was submitted, this could be caused by a missing mandatory field. |
Ensre that all mandatory fields have been completed. |
| RULE_INCOME_SOURCES_CHANGED |
Information relating to your income sources has changed. |
Reinitialise the final declaration. |
| RULE_RECENT_SUBMISSIONS_EXIST |
More recent submissions exist. |
Reinitialise the final declaration. |
| RULE_RESIDENCY_CHANGED |
Residency has changed. |
Reinitialise final declaration. |
| RULE_FINAL_DECLARATION_RECEIVED |
Final declaration has already been received. |
Refresh tax submissions and proceed to the next tax year. |
| RULE_INCOME_SOURCES_INVALID |
There are no valid income sources. |
Please contact HMRC. |
| RULE_NO_INCOME_SUBMISSIONS_EXIST |
No income data has been submitted against the tax year. |
Ensure that all income and expense updates for the current accounting year have been summited. |
| RULE_SUBMISSION_FAILED |
There are some validation errors. |
Please contact HMRC. |