10 Entry summary declaration
10.1 Intro
Starting 1 January 2026, shipments to Ireland and Northern Ireland transported via the UK require an Entry Summary Declaration (ENS) in addition to a T2 transit document. This API enables you to submit ENS data electronically to DHL, ensuring compliance with Irish customs regulations and uninterrupted transport through the UK.
To create and include the ENS as part of a shipment use create shipment.
Preconditions
An authorization token in the header of the HTTP request is mandatory. (see Authentication and Authorization).
10.2 Services
10.2.1 Entry summary declaration
This endpoint is used to submit an Entry Summary Declaration (ENS) for shipments traveling to Ireland or Northern Ireland via the UK.
More info can be found in the swagger documentation.
| Field | Type | Mandatory | Description |
|---|---|---|---|
| orderReference | string | N | Your own reference and the same refence as used for the shipment |
| accountId | string | Y | As provided by DHL. May only be empty for C2C customers |
| currency | string | Y | ISO Currency of the values of the goods, allowed values: EUR, GBP, USD |
| receiver | Y | Name and address | |
| name | Requires at least firstName, lastName or companyName | ||
| firstName | string | N | |
| lastName | string | N | |
| companyName | string | N | |
| address | Depending on country, use designated endpoint to check input address | ||
| street | string | Y | |
| number | string | N | |
| addition | string | N | |
| postalCode | string | Y | |
| city | string | Y | |
| countryCode | string | Y | ISO 3166-1 alpha-2 country code |
| goods | Y | Goods, at least one is required | |
| code | string | Y | HS-code (6 digits) of the goods, see Harmonized commodity description and coding System, to classify globally traded products |
| description | string | Y | Description of the good |
| quantity | string | N | Number of goods with this HS-code |
| netWeightKg | string | Y | Max 3 decimals. Total weight of this good(s) in kg |
| value | string | N | Max 2 decimals. Total value of this good(s), needs to be filled to avoid custom checks! |
| trackerCodes | Y | TrackerCodes associated with this declaration, at least one is required | |
| trackerCode | string | Y |
10.3 API Usage
| Description | URL |
| Create entry summary declaration (prod) | https://api-gw.dhlparcel.nl/entry-summary-declaration |
Note: For testing, collect your **Sandbox** API key in My DHL eCommerce