Documentation

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.

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

NameTypeDescription
Account NumberStringAccount Number from Account Manager portal
UsernameStringDHL username
PasswordStringDHL password
Ship TimestampStringThis 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 AddressStringShipper Address
Shipper CityStringShipper City
Shipper Country CodeStringShipper Country Code
Shipper EmailStringShipper Email
Shipper NameStringShipper Name
Shipper Company NameStringShipper Company Name
Shipper PhoneStringShipper Phone
Shipper Zip CodeStringShipper Zip Code
Recipient NameStringRecipient Name
Recipient AddressStringRecipient Address
Recipient Zip CodeStringRecipient Zip Code
Recipient CityStringRecipient City
Recipient Country CodeStringRecipient Country Code
Recipient Contact NameStringRecipient Contact Name
Recipient EmailStringRecipient Email
Recipient PhoneStringRecipient Phone
Reference NumberStringReference Number
WeightNumberParcel 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.