The current DHL Express connection is approaching end-of-life and will cease to be supported by DHL. It must therefore be replaced by a new connection. This will affect the following products:
- nShift TMS
- Web-TA (including Web-TA single carrier)
- Memnon Apport
This article will explain what you need to do to ensure that your DHL Express connection will keep working:
- Introduction
- Create new Transport Agreements
- Consignment templates
- Summary of changes, products and services
Introduction
The new connection will be built towards DHL’s new MyDHL API, which will over time give access to a wider range of DHL services and add-ons, as well as secure compatibility with future changes. The first scope of the new connection is to cover all services and add-ons currently supported.
The new connection will be built as a new transport product in the nShift products listed above, and you, as a customer will have to start using this transport product instead of the current DHL Express product.
Exactly what you need to change depends on your current set-up, but you will typically have to enter your DHL customer number in the account settings on the new product and update all templates you have for DHL Express. See the sections about Transport Agreements and templates below.
If you have an integration with nShift and you are using DHL Express-specific references in your input data, you will have to update your integration to reference the new transport product. If you are using a reference to a template, it will in most cases be enough just to change the transport product in the template, and you will not have to update your integration.
Our customer support is available to answer any questions you may have about this change.
|
Phone: +46 (0)8 729 88 50 E-mail: customerservice@nshift.com |
Create new Transport Agreements
You must create new Transport Agreements for the new transport services. You can use the same customer numbers as before.
Check your current agreements and customer numbers and create new ones based on the old agreements. Apply the MyDHL Express Global transport service.
For more information on how to create a new Transport Agreement, click here.
Consignment Templates
Update your current or create new Consignment Templates, with the new transport services. A new template can be created based on an existing template by copying a current template.
- Under Consignment templates, find your current template. You can use the search field.
- Check the existing template and click Copy.
- Click Confirm.
- Click the Edit button next to the new template.
- Scroll down and change the transport service to MyDHL Express Global.
- Dimensions are mandatory, so Show length, width and height must be enabled.
-
Combiterm can be pre-selected in the template in the Freight Payer section.
- Click Save.
For more information on how to create templates, click here.
Summary of changes, products and services
| Differences for TMS users between the new MyDHL API and the old DHL Express XMLPI |
| Incoterms mandatory for all products |
| Pickup location add service moved, new field in GUI and integration. Carry Out assigned location: CARRYOUT_ASSIGNED_LOCATION |
| For integration customers; both goodsValue and valueOfGoods can be used for additional service Goods Value. |
| Dimensions (lenght, width and height) are mandatory in MyDHL, it was not mandatory previously in XMLPI |
| Pick up times are mandatory if Pickup request is sent. Earliest pick up time must be in the future. Pick up was defaulted to 08:00 - 16:00 in the old XMLPI set-up |
| New transport service codes and add-service codes for integrations users. If set in integration by using templates, only changes to templates needed. GUI users are not affected. |
| Consignee reference is now mapped to DHL via MyDHL. The field did not exist previously in XMLPI |
| Consignor and pickup address must be in the same country |
| Customs/VAT account must be provided on dutiable shipments with combiterm DDP |
| MyDHL Express Global | Obsolete XMLPI codes | New MyDHL codes |
| Express Worldwide (Dutiable) | dhlxmlpi_wpx | mydhl_wpx |
| Express Worldwide (EU) | dhlxmlpi_ecx | mydhl_ecx |
| Express Worldwide (Non EU) | dhlxmlpi_dox | mydhl_dox |
| Express 9:00 | dhlxmlpi_tdk | mydhl_tdk |
| Express 9:00 (Dutiable) | dhlxmlpi_tde | mydhl_tde |
| Domestic Express | dhlxmlpi_dom | mydhl_dom |
| Domestic Express 09:00 | dhlxmlpi_dok | mydhl_dok |
| Domestic Express 12:00 | dhlxmlpi_dot | mydhl_dot |
| Economy Select | dhlxmlpi_esu | mydhl_esu |
| Economy Select (Dutiable) | dhlxmlpi_esi | mydhl_esi |
| Express 10:30 | dhlxmlpi_tdl | mydhl_tdl |
| Express 10:30 (Dutiable) | dhlxmlpi_tdm | mydhl_tdm |
| Express 12:00 | dhlxmlpi_tdt | mydhl_tdt |
| Express 12:00 (Dutiable) | dhlxmlpi_tdy | mydhl_tdy |
| Express Envelope | dhlxmlpi_xpd | mydhl_xpd |
| MyDHL add service codes | MyDHL add service names |
| SATURDAY_DELIVERY | Saturday Delivery |
| CLIMATE_COMPENSATION | Climate compensation |
| INSURANCE | Insurance |
| NEUTRALIZE | Neutral delivery |
| CARRYOUT_ASSIGNED_LOCATION | Carry Out assigned location |
| VALUE_OF_GOODS | Goods Value |
| Incoterm name | Incoterm Code used in integrations |
| DPU - Delivered at Place Unloaded | DPU |
| EXW - Ex works | EXW |
| FCA - Free Carrier | FCA |
| FAS - Free Alongside Ship | FAS |
| FOB - Free On Board | FOB |
| CFR - Cost and Freight | CFR |
| CIF - Cost, Insurance and Freight | CIF |
| CPT - Carriage Paid To | CPT |
| CIP - Carriage and Insurance Paid to | CIP |
| DAT - Delivered At Terminal | DAT |
| DAP - Delivered At Place | DAP |
| DDP - Delivered Duty Paid | DDP |
| Package type name | Package type code for integration |
| Customer provided | CP |
| Envelope | EE |
| Other DHL Packaging | OD |
| DHL Flyer | DF |