Site Logo

🎉 ShipEngine is becoming ShipStation API 🎉

Over the next few months you'll notice the ShipEngine website, documentation portal, and dashboard being rebranded as ShipStation API. For our ShipEngine customers, you don't need to take any action or change any of your integrations in any way. All endpoints will remain the same and continue to function as they always have.

To learn more about what's coming, review our New ShipStation API page.

The Delivery Group UK

The Delivery Group UK offers domestic and international services for shipments originating in the UK.

This guide provides developers with the details needed to build The Delivery Group UK shipping capabilities into your ShipStation API workflows.

Requirements

PropertyTypeRequired?Description
nicknamestringrequiredUsed to identify your account in ShipStation API
client_namestringrequiredYour Delivery Group UK account client name
usernamestringrequiredYour Delivery Group UK account username
passwordstringrequiredYour Delivery Group UK account password

Shipping Requirements

  • All shipments require both weight and dimensions.

Connect Account

You can connect a The Delivery Group UK account using the POST method to the /v1/connections/carriers/ endpoint, or via the ShipStation API Dashboard.

Connect via Endpoint

carrier_name: the_delivery_group_uk

POST /v1/connections/carriers/:carrier_name

Sample request:

1
2
3
4
5
6
7
8
9
10
11
POST /v1/connections/carriers/the_delivery_group_uk HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
"nickname": "My The Delivery Group UK account",
"client_name": "account client name,
"username": "account username",
"password": "pa55word"
}

A successful connection will return a response with the carrier_id, which you'll use for any requests for this account going forward.

Connect via Dashboard

Steps to connect via dashboard coming soon!

Rates

The Delivery Group UK does not currently support rate shopping with ShipStation API. Your account contact can provide you with details about your contracted rates.

Service Details

Available The Delivery Group UK services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.

Domestic Services

ServiceAPI Code
DSA Large Lettertdg_dsa_large_letter
DSA Packettdg_dsa_packet
Utrak No Trackingtdg_utrak_no_tracking
Utraktdg_utrak
Yodel Expect 24hrtdg_yodel_expect_24hr
Yodel Expect 24hr Non PODtdg_yodel_expect_24h_non_pod
Yodel Expect 48hrtdg_yodel_expect_48hr
Yodel Expect 48hr Non PODtdg_yodel_expect_48hr_non_pod
Yodel Expect Medium 24hrtdg_yodel_expect_medium_24hr
Yodel Expect Medium 24hr Non PODtdg_yodel_expect_medium_24hr_non_pod
Yodel Expect Medium 48hrtdg_yodel_expect_medium_48hr
Yodel Expect Medium 48hr Non PODtdg_yodel_expect_medium_48hr_non_pod
Yodel Expect Mini 48hr Non PODtdg_yodel_expect_mini_48hr_non_pod
Yodel Expect Mini 48hrtdg_yodel_expect_mini_48hr
Yodel Expect XLtdg_yodel_expect_xl
Yodel Expect XL Non PODtdg_yodel_expect_xl_nonpod
Yodel Express 24hrtdg_yodel_express_24h
Yodel Express 24hr Non PODtdg_yodel_express_24h_non_pod
Yodel Express 48hrtdg_yodel_express_48h
Yodel Express 48hr Non PODtdg_yodel_express_48h_non_pod
Yodel Express Mini 48hr Non PODtdg_yodel_express_mini_48h_non_pod
Utrak Plustdg_utrak_plus
Yodel Express Mini 24hrtdg_yodel_express_mini_24hr
Yodel Expect Mini 24hrtdg_yodel_expect_mini_24hr
Utrak PODtdg_utrak_pod

International Services

ServiceAPI Code
Etrak Lite (Epak)tdg_etrak_lite_epak
Etrak (Ontrak)tdg_etrak_ontrak
International Untrackedtdg_international_untracked
Yodel Channel Isletdg_yodel_channel_isle
Yodel Channel Isle Non PODtdg_yodel_channel_isle_non_pod

Shipping to Northern Ireland

At this time, The Delivery Group UK has not provided any details about required changes when creating labels for shipment from Great Britain to Northern Ireland as related to the Windsor Framework.

We will provide details about using The Delivery Group UK to ship to Northern Ireland as soon as they are available.

Return Services

The Delivery Group UK does not currently support creating return labels.

Packages

The following carrier package types are available for The Delivery Group UK services:

NameAPI CodePackage Attributes
Packagethe_delivery_group_packageInternational, Domestic

Adding Shipment Insurance

The Delivery Group UK does not support adding carrier insurance to shipments created with ShipStation API.

Label Support

  • Label sizes: 4" x 6"
  • Label formats: PDF, PNG, ZPL
  • Supports unicode characters: yes, for CN22 labels only

Label Reference Fields

The Delivery Group UK supports adding custom label messages for the following services only:

  • Domestic: Utrak No Tracking, Utrak
  • International: Etrak, Etrak Lite, International Untracked

Multi-Package Labels

The Delivery Group UK does not support creating multi-package shipments.

Label Branding

The Delivery Group UK does not support label branding.

Voiding Labels

The Delivery Group UK does not support voiding labels with ShipStation API.

Paperless Labels

The Delivery Group UK does not support paperless labels.

Customs Declarations

Customs declarations print directly on the labels for international shipments.

Delivery Confirmation

Confirmation TypeAPI CodeDescription
No confirmation requirednoneNo delivery confirmation required.

See our Delivery Confirmation page for more details about using the confirmation property.

Advanced Options

The Delivery Group UK supports certain advanced options, which you can add to the shipment object when creating a shipment or label.

OptionTypeDefault ValueDescription
delivered_duty_paidbooleanfalseIndicates the shipment is DDP (that is, the shipper is paying the duties/taxes for the shipment rather than the recipient).
NotificationsEmailstringnullThe carrier will send email tracking notifications to the provided email address.
NotificationsPhonestringnullThe carrier will send SMS tracking notifications to the provided phone number.
saturday_deliverybooleanfalseIndicates that the carrier should charge for delivery on Saturday for services that do not otherwise include saturday delivery.

To ensure you always have the most up-to-date information about a carrier's advanced options, use the list carrier options call.

Manifests

The Delivery Group does not require manifesting your shipments.

Scheduling Pickups

The Delivery Group UK does not support scheduling pickups using ShipStation API.

Service Points (PUDO)

The Delivery Group UK does not support shipping to service points.

Tracking

ShipStation API's integration with The Delivery Group UK supports receiving tracking updates. Review our ​Track a Package guides​​ for details on tracking with the ShipStation API.

Disconnecting Your The Delivery Group UK Account

See the Disconnect section in our Delete a Carrier page for the process of deleting or disconnecting a carrier from ShipStation API.

Troubleshooting Tips

Error: Error received from The Delivery Group API: No services could be found for the specified item attributes and destination. If you need clarification, please call The Delivery Group on 020 7732 2000. If you receive this error, it means your selected service is not available to your Delivery Group UK account. Contact Delivery Group UK to have the service enabled, or choose another service.