HMRC CDS

Declarations

A declaration is the central record in freightcode®. It maps to a single HMRC CDS H1 import declaration — from draft through to clearance.

Declaration types

freightcode® currently supports H1 — the standard frontier import declaration for goods released into free circulation in the UK (Customs Procedure Code 40 00).

Creating a declaration

• 1. Go to Declarations in the sidebar.
• 2. Click New Declaration.
• 3. Select the Origin Country, optionally enter an HS code and description, then click Create Declaration.
• 4. You are taken directly to the Goods Items tab with the first row pre-filled.

Only Draft declarations can be deleted. Once submitted, a declaration is permanent.

Core Schema (Tab 1)

The Core Schema tab captures the top-level declaration fields:

• Declarant EORI (required) — your GB EORI number, e.g. GB123456789000. Must match your HMRC Developer Hub credentials.
• Declaration Category — H1 (Release for Free Circulation). Currently the only supported type.
• Customs Routing — Route 1 (Documentary Check), Route 2 (Physical Exam), or Route 6 (Direct Clearance).
• Dispatch Country (DE 5/14) (required) — the country the goods were shipped from. Must never be GB for a third-country import.

Goods Items (Tab 2)

Each declaration requires at least one goods item. Fields required per item:

Submission (Tab 3)

Click Submit to HMRC. freightcode® will:

• Run a preflight validation against all required CDS fields
• Map your data to a WCO DEC-DMS:2 compliant XML payload
• POST the XML to HMRC CDS via the official API
• Store the MRN and X-Conversation-ID returned by HMRC

A 202 Accepted response from HMRC moves the declaration to Processing. If validation fails, errors are shown inline — fix them and resubmit.

HMRC Status (Tab 4)

All HMRC notifications for this declaration appear here in real time:

• DMSACC — declaration accepted by CDS
• DMSROG — goods registered; may be examined by Border Force
• DMSCLE — goods cleared; shipment can be released
• DMSREJ — declaration rejected; error detail shown inline
• DMSCTL — goods selected for physical examination