HMRC Making Tax Digital error messages
What each error code from HMRC's Making Tax Digital service means, what to check and how to fix it, for VAT returns, income tax quarterly updates and the final declaration. Codes and messages are as HMRC publishes them.
Making Tax Digital for Income Tax
CLIENT_OR_AGENT_NOT_AUTHORISEDThe client and/or agent is not authorisedMATCHING_RESOURCE_NOT_FOUNDMatching resource not foundFORMAT_NINOThe NINO format is invalidRULE_BUSINESS_ID_STATE_CONFLICTThe request conflicts with the current state of the business IDRULE_BUSINESS_INCOME_PERIOD_RESTRICTIONFor customers with ITSA status 'Annual' or a latent business income source, submission period has to be 6 April to 5 AprilRULE_MISALIGNED_PERIODPeriod summary is not within the accounting periodRULE_NOT_CONTIGUOUS_PERIODPeriod summaries are not contiguousRULE_OVERLAPPING_PERIODPeriod summary overlaps with any of the existing period summariesRULE_DUPLICATE_SUBMISSIONA summary has already been submitted for the period specifiedRULE_TAX_YEAR_NOT_SUPPORTEDThe specified tax year is not supported. The tax year specified is before the minimum tax year valueRULE_TAX_YEAR_NOT_ENDEDThe specified tax year has not yet endedRULE_OUTSIDE_AMENDMENT_WINDOWYou are outside the amendment windowRULE_BOTH_EXPENSES_SUPPLIEDBoth expenses and consolidatedExpenses can not be present at the same timeRULE_NOT_ALLOWED_CONSOLIDATED_EXPENSESConsolidated expenses are not allowed if the accumulative turnover amount exceeds the thresholdRULE_QUARTERLY_PERIOD_UPDATINGThe quarterly period type cannot be changed when a business commencement date falls between 1st and 5th of April, and the current date is also within that date range but later than the business commencement dateRULE_TYPE_OF_BUSINESS_INCORRECTThe businessId is for a different type of businessRULE_FINAL_DECLARATION_RECEIVEDFinal declaration has already been receivedRULE_PREMATURE_FINALISATIONFinalisation cannot occur until after the end of the tax yearRULE_INCOME_SOURCES_CHANGEDIncome sources data has changed. Trigger a new calculationRULE_RECENT_SUBMISSIONS_EXISTMore recent submissions exist. Trigger a new calculationRULE_CALCULATION_IN_PROGRESSA calculation is in progress. Please wait before triggering a new calculationRULE_NO_INCOME_SUBMISSIONS_EXISTNo income submissions exist for the tax yearRULE_DECLARATION_NOT_RECEIVEDThe final declaration has not been receivedRULE_INCOME_SOURCES_INVALIDNo valid income sources could be foundRULE_REQUEST_CANNOT_BE_FULFILLEDRequest cannot proceed for this income source typeNO_OBLIGATIONS_FOUNDNo obligations found using this filterRULE_INSOLVENT_TRADERThe remote endpoint has indicated that the Trader is insolventMaking Tax Digital for VAT
DUPLICATE_SUBMISSIONThe VAT return was already submitted for the given periodNOT_FINALISEDUser has not declared VAT return as finalTAX_PERIOD_NOT_ENDEDThe remote endpoint has indicated that the submission is for a tax period that has not endedVAT_TOTAL_VALUEtotalVatDue should be equal to the sum of vatDueSales and vatDueAcquisitionsVAT_NET_VALUEnetVatDue should be the difference between the largest and the smallest values among totalVatDue and vatReclaimedCurrPeriodVRN_INVALIDThe provided VRN is invalidPERIOD_KEY_INVALIDInvalid period keyINVALID_MONETARY_AMOUNTamount should be a monetary value (to 2 decimal places), between 0 and 99,999,999,999.99DATE_RANGE_TOO_LARGEThe date of the requested return cannot be further than four years from the current date