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 Local

DPD Local specializes in the delivery of time-critical shipments originating from the UK. DPD Local supports the courier's local services for domestic shipments, ground services for shipments to Europe, and air services for delivery to international destinations.

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

Requirements

PropertyTypeRequired?Description
nicknamestringrequiredA nickname for you to identify the carrier account in ShipStation API.
usernamestringrequiredYour DPD Local username.
passwordstringrequiredYour DPD Local account password.

Connection Requirements

You MUST reset the password from your temporary login credentials to a permanent one before you connect to ShipStation API. If not, you will receive an error when trying to connect your account.

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.
  • DPD Local requires the EORI number and not the VAT number for label creation.
  • DPD Local restricts the export of certain items to the EU. Review the PDF that lists items not accepted for EU export by DPDgroup.

Connect Account

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

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

Connect via Endpoint

carrier_name: apicode-dpd-local

POST /v1/connections/carriers/:carrier_name

Sample request:

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

ServiceService API Codes
Parcel DPD Local 12:00dpd_local_parcel_dpdlocal_1200
Parcel DPD Local 10:30dpd_local_parcel_dpdlocal_1030
Parcel Saturdaydpd_local_parcel_saturday
Parcel Saturday 10:30dpd_local_parcel_saturday_1030
Parcel Saturday 12:00dpd_local_parcel_saturday_1200
Parcel Sundaydpd_local_parcel_sunday
Parcel Sunday 10:30dpd_local_parcel_sunday_1030
Parcel Sunday 12:00dpd_local_parcel_sunday_1200
Parcel Two Daydpd_local_parcel_two_day
Parcel Next Daydpd_local_parcel_next_day
Home Calldpd_local_home_call
Expresspak 1 Homecalldpd_local_expresspak_1_homecall
Expresspak 1 Next Daydpd_local_expresspak_1_next_day
Expresspak 1 DPD Local 12:00dpd_local_expresspak_1_1200
Expresspak 1 DPD Local 10:30dpd_local_expresspak_1_1030
Expresspak 1 Saturday 12:00dpd_local_expresspak_1_saturday_1200
Expresspak 1 Saturday 10:30dpd_local_expresspak_1_saturday_1030
Expresspak 1 Saturdaydpd_local_expresspak_1_saturday
Expresspak 1 Sundaydpd_local_expresspak_1_sunday
Expresspak 1 Sunday 10:30dpd_local_expresspak_1_sunday_1030
Expresspak 1 Sunday 12:00dpd_local_expresspak_1_sunday_1200
Expresspak 5 Homecalldpd_local_expresspak_5_homecall
Expresspak 5 Next Daydpd_local_expresspak_5_next_day
Expresspak 5 DPD Local 12:00dpd_local_expresspak_5_dpdlocal_1200
Expresspak 5 DPD Local 10:30dpd_local_expresspak_5_dpdlocal_1030
Expresspak 5 Saturday 12dpd_local_expresspak_5_saturday_1200
Expresspak 5 Saturday 10:30dpd_local_expresspak_5_saturday_1030
Expresspak 5 Saturdaydpd_local_expresspak_5_saturday
Expresspak 5 Sundaydpd_local_expresspak_5_sunday
Expresspak 5 Sunday 10:30dpd_local_expresspak_5_sunday_1030
Expresspak 5 Sunday 12:00dpd_local_expresspak_5_sunday_1200
Freight Homecalldpd_local_freight_homecall
Freight Next Daydpd_local_frieght_next_day
Freight DPD Local 12:00dpd_local_freight_dpdlocal_1200
Freight DPD Local 10:30dpd_local_freight_dpdlocal_1030
Freight Saturday 12dpd_local_freight_saturday_1200
Freight Saturday 10:30dpd_local_freight_saturday_1030
Freight Saturdaydpd_local_freight_saturday
Freight Sundaydpd_local_freight_sunday
Freight Sunday 10:30dpd_local_freight_sunday_1030
Freight Sunday 12:00dpd_local_freight_sunday_1200
Reverse It Two Daydpd_local_reverse_it_two_day
Reverse It Next Daydpd_local_reverse_it_next_day
Ship to Shopdpd_local_ship_to_shop

International Services

ServiceService API Codes
Air Classicdpd_air_classic
DPD Air Expressdpd_air_express
DPD Classic Parceldpd_classic_parcel
DPD Directdpd_local_direct
DPD Two Day - Republic of Irelanddpd_two_day_republic_of_ireland
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 Local supports creating return labels using their domestic services.

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

Packages

DPD Local supports the following carrier package types:

NameAPI CodePackage Attributes
Packagedpd_local_packageDomestic

You can also use the generic package type or custom package types.

Adding Shipment Insurance

DPD Local does not support adding carrier insurance to your shipments, but you can cover your DPD Local 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 4"

  • Label formats: PDF

    DPD Local returns 4" x 4" labels, but these can be printed in 4x4 (105mm x 102mm) or 4x6 (105mm x 152mm) labels.

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 and DPD Direct Lite.

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

Label Branding

DPD Local 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

DPD Label does not support paperless labels at this time.

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 Local 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.
Available values: recipient, third_party
delivered_duty_paidbooleanfalseIndicates the shipment is DDP (that is, the shipper is paying the duties/taxes for the shipment rather than the recipient).

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 Local does not support shipping to service points.

Tracking

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

Disconnecting Your DPD Local Account

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