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 (C88, E2, commercial invoices) and link them to declarations.
• HS code lookup — search commodity codes and verify tariff requirements before submitting.
• Compliance tools — preference checker, rules of origin simulator, and landed cost calculator built in.

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® to act on your behalf via HMRC OAuth. Your access token is stored securely and refreshed automatically.
• 2. Create a declaration — enter your EORI, dispatch country, HS code, and goods details. freightcode® maps everything to WCO XML.
• 3. Attach documents — upload or paste supporting documents (C88, commercial invoice, packing list). The system validates document codes against CDS requirements.
• 4. Submit — one click sends the declaration to HMRC CDS. The MRN is stored immediately.
• 5. Track status — DMSACC, DMSROG, DMSCLE, and DMSREJ notifications appear on your dashboard in real time.