Introduction
After submitting declarations to HMRC, you ‘Pull Notifications’ to receive the messages they’ve queued for you. Sometimes they’ll reject your declarations (more info here: https://visionsoftware.atlassian.net/wiki/spaces/VB/pages/2467954802/Using+CDS+day-to-day#Handling-rejections-%2F-failures), this page will help you correct them to resubmit and get a successful response.
Rejection messages displayed are exactly as received from HMRC, they usually refer to problems with particular fields in the declaration. Our field names closely match HMRC’s field names which will help you locate the problem fields.
Having a good understanding of HMRC’s CDS declaration structure (and therefore the structure of our screen which closely resembles it) is imperative to easily understand where in your data the problems lie, for more info see: https://visionsoftware.atlassian.net/wiki/spaces/VB/pages/2468708372/CDS+declaration+contents#Declaration-structure.
Our guidance
Find below the common rejections with information about how to fix them.
Instructions
Tag name | Element name | Validation Code & Description | Explanation |
|---|---|---|---|
DeclarationAdditionalDocument | Declaration Additional Document | CDS12125 DAN Error: Account number is not recognised; or Account is suspended or revoked, or Parties declared on the declaration do not have authority to use account number provided. | This refers to the deferment account number visible in Declaration > Other Details > Additional Document and is either because of the reasons provided, or most commonly because the EORI of the deferment account owner is incorrect in Shipment(s) > Shipment View/Edit > Importer > ID. |
DeclarationExporter | Address Line …or… CityName …or… PostcodeID …or… Country Type | CDS10001 Obligation error: obligation rule not met | This means that the field has been omitted and must be provided, the ‘Tag name’ will indicate where this is missing, ‘DeclarationExporter’ can be found by clicking ‘Declaration’ tab followed by ‘Exporter/Declarant/Agent’ and looking at the ‘Exporter’ fields. |
DeclarationGoodsShipmentImporter | Goods shipment importer | CDS12005 Authorization error: invalid Party ID | This indicates that the ID provided (usually the EORI) is invalid. 'Goods shipment importer' means you have to click the ‘Shipment(s)’ tab > top (Shipments) grid click View/Edit > modify the ‘Importer’ information. |
DeclarationGoodsShipmentItemCommodity | Classification | CDS40011 Missing additional code:[X***] | This suggests that the stock was receipted with an invalid tax / commodity code combination. Click ‘Shipment(s)’ tab, bottom (Items) grid click View/Edit > using the ‘Nom Classif ID’ (Commodity Code), check in the https://www.trade-tariff.service.gov.uk/sections ‘Imports’ section for that commodity code what the permitted ‘Excise additional codes' (tax codes) are. Either the ‘Nom Classif ID', 'TARIC Classif ID’ or 'Classif ID' will need to be amended.  If the message returned is “Missing additional code: [VATZ]” in this scenario ‘VATZ’ needs to be added within Declaration > Shipment > Items > Commodity > Classif ID along with a Classification Type, for example VATZ with classification type ‘TRA’. This must not be used for customs duty payments for excise products however. |
CDS40013 Invalid nomenclature codes | In this case check Declaration > Shipment > Items > Commodity Nom Classif ID & TARIC Classif ID (combined) is correct by checking the tariff. | ||
CDS40045 Missing document | Indicates that the commodity being submitted requires an entry in the Declaration > Shipment > Items > Additional Document section. Refer to the online tariff, search for the commodity being declared (Nom Classif ID + TARIC Classif ID e.g. 04049021 + 00 = 0404902100), if the declaration is Trade Movement Type ‘IM’ then click the ‘Imports’ tab and look for any ‘Conditions’ which will explain the documents required and their codes. For example 0404902100 veterinary controls shows a condition for document N853. If a code is mentioned which we don’t have in the system then contact support to have it added. Refer: /wiki/spaces/VSKB/pages/1306099733 This same section of the tariff also mentions the document status codes which are permitted for the document which can be entered into the LPCO Exemption Code field within the ‘Additional Document’ record. | ||
DeclarationGoodsShipmentItemAdditionalDocument | AdditionalDocument | Missing Preference Certificate | This rejection can occur when using a GSP preference and you don’t have U164 / 5 / 6 / 7 listed as an import certificate within the Declaration > Goods Shipment Item > Additional Document section. If you have N954 listed, this is incorrect and cannot be used for GSP so remove and replace with one of the codes above along with it’s relevant ID. Alternatively add the document code above in as an additional document. |
Workarounds
Tag name | Element name | Validation Code & Description | Explanation |
|---|---|---|---|
DeclarationGoodsShipmentItemAdditionalDocument | AdditionalDocument | X447 For GP1 greater than 60000hl and ASV greater than 7.5% this additional code needs to be supplied | In the Declaration > Goods Shipment Item > Commodity:
This is required for high strength beers, when VW-6476 is released in v6.5.1 this will be automatic, users need to follow the workaround above in the meantime. |
HMRC guidance
CDS Error Codes
https://www.gov.uk/government/publications/customs-declaration-service-error-codes
This document outlines how to resolve common error code responses which may appear if incorrect, invalid or unauthorised information is input into a declaration.
The document provides:
a list of common CDS error codes for import and export declarations
a description of the error code
an explanation of the error code
This will help you to correct CDS submissions, should declarations be subject to issues or rejections.
Known differences between CDS and the UK Trade Tariff: Volume 3 for CDS
To help you better understand and remedy known misalignments between the UK Trade Tariff: Volume 3 for CDS and CDS system behaviour, a comprehensive overview guide has been developed by HMRC.
Created in conjunction with developers to draw upon critical customer insight, the document provides:
a register of the known differences between CDS and the UK Trade Tariff: Volume 3 for CDS
steps to take (‘workarounds’) when encountering a known difference
an estimated resolution date for CDS system alignment.
Whilst the document outlines key CDS to UK Trade Tariff misalignments most likely to cause issues or rejections, it is an inexhaustive list.
Designed to support declarants make a successful submission, misalignments should not pose a barrier to your migration.
HMRC were reviewing the ID / Status code requirements but this information is correct as of Q4 2021. Unfortunately, this information isn’t published publicly anywhere else but if this changes we will add it here in the future.