DHL Parcel DE Return Label

Generates a DHL Parcel Germany return label for a shipment and stores it so it can be shared with the customer. Use it to give customers a ready return label during a returns flow.

Generates a DHL Parcel Germany return label for a shipment and stores it so it can be shared with the customer. Use it to give customers a ready return label during a returns flow.

What it does

  • Creates a return label through the DHL Parcel DE returns service for the given shipper details.
  • Returns the shipment number and routing code for the return.
  • Saves the generated label and returns a file URL that can be sent to the customer.
  • Optionally includes customs details (item description and value) when a parcel description is provided.

Inputs

NameTypeRequiredDescription
Account NumberString-Account Number from Account Manager portal
UsernameString-DHL username
PasswordString-DHL password
Ship TimestampString-This timestamp identifies the pickup date and time of the rated shipment. It needs to be provided in the following format with GMT offset. YYYY-MM-DDTHH:MM:SSGMT+k
Shipper AddressString-Shipper Address
Shipper CityString-Shipper City
Shipper Country CodeString-Shipper Country Code
Shipper EmailString-Shipper Email
Shipper NameString-Shipper Name
Shipper Company NameString-Shipper Company Name
Shipper PhoneString-Shipper Phone
Shipper Zip CodeString-Shipper Zip Code
Recipient NameString-Recipient Name
Recipient AddressString-Recipient Address
Recipient Zip CodeString-Recipient Zip Code
Recipient CityString-Recipient City
Recipient Country CodeString-Recipient Country Code
Recipient Contact NameString-Recipient Contact Name
Recipient EmailString-Recipient Email
Recipient PhoneString-Recipient Phone
Reference NumberString-Reference Number
WeightNumber-Parcel weight

Outputs

NameTypeDescription
SuccessBooleanWhether label successfully generated
LabelObjectLabel in base64
Shipment NumberStringShipment number
successBooleansuccess of action

Notes

  • Requires a DHL Parcel DE business account (username, password and account/app key).
  • The label is returned as a stored file URL, so it can be linked directly in a reply to the customer.