Let's take a look on how to connect MyDHL in just a few steps! ✨
To proceed with the connection you'll need to have a Username (which is actually an API Key - ⚠ not an email address!), a Password (which is actually an API Secret), and an Account Number that you can retrieve by following these steps:
Register at this DHL website page
Once done, fill this form
📌 Please keep in mind that at the point "How would you like to use the API?" inside DHL registration page, you should select the option "I require credentials to DHL Express – MyDHL API for an existing plugin/ecommerce platform/third-party solution" and simply add ShippyPro.
Concerning the section called Requested Services, please tick over all the services available.
Finally, the field named "Transaction volume per month" it's only useful to DHL for statistics purposes, therefore it won't influence you on the use of the API.
After about 3 to 4 hours you can check your DHL Developer profile and you should be able to see: App Status: approved
4. Click on DHL EXPRESS - MYDHL API under App Name then you will find a red button called Request Production Access, you will receive confirmation after few minutes.
5. Enter API key as Username and API Secret as Password into MyDHL connection from Carriers > Connection > Click on MyDHL Logo.
Pick then your Label Type:
And your Product Code between:
ECONOMY SELECT NONDOC (ESI)
EXPRESS 9:00 DOC (TDK)
EXPRESS 9:00 NONDOC (TDE)
EXPRESS 10:30 DOC (TDL)
EXPRESS 10:30 NONDOC (TDM)
EXPRESS 12:00 DOC (TDT)
EXPRESS 12:00 NONDOC (TDY)
EXPRESS DOMESTIC (DOM)
EXPRESS DOMESTIC 9:00 (DOK)
EXPRESS DOMESTIC 10:30 (DOL)
EXPRESS DOMESTIC 12:00 (DOT)
ECONOMY SELECT DOMESTIC (DES)
EXPRESS WORLDWIDE DOC (DOX)
EXPRESS WORLDWIDE NONDOC (WPX)
EXPRESS WORLDWIDE EU (ECX)
FREIGHT WORLDWIDE (FRT)
ECONOMY SELECT EU (ESU)
EXPRESS ENVELOPE DOC (XPD)
MEDICAL EXPRESS DOC (CMX)
MEDICAL EXPRESS NONDOC (WMX)
EXPRESS JUMBO (WPX)
SAME DAY (SDX)
📌If you'd like to add multiple services you'll need to create a new connection for each one.
⚠️Ask you DHL Account Manager what are your active Product Codes.
6. DHL Inbound Account Number
This field is not mandatory. Enter your Inbound Account Number only if you manage also inbound shipments.
If you'd like to print your Return Labels together with the shipping label, you'll need to tick Print Return Label box and insert your DHL Return Account Number as well. This will allow you to create inbound shipments.
💡Note: Please note that the label format will be the one you chose for outbound shipments. It cannot be changed for return labels.
Other options ✏️
You can also decide to enable Paperless documentation option (Paperless Trade) or automatically print your commercial invoices for international shipments by simply enabling their dedicated options.
Indeed, you have 2 options to transmit invoices to myDHL:
1. Enable Paperless Trade and don't upload invoice via ETD
2. Disable Paperless Trade option and send invoices via ETD
By selecting the option Print Commercial Invoice you won't have to enable the check box in modal if you are going to use ETD.
By selecting the Data Staging Environment option, you will be able to extend the duration of a label without knowing the actual date of handling to the Courier.
Enable the Test Mode if you'd like to make some test shipments.
⚠️ The "Test Mode" option should be flagged only if you have test credentials, not production credentials!
If you want, you can also enter a Custom Label to recognize the connection among all the others.
How can I create myDHL returns? 📦
First of all, access to Carriers > Connection > Edit (if you already connected it).
Then pay attention to the following steps:
1. If you’d like to print both Shipping and Return Label for a Return in the box, and so in one time, add your DHL Return Account Number in DHL Account Number field and your Account Number in the DHL Return Account Number field.
Then tick Print Return label option on the bottom and Confirm.
2. If you’d like to make Returns separately from the main shipment, you need to create a new myDHL connection with the following configuration:
Add your Return Account Number in the Account Number field and your Account Number in the DHL Return Account Number field.
So basically as the exact opposite of the first set up.
Then you can create your Manual Shipment for the Return. Click below to learn how!
Now you’ll be able to both make Return In The Box and Return Labels directly with a single solution! 🎈
Errors troubleshooting 👾
Have you experienced any of the errors below? Keep reading to discover how to fix them!
7008: The requested Special Service Code #/valueAddedServices/0/serviceCode ‘WY’ is not available between this origin and destination. Please validate the products and services combination (via the /rates or /products service) or contact our customer service.
This error appears whenever you enable Paperless option for a non-dutiable shipment (as for example a national or inside EU shipment).
Error Da rielaborare: #/customerReferences/0: required key [value] not found, #/outputImageProperties/customerBarcodes/0: required key [content] not found
In this case please make sure to have correctly added the order ID as it's considered as mandatory info for the Carrier.
Da rielaborare: 1001: The requested product(s) (P) not available based on your search criteria.(409224511)
The indicated destination city is invalid:
eg. "cityName": "NA"
You can check the postcodes and locations accepted by myDHL system at this link: https://dct.dhl.com/
410138: Requested product(s) not available at payer, H/-
The Product Code (meaning the DHL service) is wrong. Please check it with your DHL representative and select the correct one.