Although the DHL webservice required a housenumber to be provided as a separate attribute
(street_no) in the past, they are now making it possible to provide streetname and
housenumber in one attribute. So you can specify an address by only transmitting the
street attribute, containing both values. This is also applicable for shipments to a
Packstation or Postfiliale.
Notice: Since DHL has a separate returns webservice, this is only applicable for
outbound shipments and not for returns. There you still have to provide both entries when creating
a shipping label.
Additional delivery details in tracking events
Sometimes DHL provides additional information regarding a delivery that has been made. For example
when the shipments has been handed over to a next door neighbor or has been placed at a drop off
location. In those cases we're returning these additional delivery details as part of the
corresponding tracking event.
{"timestamp":"2013-05-26T16:55:24+02:00","location":"Hamburg, Deutschland","status":"delivered","details":"Die Sendung wurde erfolgreich zugestellt.","delivery_details":{"description":"Wunschort","name":"Wunschort (Ablagevertrag)","addressline1":"St. Annenufer 5","addressline2":"20457 Hamburg"}}
Services
Standard
The most basic service. Normal ground shipping without any modifier to speed up the shipping
time.
Since August 1, 2021 the carrier DHL requires data for a customs declaration to be send, when
creating return shipments from Great Britain.
Requirements:
only applicable for shipments from Great Britain to Germany
you can specify the customs_declaration.currency as either EUR or
GBP
the customs_declaration.contents_type has to be returned_goods
labels can only be provided as DIN A5 pdf
Europaket
The service
DHL Europaket is a great solution for business-to-business parcel shipments,
because shipments within the 32 supported countries will generally be delivered within 48 hours.
"Whether you need to ship glasses, shirts or flip-flops, many products are ultimately too small
to send in a parcel or small package. For frequent shippers,
Warenpost is the perfect, convenient solution - especially if your goods have to reach
customers quickly, reliably and affordably too."
{"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":"cash_on_delivery","properties":{"amount":123.45,"currency":"EUR","bank_account_holder":"Max Mustermann","bank_name":"Musterbank","bank_account_number":"DE12500105170648489890","bank_code":"BENEDEPPYYY","reference1":"reason for transfer"}}],"carrier":"dhl","service":"standard","create_shipping_label":true}
Endorsement
Prior to sending your parcel you can specify what should happen to the shipment in case it cannot
be delivered in the destination country. By choosing the handling option
abandon, your parcel will not be returned to you, but rather auctioned off
or destroyed by the recipient countrys' postal company. You will not be charged with a return fee
for this option. When using the option return_immediately, the shipment will
be returned to you and you will be charged for returning it.
Requirements:
You'll have to use your own DHL contract
Available for international shipments from Germany
The additional service attribute properties.handling can be
abandon or return_immediately
label.format can be pdf_a5, pdf_a6 or
zpl2_103x199mm_203dpi
If you want the carrier to only deliver the shipment to a specific person you can use the DHL ident
check. DHL will ask the recepient to show them a valid ID. Thus you will be able to minimize fraud,
only deliver to persons of a certain age (e.g. when sending alcoholic beverages, adult content or
pharmaceuticals that need a prescription).
Caution:
Please keep in mind that additional fees will be charged by DHL. Check your DHL contract or ask
your DHL Account Manager to get a quote.
Requirements:
You'll have to use your own DHL contract
Your DHL contract must be setup for DHL "Ship" (DHL "Versenden")
The recipient has to be located in Germany
label.format can be pdf_a5 or
zpl2_103x199mm_203dpi
To ensure that a package is only delivered to the recipient you can book the
DHL additional service named
person only.
"The named person only service ensures in an uncomplicated and cost-effective
way that your parcels are only delivered to the recipient in person or to an
authorized person."
Requirements:
service has to be standard or
dhl_prio
label.format can be pdf_a5 or
zpl2_103x199mm_203dpi
The sender has to be located in Germany
The recipient has to be located in Germany
You'll have to use your own contract with the carrier
"By using the
no neighbor delivery service, you can exclude an alternative delivery to the neighbor if your
customer is not available when the delivery is made"
Requirements:
service has to be standard or dhl_prio
The sender has to be located in Germany
The recipient has to be located in Germany
label.format can be pdf_a5,
pdf_103x199mm or zpl2_103x199mm_203dpi
You'll have to use your own contract with the carrier
With the DHL additional service
retail outlet routing you can tell the carrier to reroute a parcel to the nearest outlet when
the recipient can't be reached. Otherwise the parcel will be returned immediately.
Requirements:
service has to be standard or
dhl_warenpost
label.format can be pdf_a5,
pdf_a7, pdf_100x70mm,
zpl2_100x70mm_203dpi or zpl2_103x199mm_203dpi
Let the carrier inform the recipient about the redirection by providing their email address
Either the sender or the recipient has to be located in Germany
You'll have to use your own contract with the carrier
{"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":"drop_authorization","properties":{"message":"Description about where the package should be left"}}],"label":{"format":"pdf_a5"},"carrier":"dhl","service":"standard","create_shipping_label":true}
Preferred neighbor
By using the additional service
preferred neighbor you can specify the delivery to be made at one of your close neighbors in
cases when you're not at home.
Requirements:
service has to be standard, dhl_prio or
dhl_warenpost
The sender has to be located in Germany
The recipient has to be located in Germany
You'll have to use your own contract with the carrier
{"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":"dhl_preferred_neighbor","properties":{"message":"Name of the neighbor to whom the package is to be delivered"}}],"label":{"format":"pdf_a5"},"carrier":"dhl","service":"standard","create_shipping_label":true}
Premium International
Using the additional service DHL premium international you can reduce international shipping
transit times.
Requirements:
You'll have to use your own DHL contract
Your DHL contract must be setup for DHL "Ship" (DHL "Versenden")
When sending goods that are only legally available for people of a specific age, you can request
the carrier to check the receiver's age visually. Just add the additional service
visual_age_check and either 16 or 18 as
its minimum_age value.
Requirements:
You need to use your own DHL Ship contract
The recipient has to be located in Germany
label.format can be pdf_a5 or
zpl2_103x199mm_203dpi
If you want to send a shipment to a country where a customs declaration is necessary you can specify
this the following way. Detailed information about the parameters can be found in our
documentation of creating a shipment.
If you are providing return shipments from Great Britain please also read our information about
returns from GB.
Requirements:
customs_declaration.currency has to be EUR
customs_declaration.additional_fees is mandatory (since Feb. 19 2021)
If you want to enable your customers to reduce their carbon footprint or they do not own a
printer, you can provide them with a QR code they can then show at their DHL station to get a
returns label.
Notice:
When creating a QR code you will also always receive a normal returns label.
A tracker can be used for tracking shipments that were created using a tool outside of shipcloud.
This way you can get notified of shipment changes, even if your shipping label has been created
somewhere else.