Carrier - DHL eCommerce US Troubleshooting

Overview

If you are receiving error messages related to DHL eCommerce US, the article provides the troubleshooting tips to help you resolve the issue.

data.tracking_number does not exist, the label can not not be canceled

What it means

This error message indicates that the system cannot find the tracking number associated with the label you are trying to cancel. Currently, the void label endpoint is only supported for specific service types by DHL eCommerce US. If your label falls outside these categories, the cancel request will not be processed.

Supported service types are:

DHL SM Parcel/Parcel Plus Expedited Max
DHL SM Parcel/Parcel Plus Expedited
DHL SM Parcel/Parcel Plus Ground
DHL SM BPM Expedited
DHL SM BPM Ground

How to solve

The label will not be charged if it has not been scanned or processed. Check your label to verify if it is still eligible for cancellation. Please reach out to the support team if you still need to void the label.

Enumeration value is not allowed. Allowed values are: [01, 02, 03, 04, 05, 06, 08, 09, 40]

What does it mean

The error indicates that the value provided for a Dangerous Goods (DG) code in your request is not valid.

Currently, the DHL eCommerce US supports specific DG codes that are accepted for both domestic and international products. Please verify the value being sent and ensure the correct value is used.

1. The following DG codes are supported by DHL eCommerce US for domestic products.










2. The following DG codes are supported by DHL eCommerce US for international products.

How to solve

If you are trying to send dangerous or goods from our admin portal, please make sure to input the correct values:

3091 (DG Cat. Code is 02)
3090 (DG Cat. Code is 03)
3481 (DG Cat. Code is 05)
3480 (DG Cat. Code is 06)
2091 (DG Cat. Code is 08)



If you are trying to use the API to generate a label, please make sure to use the service_options. Also, please ensure that you send the field for un_number. For more details, refer to the API documentation on Dangerous Goods Service Option .

Updated on: 09/10/2024