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
Property | Type | Required? | Description |
---|---|---|---|
nickname | string | required | A nickname for you to identify the carrier account in ShipStation API. |
username | string | required | Your DPD Local username. |
password | string | required | Your 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:
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
Service | Service API Codes |
---|---|
Parcel DPD Local 12:00 | dpd_local_parcel_dpdlocal_1200 |
Parcel DPD Local 10:30 | dpd_local_parcel_dpdlocal_1030 |
Parcel Saturday | dpd_local_parcel_saturday |
Parcel Saturday 10:30 | dpd_local_parcel_saturday_1030 |
Parcel Saturday 12:00 | dpd_local_parcel_saturday_1200 |
Parcel Sunday | dpd_local_parcel_sunday |
Parcel Sunday 10:30 | dpd_local_parcel_sunday_1030 |
Parcel Sunday 12:00 | dpd_local_parcel_sunday_1200 |
Parcel Two Day | dpd_local_parcel_two_day |
Parcel Next Day | dpd_local_parcel_next_day |
Home Call | dpd_local_home_call |
Expresspak 1 Homecall | dpd_local_expresspak_1_homecall |
Expresspak 1 Next Day | dpd_local_expresspak_1_next_day |
Expresspak 1 DPD Local 12:00 | dpd_local_expresspak_1_1200 |
Expresspak 1 DPD Local 10:30 | dpd_local_expresspak_1_1030 |
Expresspak 1 Saturday 12:00 | dpd_local_expresspak_1_saturday_1200 |
Expresspak 1 Saturday 10:30 | dpd_local_expresspak_1_saturday_1030 |
Expresspak 1 Saturday | dpd_local_expresspak_1_saturday |
Expresspak 1 Sunday | dpd_local_expresspak_1_sunday |
Expresspak 1 Sunday 10:30 | dpd_local_expresspak_1_sunday_1030 |
Expresspak 1 Sunday 12:00 | dpd_local_expresspak_1_sunday_1200 |
Expresspak 5 Homecall | dpd_local_expresspak_5_homecall |
Expresspak 5 Next Day | dpd_local_expresspak_5_next_day |
Expresspak 5 DPD Local 12:00 | dpd_local_expresspak_5_dpdlocal_1200 |
Expresspak 5 DPD Local 10:30 | dpd_local_expresspak_5_dpdlocal_1030 |
Expresspak 5 Saturday 12 | dpd_local_expresspak_5_saturday_1200 |
Expresspak 5 Saturday 10:30 | dpd_local_expresspak_5_saturday_1030 |
Expresspak 5 Saturday | dpd_local_expresspak_5_saturday |
Expresspak 5 Sunday | dpd_local_expresspak_5_sunday |
Expresspak 5 Sunday 10:30 | dpd_local_expresspak_5_sunday_1030 |
Expresspak 5 Sunday 12:00 | dpd_local_expresspak_5_sunday_1200 |
Freight Homecall | dpd_local_freight_homecall |
Freight Next Day | dpd_local_frieght_next_day |
Freight DPD Local 12:00 | dpd_local_freight_dpdlocal_1200 |
Freight DPD Local 10:30 | dpd_local_freight_dpdlocal_1030 |
Freight Saturday 12 | dpd_local_freight_saturday_1200 |
Freight Saturday 10:30 | dpd_local_freight_saturday_1030 |
Freight Saturday | dpd_local_freight_saturday |
Freight Sunday | dpd_local_freight_sunday |
Freight Sunday 10:30 | dpd_local_freight_sunday_1030 |
Freight Sunday 12:00 | dpd_local_freight_sunday_1200 |
Reverse It Two Day | dpd_local_reverse_it_two_day |
Reverse It Next Day | dpd_local_reverse_it_next_day |
Ship to Shop | dpd_local_ship_to_shop |
International Services
Service | Service API Codes |
---|---|
Air Classic | dpd_air_classic |
DPD Air Express | dpd_air_express |
DPD Classic Parcel | dpd_classic_parcel |
DPD Direct | dpd_local_direct |
DPD Two Day - Republic of Ireland | dpd_two_day_republic_of_ireland |
DPD Direct - Republic of Ireland | dpd_direct_roi |
DPD Direct Lite | dpd_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:
Name | API Code | Package Attributes |
---|---|---|
Package | dpd_local_package | Domestic |
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 Type | API Code | Description |
---|---|---|
No confirmation | none | No 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.
Option | Type | Default Value | Description |
---|---|---|---|
bill_to_party | enumerated string | null | Determines 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_paid | boolean | false | Indicates 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.