DEV Community

Cover image for TSS API: A Developer's Introduction to Customs Declarations
Kristi Hampson
Kristi Hampson

Posted on

TSS API: A Developer's Introduction to Customs Declarations

Overview

The Trader Support Service (TSS) API is a submission channel for customs declarations moving goods into Northern Ireland. Your system builds a payload, sends it to TSS, and gets back a JSON response — accepted, or an error list.

Declaration types you can submit

  • Entry Summary Declarations
  • Simplified Frontier Declarations
  • Supplementary Declarations
  • Full Frontier Declarations
  • Port movement references (authorisation-dependent) Payloads can be built progressively, so partial state is normal. The TSS API technical guide explains how this maps to real workflows.

Request and response shape

Requests carry declaration data. Responses are JSON with either an acceptance confirmation or an errors array. Design your client to treat both as first-class outcomes.

What you still have to build

The API does not extract invoice data, validate commodity codes, confirm weights or resolve missing documents. That is your upstream problem.

See a working TSS integration from data ingest to submission — Watch a demo.

Top comments (0)