DHL Express @ shipcloud

Carrier specifics

Requirements

These global requirements apply to every call when using the carrier DHL Express:

supplying a pickup request at creation time of the shipment is mandatory, if you don't have regular pickups
the date for pickup_time.earliest and pickup_time.latest has to be the same
supplying a pickup_address is optional
supplying a description for the shipment (not as part of the package) is mandatory
supplying phone is mandatory for sender and recipient addresses
state has to be 2 characters long

Services

Economy select

The DHL Express service economy select provides you with a "door-to-door delivery within Europe via the DHL Express Road Network on a specific day".

Additional requirements (see global requirements):

Only available for international shipments within Europe
Maximum dimensions (l/w/h): 120 x 80 x 80cm
service has to be dhl_express_economy_select

Show example

POST https://api.shipcloud.io/v1/shipments

{
  "from": {
    "first_name": "Serge",
    "last_name": "Sender",
    "company": "Sender Corp.",
    "street": "Sender Str.",
    "street_no": "99",
    "zip_code": "20148",
    "city": "Hamburg",
    "state": "HH",
    "country": "DE",
    "phone": "040 12341234"
  },
  "to": {
    "first_name": "Roger",
    "last_name": "Receiver",
    "street": "Receiver Str.",
    "street_no": "1",
    "city": "Hamburg",
    "state": "HH",
    "zip_code": "20535",
    "country": "DE",
    "phone": "040 12341234"
  },
  "package": {
      "weight": 1.5,
      "length": 20,
      "width": 20,
      "height": 20
  },
  "pickup": {
    "pickup_time": {
      "earliest": "2015-09-15T09:00:00+02:00",
      "latest": "2015-09-15T18:00:00+02:00"
    },
    "pickup_address": {
      "company": "Sender Ltd.",
      "first_name": "Jane",
      "last_name": "Doe",
      "street": "Musterstraße",
      "street_no": "42",
      "zip_code": "54321",
      "city": "Musterstadt",
      "country": "DE"
     }
  },
  "description": "Not so important goods. Take your time.",
  "carrier": "dhl_express",
  "service": "dhl_express_economy_select",
  "create_shipping_label": true
}

One day

Express shipment that will be delivered the next working day

Additional requirements (see global requirements):

service has to be one_day

Show example

POST https://api.shipcloud.io/v1/shipments

{
  "from": {
    "first_name": "Serge",
    "last_name": "Sender",
    "company": "Sender Corp.",
    "street": "Sender Str.",
    "street_no": "99",
    "zip_code": "20148",
    "city": "Hamburg",
    "state": "HH",
    "country": "DE",
    "phone": "040 12341234"
  },
  "to": {
    "first_name": "Roger",
    "last_name": "Receiver",
    "street": "Receiver Str.",
    "street_no": "1",
    "city": "Hamburg",
    "state": "HH",
    "zip_code": "20535",
    "country": "DE",
    "phone": "040 12341234"
  },
  "package": {
      "weight": 1.5,
      "length": 20,
      "width": 20,
      "height": 20
  },
  "pickup": {
    "pickup_time": {
      "earliest": "2015-09-15T09:00:00+02:00",
      "latest": "2015-09-15T18:00:00+02:00"
    },
    "pickup_address": {
      "company": "Sender Ltd.",
      "first_name": "Jane",
      "last_name": "Doe",
      "street": "Musterstraße",
      "street_no": "42",
      "zip_code": "54321",
      "city": "Musterstadt",
      "country": "DE"
     }
  },
  "description": "Important goods that need to be delivered fast!",
  "carrier": "dhl_express",
  "service": "one_day",
  "create_shipping_label": true
}

One day early

Express shipment that will be delivered the next working day before noon

Additional requirements (see global requirements):

service has to be one_day_early

Show example

POST https://api.shipcloud.io/v1/shipments

{
  "from": {
    "first_name": "Serge",
    "last_name": "Sender",
    "company": "Sender Corp.",
    "street": "Sender Str.",
    "street_no": "99",
    "zip_code": "20148",
    "city": "Hamburg",
    "state": "HH",
    "country": "DE",
    "phone": "040 12341234"
  },
  "to": {
    "first_name": "Roger",
    "last_name": "Receiver",
    "street": "Receiver Str.",
    "street_no": "1",
    "city": "Hamburg",
    "state": "HH",
    "zip_code": "20535",
    "country": "DE",
    "phone": "040 12341234"
  },
  "package": {
      "weight": 1.5,
      "length": 20,
      "width": 20,
      "height": 20
  },
  "pickup": {
    "pickup_time": {
      "earliest": "2015-09-15T09:00:00+02:00",
      "latest": "2015-09-15T18:00:00+02:00"
    },
    "pickup_address": {
      "company": "Sender Ltd.",
      "first_name": "Jane",
      "last_name": "Doe",
      "street": "Musterstraße",
      "street_no": "42",
      "zip_code": "54321",
      "city": "Musterstadt",
      "country": "DE"
     }
  },
  "description": "Important goods that need to be delivered fast!",
  "carrier": "dhl_express",
  "service": "one_day_early",
  "create_shipping_label": true
}

Package types

Parcel

The only package_type available for DHL Express is parcel

Additional services

Saturday delivery

When sending packages on a Friday you can specify that they should be delivered on Saturday (if the carrier supports this).

Requirements:

service has to be one_day or one_day_early
you'll have to use your own contract with the carrier

Show example

POST https://api.shipcloud.io/v1/shipments

{
  "from": {
    "first_name": "Serge",
    "last_name": "Sender",
    "company": "Sender Corp.",
    "street": "Sender Str.",
    "street_no": "99",
    "zip_code": "20148",
    "city": "Hamburg",
    "country": "DE"
  },
  "to": {
    "first_name": "Roger",
    "last_name": "Receiver",
    "street": "Receiver Str.",
    "street_no": "1",
    "city": "Hamburg",
    "zip_code": "20535",
    "country": "DE"
  },
  "package": {
    "weight": 0.5,
    "length": 20,
    "width": 15,
    "height": 5,
    "type": "parcel"
  },
  "additional_services": [
    {
      "name": "saturday_delivery"
    }
  ],
  "carrier": "dhl_express",
  "service": "one_day",
  "create_shipping_label": true
}

Label formats

PDF

DIN A5: pdf_a5
DIN A6: pdf_a6

Field lengths

shipments
- company: 2 - 35 characters
- last_name: 1 - 45 characters (firstname + last_name <= 45 characters)
- care_of: 0 - 35 characters
- street: 1 - 35 characters (street + street_no <= 35 characters)
- street_no: 0 - 15 characters
- zip_code: 1 - 12 characters
- city: 1 - 35 characters
- state: 2 characters (for US only)
- country: 2 characters
- phone: 1 - 25 characters
- description: 1 - 35 characters

DHL Express Rate Book

Carrier specifics

Requirements

Services

Economy select

One day

One day early

Package types

Parcel

Additional services

Saturday delivery

Label formats

PDF

Field lengths

shipments