TNT Guide

TNT is a courier and logistics company that offers domestic and international shipping solutions for shipments originating in the UK. TNT provides express delivery services for businesses and individuals across the United Kingdom and internationally. Their services include same-day delivery, next-day delivery, and international delivery options, as well as tracking and insurance for packages.

This guide provides developers an overview of shipping services that TNT offers and the service codes that you will use to create TNT shipments.

Connect Your Account

ShipEngine API allows you to connect your TNT accounts programmatically without logging in to the ShipEngine API dashboard. This is useful if you have wrapped a custom UI around the ShipEngine API toolset and want to add or disconnect existing carrier accounts without exposing your end users to the API dashboard.

These APIs can be used in parallel with the ShipEngine Partner APIs to programmatically create new ShipEngine users, and then connect existing TNT accounts all via the API without logging into a dashboard. Together these APIs empower you to completely white-label the ShipEngine experience for your end users.

Continue below for instructions on how to programatically connect TNT using the ShipEngine API.

For instructions on connecting TNT via the ShipEngine dashboard, go to our TNT help article.

Property	Description	Type
`username`	Username	string, required
`password`	Password	string, required
`country`	Account Country	string, required
`domestic_account`	Domestic Account Number	string
`international_account`	International Account Number	string

Example POST Call

POST /v1/connections/carriers/TNT

1
2
3
4
5
6
7
8
9
10
11
12
POST /v1/connections/carriers/TNT  HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "username": "TNT_username"
  "password": "pa55word",
  "country": "United Kingdom",
  "domestic_account": "12345",
  "international_account": "6789",
}

Example POST Response

Your account will now appear in your carriers list with an assigned carrier_id that you will specify when creating TNT shipments.

1
2
3
{
  "carrier-id": "se-1234567"
}

TNT Service Details

(Click to open)

Service	Transit Time	Max Dimensions	Max Weight	Service API Codes
EXPRESS Next Day Delivery	Next Day	3.6 x 1.8 x 2.1	2000kgs	`tnt_uk_express`
12:00 EXPRESS	Next Day	2.4 x 1.2 x 1.5	2000 kgs	`tnt_uk_12_express`
10:00 EXPRESS	Next Day	3.6 x 1.8 x 2.1	2000 kgs	`tnt_uk_10_express`
09:00 EXPRESS	Next Day	3.6 x 1.8 x 2.1	2000 kgs	`tnt_uk_9_express`
SATURDAY				`tnt_uk_saturday`
12:00 SATURDAY				`tnt_uk_12_saturday`
10:00 SATURDAY				`tnt_uk_10_saturday`
09:00 SATURDAY				`tnt_uk_9_saturday`
SATURDAY COLLECT MONDAY DELIVER				`tnt_uk_saturday_collect`
12:00 SATURDAY COLLECT MONDAY DELIVER				`tnt_uk_12_saturday_collect`
10:00 SATURDAY COLLECT MONDAY DELIVER				`tnt_uk_10_saturday_collect`
09:00 SATURDAY COLLECT MONDAY DELIVER				`tnt_uk_9_saturday_collect`
ECO EXPRESS		2.4 x 1.2 x 1.8	70kg	`tnt_uk_economy_express`
12:00 ECO EXPRESS		2.4 x 1.2 x 1.5	70kg	`tnt_uk_12_economy_express`
EXPRESS		2.4 x 1.2 x 1.5	500kg	`tnt_uk_international_express`
12:00 EXPRESS		2.4 x 1.2 x 1.5	500kg	`tnt_uk_international_12_express`
10:00 EXPRESS		2.4 x 1.2 x 1.5	210kg	`tnt_uk_international_10_express`
09:00 EXPRESS		2.4 x 1.2 x 1.5	210kg	`tnt_uk_international_9_express`

Packages

Name	API Code	Package Attributes
Default	`tnt_uk_default`	International, Domestic

Return Services

Review the Return Shipping Labels page for details on creating return labels with ShipEngine.

Adding Shipment Insurance

TNT supports adding insurance to your shipments. Review the Parcel Insurance page for details on adding shipment insurance with ShipEngine.

Additional Information

TNT UK does not have a void function. Labels that are created but never shipped expire after one week of inactivity.
Prior to using TNT services, users must complete the ExpressConnect & ExpressLabel Registration form. They can submit the completed form to [email protected] and we will submit the form to TNT on their behalf.

You are now ready to create shipments using TNT via ShipEngine!