Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 22 Next »

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.

Type Code

…or Category Code

CDS10001

Obligation error: obligation rule not met

This can sometimes appear if a user edits or adds an ‘Additional Document’ within the declaration items without properly setting the ‘Import Certificate’ field. In this case the record disappears from the screen but is still sent in the message to customs, please contact support if you have this issue for the record to be manually removed.

This will be fixed in an upcoming version of Bond to prevent this from happening, reference VB-1290.

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. It is for use with excise products.

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

See Known issues / workarounds.

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

Consolidated Workaround Document

In response to requests from the CDS developer community, HMRC has developed a Consolidated CDS Workaround Document, which you can find attached. This asset aims to provide a consolidated list of all known workarounds applicable to CDS, derived from both the Known Differences document, which this asset has now supplanted, as well as entries from the Known Error Log which currently have workarounds. Where possible, estimated resolution dates have also been included, in order that the user knows for how long each workaround will be applicable.

As this document update is an accompaniment to a ‘dot’ release (3.8.1) it has been used to provide additional entries, as well as modified resolution dates. The next round of resolution packages and KEL fixes will be deployed as part of CDS 3.9.0, dates for which can be found via the CDS External Test Release Roadmap on the CDS Developer Hub.

Please note, the Consolidated Workaround Document is not exhaustive, and will be updated alongside each production release to reflect resolution progress, and any additional entries which may come to light. Designed to support declarants in making successful submissions, the entries listed should not pose a barrier to your clients’ migration.

Additional Documents & their Status Codes

HMRC were reviewing the ID / Status code requirements 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.

  • No labels