Skip to content
English
Go to shippypro.com
  • There are no suggestions because the search field is empty.

How to Connect DHL Parcel DE Returns to ShippyPro

Let's see how you can integrate DHL Parcel DE Returns with ShippyPro in just a few steps.

 

⚠️ All users must complete the migration to this integration before 31 May 2026. This integration will replace the current DHL Parcel which will be deprecated by the carrier without any grace period possibility.

 

1. Before you start

Before connecting DHL Parcel DE Returns to ShippyPro, make sure you have the following:

  • An active DHL Parcel DE Returns account
  • Your DHL Parcel DE Returns API credentials (username and password)
  • Your Receiver ID, provided by DHL — this is required to generate return labels. If you don't have it, contact your DHL account manager or sales representative

Note: The Receiver ID can be configured directly in the connection modal. Alternatively, it can be set as a carrier option after connection — in that case, the carrier option value takes priority over the one entered in the modal.

 

2. How to connect DHL Parcel DE Returns to ShippyPro

  1. Log in to your ShippyPro account
  2. Go to the Carriers page
  3. Find the DHL Parcel DE Returns logo and click on it
  4. The connection modal will open — fill in the following fields:
Field Description
Username Your DHL Parcel DE Returns API username
Password Your DHL Parcel DE Returns API password
Receiver ID

Your DHL-assigned Receiver ID (required if not set as a carrier option)
Return Billing Number

Enter the DHL account number to be used for generating return labels. To include a return label in the shipment box together with the outbound label, you must also enable the “Create Return in the Box” option in the section below. 
  1. Click Connect to save your credentials
  2. ShippyPro will validate your credentials automatically — you'll receive a confirmation if the connection is successful

 

3. Additional features

DHL Parcel DE Returns supports the following shipping destinations:

Destination Supported
National (Germany) ✅yes
EU ✅yes
International ✅yes

Note: This integration is designed specifically for return shipments. It supports return label generation only — outbound shipping labels are not available through this integration.



 

Label (PDF): Available

Label (ZPL): Available 10X20cm & 10x15cm

Track & Trace: Available

Credentials Validation: Available

Return Labels: Available 

Return Label in the box: Available (you will need to set the Return Billing Number and flag the option Create Return Label)

 

Receiver ID as a Carrier Option

If you manage multiple accounts or need to override the Receiver ID set in the modal, you can configure it as a carrier option directly from your carrier settings in ShippyPro. The value set as a carrier option always takes priority over the one entered during the connection setup.

Carrier Option Slug Type Description
Receiver ID receiver_id Text Your DHL-assigned Receiver ID

Label format

DHL Parcel DE Returns generates labels in PDF format. ZPL and EPL label formats are not supported for this integration.

 

4. Errors & Troubleshooting

To check: ["status":["title":"Bad Request", "status":400,"detail":"0 of 1 shipment successfully printed.","statusCode":400], "items": [["sstatus":{"title":"Bad
Request", "status":400,"statusCode":400], "validationMessages":[["property":"consignee.name1","validationMessage": "Please enter Name 1.", "validationState":"Error"]]]]]
Check the company name field and make sure you have not left extra spaces.