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.

DPD UK Guide

DPD is one of the UK's leading parcel delivery companies offering domestic and international shipping solutions for shipments originating in the UK.

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

If you are using or plan to use the DPD services included with ShipStation API, rather than connecting your own DPD UK account, see our DPD from ShipStation guide.

Requirements

PropertyTypeRequired?Description
nicknamestringrequiredA nickname for you to identify the carrier account in ShipStation API.
account_numberstringrequiredThis corresponds to User Login ID (username) in DPD.
passwordstringrequiredThis is your DPD password.

Shipping Requirements

  • Before you can create live DPD labels with ShipStation API, you must contact your DPD account manager and let them know you intend to use ShipStation API and for instructions to create test labels.
  • DPD must approve your test labels. Failure to get approval before you start shipping DPD parcels through ShipStation API could result in your account being suspended.

Connect Account

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

For instructions on connecting DPD via the ShipStation API dashboard, go to our DPD help article.

Connect via Endpoint

carrier_name: dpd

POST /v1/connections/carriers/:carrier_name

Sample request:

1
2
3
4
5
6
7
8
9
10
POST /v1/connections/carriers/dpd HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
"nickname": "My DPD Account",
"account_number": "123456789",
"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.

Rates

DPD UK does not send estimated rates to ShipStation API, as they do not currently provide a Rates API. Your DPD account contact can provide you with the details about your contracted rates.

Service Details

Available DPD 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
Parcel Sundayparcel_sunday
Freight Parcel Sundayfreight_parcel_sunday
Pallet Sundaypallet_sunday
Expresspak Sundayexpresspak_sunday
DPD Two Daydpd_two_day
DPD Next Daydpd_next_day
DPD 12:00dpd_1200
DPD 10:30dpd_1030
Parcel Saturdayparcel_saturday
Parcel Saturday 12:00parcel_saturday_1200
Parcel Saturday 10:30parcel_saturday_1030
Parcel Sunday 12:00parcel_sunday_1200
Parcel Sunday 10:30dpd_parcel_sunday_1030
Freight Parcel Sunday 12:00freight_parcel_sunday_1200
Expresspak DPD Next Dayexpresspak_dpd_next_day
Expresspak DPD 12:00expresspak_dpd_1200
Expresspak DPD 10:30expresspak_dpd_1030
Expresspak Saturdayexpresspak_saturday
Expresspak Saturday 12:00expresspak_saturday_1200
Expresspak Saturday 10:30expresspak_saturday_1030
Expresspak Sunday 12:00expresspak_sunday_1200
Pallet Sunday 12:00pallet_sunday_1200
Pallet DPD Two Daypallet_dpd_two_day
Pallet DPD Next Daypallet_dpd_next_day
Pallet DPD 12:00pallet_dpd_1200
Pallet DPD 10:30pallet_dpd_1030
Pallet Saturdaypallet_saturday
Pallet Saturday 12:00pallet_saturday_1200
Pallet Saturday 10:30pallet_saturday_1030
Freight Parcel DPD Two Dayfreight_parcel_dpd_two_day
Freight Parcel DPD Next Dayfreight_parcel_dpd_next_day
Freight Parcel DPD 12:00freight_parcel_dpd_1200
Freight DPD 10:30freight_dpd_1030
Freight Parcel Saturdayfreight_parcel_saturday
Freight Parcel Saturday 12:00freight_parcel_saturday_1200
Freight Parcel Saturday 10:30freight_parcel_saturday_1030
Parcel Ship to Shopparcel_ship_to_shop

International Services

ServiceAPI Codes
Air Express (3 to 5 days)air_express
Air Classic (4 to 7 days)air_classic
DPD Classicdpd_classic
DPD Two Day - Republic of Irelanddpd_two_day_republic_of_ireland
DPD Classic Expresspakdpd_classic_expresspak
DPD Directdpd_direct
DPD Direct - Republic of Irelanddpd_direct_roi
DPD Direct Litedpd_direct_lite

DPD Services and IOSS

Some DPD services require an Import One-Stop Shop (IOSS) number when shipping to specific countries. You must include your IOSS number in the Tax Identifiers Object of your Create Label requests when using the below services.

  • DPD Direct requires an IOSS number for all B2C parcels to Europe with a value less than €150.
  • Countries where you can send B2C parcels with a value less than €150 without an IOSS registration number: Austria, France, Germany, Ireland, Italy, Netherlands, and Spain.

Shipping to Northern Ireland

DPD supports all movement types for shipping from Great Britain to Northern Ireland, in accordance with the Windsor Framework.

advanced_options.windsor_framework_details.movement_indicator property can have the following values: c2c, b2c, c2b, or b2b.

For C2C, B2C, and C2B shipments: customs data is not mandatory but will be mapped if provided. Otherwise it will be left blank.

For B2B shipments:

  • You must declare whether the shipment is "at risk" of entering Northern Ireland using the not_at_risk boolean property.
  • If not_at_risk = true you must provide the following details for your shipment:
    • Sender UKIMS Number OR Recipient UKIMS Number OR Customs Importer UKIMS Number
    • Recipient EORI Number OR Customs Importer EORI Number
    • Parcel Value
    • Parcel Currency
    • Product description
    • Product Unit Value
    • Product Item Origin
    • Product Unit Weight
    • Product Quantity
  • If not_at_risk = false you must provide the following details for your shipment:
    • Recipient EORI Number OR Customs Importer EORI Number
    • Parcel Value
    • Parcel Currency
    • Product description
    • Product Unit Value
    • Product Item Origin
    • Product Unit Weight
    • Product Quantity
    • Product Harmonization Code

Return Services

DPD UK supports returns using any of their domestic services.

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

Packages

DPD does not include specific carrier package types. You can use the generic package type or custom package types.

Adding Shipment Insurance

Carrier insurance is not supported by our DPD integration, but you can cover your DPD shipments with our third-party insurance partner.

Review the Parcel Insurance page for details on adding shipment insurance with ShipStation API.

Label Support

  • Label sizes: 4" x 6"
  • Label formats: PDF

Label Reference Fields

DPD does not support adding custom label messages.

Multi-Package Labels

Most DPD UK services support creating multi-package labels, with the exception of "Expresspak" services, Parcel Sunday 10:30 and DPD Direct Lite.

See our Multi-Package Shipping page for details about creating multi-package labels.

Label Branding

DPD does not support label branding.

Voiding Labels

DPD does not support voiding labels with ShipStation API as they do not have a void label endpoint. If you need to void a DPD label, you must do so in your DPD account.

Paperless Labels

Currently, only the Pacel Shop to Shop service supports paperless/QR code labels.

See our Paperless Labels page for details about creating paperless labels with ShipStation API.

Customs Declarations

Customs declarations are submitted to DPD electronically. No forms will be returned in the request response.

Delivery Confirmation

Confirmation TypeAPI CodeDescription
No confirmationnoneNo delivery confirmation requested.

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

Advanced Options

DPD supports certain advanced options, which you can add to the shipment object when creating a shipment or label.

OptionTypeDefault ValueDescription
bill_to_partyenumerated stringnullDetermines which party is paying for shipping costs. This field must be used in conjunction with the bill_to_country_code, bill_to_postal_code, and bill_to_account fields.
Values: recipient or third_party
delivery_duty_paidbooleanfalseBill the duties and taxes to the payor of the shipping charges (DDP).
non_machinablebooleanfalseIndicates that the package cannot be processed through sorting machines.

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

Manifests

DPD does not require manifesting their shipments.

Scheduling Pickups

DPD does not support scheduling pickups.

Service Points (PUDO)

DPD UK supports dropping off and shipping to service points with ShipStation API.

Tracking

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

Disconnecting Your DPD Account

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