Getting Started

Introduction

freightcode® connects directly to HMRC's Customs Declaration Service (CDS) via official OAuth, letting UK importers, customs brokers, and freight forwarders submit WCO-compliant declarations, track clearance status in real time, and maintain a full compliance audit trail.

What freightcode® does

• HMRC CDS submissions — submit H1 import declarations directly to CDS with full WCO DEC-DMS:2 compliance.
• Real-time notifications — receive HMRC DMS notifications (DMSACC, DMSCLE, DMSREJ) via webhook the moment HMRC responds.
• Compliance audit — every submission, amendment, and HMRC response is logged in an immutable audit trail.
• Document management — upload, paste, or generate supporting documents and link them to declarations.
• Export controls — classification, sanctions screening, EUSU, and licence draft packs alongside CDS.
• Financial control — duty and VAT estimates vs HMRC-confirmed charges on the MRN.

Who it's for

• UK importers managing their own HMRC CDS filings
• Customs brokers filing on behalf of clients
• Freight forwarders needing real-time clearance visibility

How it works

• 1. Connect HMRC — authorise freightcode® via HMRC OAuth. Tokens refresh in session.
• 2. Create a declaration — enter EORI, parties, HS codes, and goods details. Mapped to WCO XML.
• 3. Attach documents — invoices, packing lists, and other supporting documents on the declaration.
• 4. Submit — send to HMRC CDS. The MRN is stored immediately.
• 5. Track status — DMSACC, DMSROG, DMSCLE, and DMSREJ appear on your dashboard.