The DHL eCommerce UK courier connection integrates with the Parcel UK API from DHL's eCommerce division. This connection replaces the previously used DHL Parcel and UK Mail connections.
Note: DHL Parcel UK has been rebranded to DHL eCommerce UK.
Features
The service provides:
Parcel UK shipping and tracking.
Domestic pick up (UK).
Domestic (UK) and international delivery.
Prerequisites
Obtain credentials
Contact your DHL Account Manager to acquire the following credentials:
DHL Account Type.
DHL Pickup Account Number.
DHL Client ID.
DHL Client Secret.
Add roles and permissions
If you cannot access the DHL eCommerce UK page in Mintsoft, check you have the relevant permissions:
Click Settings then Warehouse User Accounts.
Find the user requiring access.
Click Actions then Manage Roles.
Expand the Group-Connect role group.
Select the Connect-DHLeCommerceUK sub-role group.
Click Update.
Note: These steps resolve 'Unauthorised' messages when accessing the DHL eCommerce UK page in Mintsoft.
Set up the DHL eCommerce UK connection
Once you have credentials from your DHL Account Manager, configure the connection in Mintsoft:
Click Connect then Courier Integrations.
Click DHL eCommerce UK then Add Account.
(3PL only) Select the Client.
Select the Warehouse or leave as ALL.
Set your Account Type.
Enter your DHL Pickup Account number.
Select your preferred Label Format.
Enter your DHL Client ID and DHL Client Secret.
(Optional) Enable Tracking Events.
This requires the Tracking Events module, which is a paid add-on.
Click Add.
Add new courier services
Retrieve service codes
Click Connect then Courier Integrations.
Click DHL eCommerce UK then click Get Services against the connection.
The generated text contains the codes required to add new courier services.
You need the following information:
productNameForUI - The name of the service.
accountType - Identifies the Account Type:
ukDomestic: Enter DOMESTIC in Mintsoft.
internationalAir: Enter AIR in Mintsoft.
internationalRoad: Enter ROAD in Mintsoft.
productCode - The code of the courier service.
Add courier service codes
Click Shipping Management then Extras.
Click Courier Service Codes then Add New Courier Service Code.
Select DHL eCommerce UK as the Courier.
Enter the accountType into Extra Code 2.
Enter the productNameForUI into the Description field.
Enter the productCode into the Code field.
(Optional) Add additional enhancements in the ExtraCode fields using the Mapping Spreadsheet for reference.
Click Create.
Configure courier services
Click Shipping Management then Couriers.
Click ManageCourierServices next to your DHL eCommerce UK courier.
Use the CourierServiceType drop-down to select a type (usually Standard or Express).
Enter the productNameForUI in the Name field (can be renamed if needed).
Enter the Tracking URL.
If applicable, enter a Fuel Surcharge as a percentage (enter 0 if not applicable).
Switch Active to ON.
Click Add.
Map courier services
Click Shipping Management then Extras.
Click Courier Service Code Mappings then Add New Courier Service Code Mapping.
Find the courier service you added in the CourierServiceId dropdown.
Find the courier service code you added in the CourierServiceCodeId dropdown (search by product name).
Click Map.
Repeat for additional services.
Example service codes
Below is an example of courier service codes returned when clicking Get Services:
{"productCode":"200","productName":"Worldwide Air","productNameForUI":"Worldwide Air","shipmentType":"international","sortOrder":1,"dimensionsMandatory":true,"accountType":"internationalAir","shipmentIdentifierType":"Parcel UK","labelType":"express-uk","labelProductName":"WorldwideWhen entering courier service codes:
Code: 200
Description: Worldwide Air
Extra Code 2: AIR
FAQ
Error when generating shipment
If you receive the error (ErrorException Occurred: The UserName field is required. The AuthenticationToken field is required. The AccountNumber field is required. The CollectionDate field is required. The ClosedForLunch field is required. The EarliestTime field is required. The LatestTime field is required) when generating a shipment for DHL Parcel UK, ensure you have migrated your account to DHL eCommerce UK using the method described above.