Known error workarounds for the Customs Declaration Service (CDS)
Check for workarounds to the declaration completion instructions for Customs Declaration Service known errors if you鈥檙e submitting a customs clearance request or customs declaration.
Documents
Details
In order to support you in your interactions with the Customs Declaration Service platform, HMRC has created a consolidated workaround document, hosting all known workarounds in a single product.
Why workarounds are needed
Workarounds are provided to support you in using the Customs Declaration Service as the platform proceeds through the final stages of its development. The need for workarounds may result from several factors and includes providing:
- mitigations for misalignments between CDS and the Declaration Completion instructions prior to their resolution
- mitigations for known errors in CDS functionality prior to their resolution
- interim mitigations for gaps in functionality, prior to its delivery in a later production release
Workarounds best practice
This document is not exhaustive and will be updated alongside each CDS production release.
If you encounter a misalignment of error for which there is no listed workaround, please apply the following best practice principles:
-
If declaration completion instructions indicate that it is not essential for a data element to be completed, or for supporting documentation to be provided, try submitting the rejected declaration again with all fields completed.
-
If a code combination is being rejected, returning error code CDS12056, then please try again with the closest alternative code.
Authorisation by declaration workarounds
The guidance is intended to assist declarants submitting declarations at import or export for consignments which are either:
- entering a Special Procedure using authorisation by declaration
- being discharged from a Special Procedure which they entered using authorisation by declaration
Customs Declaration Service system functionality for authorisation by declaration does not always match the requirements as set out in the completion guide, so these notes will assist in declaration completion.
Updates to this page
-
This 鈥楥onsolidated Workaround Document Intra Release 02.2025鈥� edition includes Known Differences (KD) that have been resolved so far, which have been moved to the Resolved and Closed tab. There is also 1 new Known Difference, and the Known Error Log (KEL) has some new additions, amendments and closures.
-
Updates have been made to the 'Workarounds for known errors with the Customs Declaration Service' document to reflect changes resulting from Customs Declaration Service release 4.6 on 28 September 2024.
-
This Consolidated Workaround Document July Post - 4.5.0 release edition confirms those Known Differences (KD) resolved by the 4.5.0 update. There are also 3 new Known Differences, 1 CR amendment, 1 CR resolution and 1 ILE vs CHIEF resolution. Known Error Logs (KEL) also have some new additions, amendments and closures. Updates and changes are listed on the individual Change Log tabs. To view the details of these changes navigate to the relevant tabs (KD, KEL, ILE vs CHIEF or CR)鈥�
-
The 'ABD Update' tab of the 'Workarounds for known errors with the Customs Declaration Service' document has been corrected.
-
This Consolidated Workaround Document contains new Known Error Log (KELs), and new Known Differences (KDs) that are set to be amended in the 4.5.0 CDS release in July 2024. Updates and changes are listed on the individual Change Log tabs. To view the details of these changes navigate to the 鈥楰D 鈥� Workarounds鈥�, 鈥楰EL- Workarounds.
-
The May edition of the Consolidated Workaround Document contains Known Error Log (KEL) updates and new ILE Vs CHIEF changes. There are also some Known Difference (KD) amendments. The changes are listed on the individual Change Log tabs. To view these changes navigate to the 鈥楰D 鈥� Workarounds鈥�, 鈥楰EL 鈥� Workarounds鈥�, 鈥楰D 鈥� Resolved鈥�, 鈥楰EL 鈥� Resolved and Closed鈥� and 鈥業LE Vs CHIEF鈥� tabs.
-
The edition contains notice of minor business rule changes delivered March 2024 as part of CDS 4.4.0, updated Authorisation By Declaration (ABD) advice and Known Error Log (KEL) updates. To isolate these items, navigate to the 鈥楰nown Differences 鈥� Workarounds鈥�, 鈥楢BD鈥� or 鈥楰EL- Workarounds鈥� and 鈥楰EL 鈥� Resolved and Closed鈥� tabs.
-
This updated Consolidated Workaround Document (CWD) edition contains closed and removed Known Error Logs (KELs), which are not relevant or required for Declarants using Customs Declaration Service (CDS). There is a new addition, and 2 amendments to 鈥業LE Vs CHIEF Known Difference鈥� tab. The minor changes and removals can be found in the 鈥楥hange Log鈥� tab.
-
This updated Consolidated Workaround Document (CWD) edition contains notice of Inventory Linked Exports (ILE) v Customs Handling of Import and Export Freight (CHIEF) Known Differences amendments and a new addition, which can be found in the 鈥業LE v CHIEF Known Differences鈥� tab. This edition also contains notice of additional KELs and changes to KELs which are detailed on the 鈥楧ocument Guidance and Change log鈥� tab and can be found in the 鈥楰EL-Workarounds鈥� tab, and notice of a new Change Request (CR) and amended CR guidance, which can be found in the 鈥楥R Workarounds 鈥� Declarants鈥� tab.
-
This updated Consolidated Workaround Document (CWD) edition contains notice of resolved and closed minor business rule changes that were delivered in late 2023 as part of the Customs Declaration Service 4.3.0. update. To isolate these items, navigate to the 鈥楰nown Differences 鈥� Resolved/Closed鈥� tab. This CWD also details changes to KEL 612 which can be found in the 鈥楰EL-Workarounds鈥� tab.
-
This edition contains notice of minor business rule changes to be delivered in late 2023 as part of CDS 4.3.0. To isolate these items, navigate to the 鈥楰nown Differences 鈥� Workarounds鈥� tab. The 鈥楥R Workaround鈥� tab listing priority Change Request items for Declarants has 1 new addition. This CWD also contains 鈥業LE v CHIEF 鈥� Known Difference鈥� tab listing known differences between Inventory Linked Exports/CHIEF and user actions.
-
An updated Consolidated Workaround Document (CWD) has been added to cover Known Difference updates post-CDS-4.2.0, and Known Error Log updates post-CDS-4.1.2. This CWD must be used for reference and workarounds until further notice.
-
This Consolidated Workaround Document edition contains notice of some minor business rule changes delivered as part of CDS 4.2.0 in September 2023. To isolate these items, navigate to the 鈥楰nown Differences 鈥� Resolved鈥� tab. There are also new items added, with resolution due dates to be delivered later in 2023, navigate to the 鈥楰nown Differences 鈥� Workarounds鈥� tab. Going forward, this and subsequent Documents will also contain 鈥楥R Workaround鈥� tab listing priority Change Request items for Declarants.
-
This updated Consolidated Workaround Document edition contains notice of some minor business rule changes delivered as part of CDS 4.1.2 in August 2023. To isolate these items, navigate to the 鈥楰nown Differences 鈥� Resolved鈥� tab. There are also new items added, with resolution due dates to be delivered later in 2023, to the 鈥楰nown Differences 鈥� Workarounds鈥� tab. Items previous listed in 鈥業tems without Workarounds鈥� tab have now been moved to Resolved or Workarounds tabs, and the 鈥業tems without Workarounds鈥� tab has been removed. This and subsequent Documents will also contain 鈥楥R Workaround鈥� tab listing priority Change Request items for Declarants.
-
This updated Consolidated Workaround Document contains an additional Export Change Requests information tab (鈥楥R Workaround 鈥� Declarants鈥�). The additional tab covers 3 Export Change Requests and their workarounds, including Goods Vehicle Movement Service export journey simplification and Trader Dress Rehearsal environment. These are priority issues being addressed with estimated resolution Financial Year 2023 to 2024.
-
This 'consolidated workaround' document edition contains notice of a number of minor business rule changes delivered as part of CDS 4.1.0 in June 2023. To isolate these items, navigate to the 鈥榢nown differences 鈥� resolved鈥� tab. There are also new items added, with resolutions due to be delivered later in 2023, navigate to the 鈥榢nown differences 鈥� workarounds鈥� tab.
-
The 'workarounds for known errors with the Customs Declaration Service' file has been updated with the latest information on consolidated workarounds.
-
First published.