Customs Declaration Service end-to-end service guide
This guide explains how you can integrate your software with our APIs to complete a customs declaration.
It shows how the APIs fit into various end-to-end user journeys. It is also intended to help software developers, designers, product owners or business analysts understand how your software needs to interact with HMRC systems.
The Customs Declaration Service (CDS) is replacing the Customs Handling of Import and Export Freight (CHIEF) with a modern and flexible system that can handle anticipated future import and export growth.
For imports or exports outside outside of the European Union, there will be differences in the information they need to put in their declarations. This is due to changes to the UK Trade Tariff required by the Union Customs Code.
End-to-end user journeys
These journeys show examples of use.
- developers set up
- submitting import and export customs declarations
- receiving notifications
- uploading supporting documentation
- query declaration status
- inventory linking for export declarations
- making arrival notifications
- validating import movements (CSPs only)
Note that links in this guide to other CDS APIs (except for Customs Inventory Linking Exports API) will only work when logged in and subscribed.