Guidance

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.

From:
HM Revenue & Customs
Published
27 October 2022
Last updated
4 March 2025 바카라 사이트� See all updates

Documents

ODS, 171 KB

This file is in an OpenDocument format

This file may not be suitable for users of assistive technology.

Request an accessible format.
If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

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:

  1. 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.

  2. 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

Published 27 October 2022
Last updated 4 March 2025 show all updates

  1. 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.

  2. 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.

  3. 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)바카라 사이트�

  4. The 'ABD Update' tab of the 'Workarounds for known errors with the Customs Declaration Service' document has been corrected.

  5. 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.

  6. 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.

  7. 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.

  8. 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.

  9. 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.

  10. 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.

  11. 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.

  12. 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.

  13. 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.

  14. 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.

  15. 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.

  16. 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.

  17. The 'workarounds for known errors with the Customs Declaration Service' file has been updated with the latest information on consolidated workarounds.

  18. First published.

Sign up for emails or print this page

Related content