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
| Name | Type | Description |
|---|---|---|
| Account Number | String | Account Number from Account Manager portal |
| Username | String | DHL username |
| Password | String | DHL password |
| Ship Timestamp | String | 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 Address | String | Shipper Address |
| Shipper City | String | Shipper City |
| Shipper Country Code | String | Shipper Country Code |
| Shipper Email | String | Shipper Email |
| Shipper Name | String | Shipper Name |
| Shipper Company Name | String | Shipper Company Name |
| Shipper Phone | String | Shipper Phone |
| Shipper Zip Code | String | Shipper Zip Code |
| Recipient Name | String | Recipient Name |
| Recipient Address | String | Recipient Address |
| Recipient Zip Code | String | Recipient Zip Code |
| Recipient City | String | Recipient City |
| Recipient Country Code | String | Recipient Country Code |
| Recipient Contact Name | String | Recipient Contact Name |
| Recipient Email | String | Recipient Email |
| Recipient Phone | String | Recipient Phone |
| Reference Number | String | Reference Number |
| Weight | Number | Parcel weight |
Outputs
| Name | Type | Description |
|---|---|---|
| Success | Boolean | Whether label successfully generated |
| Label | Object | Label in base64 |
| Shipment Number | String | Shipment number |
| success | Boolean | success 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.