DHL Shipment Setup
Central setup page for the DHL Parcel DE Shipping Connector. This is where API credentials, shipper address, default settings, and customs defaults are configured.
Opening the Page
- Via search: DHL Shipment Setup
- Via the merchantCENTRAL Dashboard → Shipping Providers → DHL
Fields
API Credentials
Credentials for the DHL Parcel DE Shipping API v2.
| Field | Description |
|---|---|
| API Base URL | Base URL of the DHL API. Production: https://api-eu.dhl.com/parcel/de/shipping/v2, Sandbox: https://api-sandbox.dhl.com/parcel/de/shipping/v2 |
| Sandbox Mode | Enables sandbox mode for test environments |
| API Key | DHL API key (masked). Transmitted in the dhl-api-key header. Available via developer.dhl.com |
| Basic Auth User | Username from the DHL business customer portal for Basic Authentication |
| Basic Auth Password | Password from the DHL business customer portal (masked) |
Billing & Profile
| Field | Description |
|---|---|
| Billing Number | DHL billing number (14 digits). Composed of EKP + product + participation |
| Profile | DHL shipping profile (optional) |
Shipper Address
Shipper address that appears on all DHL labels.
| Field | Description |
|---|---|
| Use Shipper Reference | When enabled, a reference address stored at DHL is used instead of manual entry |
| Shipper Reference | DHL shipper reference (only visible when Use Shipper Reference is active) |
| Shipper Name | Name of the shipper (line 1) |
| Shipper Name 2 | Additional shipper name (line 2) |
| Shipper Name 3 | Additional shipper name (line 3) |
| Shipper Street | Street of the shipper |
| Shipper House No. | House number of the shipper |
| Shipper Post Code | Postal code of the shipper |
| Shipper City | City of the shipper |
| Shipper Country Code | Country code of the shipper (ISO alpha-3, e.g. DEU) |
| Shipper Contact Name | Contact person at the shipper |
| Shipper Email | Email address of the shipper |
| Shipper Phone | Phone number of the shipper |
Shipper Reference
When using the shipper reference, the address fields are disabled. DHL will then use the address stored in the business customer portal.
Default Settings
Default values for label creation.
| Field | Description |
|---|---|
| Default Product | Default DHL product (e.g. V01PAK = DHL Parcel, V53WPAK = DHL Parcel International, V54EPAK = DHL Europaket, V62KP = DHL Small Parcel, V62WP = Warenpost, V66WPI = Warenpost International) |
| Default Weight (g) | Default weight in grams when no weight is specified on the parcel |
| Include Labels as | Type of label inclusion in the API response (URL or Base64) |
| Combine Labels | Combine multiple labels into one document |
| Doc Format | Document format for labels (PDF or ZPL2) |
| Print Format | Print format for shipping labels (e.g. REGULAR, 910-300-700, 910-300-300) |
| Retoure Print Format | Print format for return labels |
Return Labels
| Field | Description |
|---|---|
| Include Return Label | Automatically create a return label with each shipment |
| Return Billing Number | Separate billing number for returns (only when Include Return Label is active) |
Advanced
| Field | Description |
|---|---|
| Creation Software | Software identifier transmitted to DHL |
Customs Defaults
Default values for customs declarations on international shipments.
| Field | Description |
|---|---|
| Default Shipper EORI | Default EORI number of the shipper for customs declarations |
| Default Export Type | Default export type (e.g. COMMERCIAL_GOODS, OTHER, PRESENT, COMMERCIAL_SAMPLE, DOCUMENT, RETURN_OF_GOODS). Standard: COMMERCIAL_GOODS |
| Default Endorsement | Default handling for undeliverable shipments (RETURN = return immediately, ABANDON = abandon) |
DHL Retoure API
Settings for the separate DHL Retoure API (for online return labels).
| Field | Description |
|---|---|
| Retoure Enabled | Enables the DHL Retoure API |
| Retoure API Base URL | Base URL of the DHL Retoure API (only when enabled) |
| Retoure Receiver ID | DHL receiver ID for returns (only when enabled) |
| Retoure GoGreen Plus | Carbon-neutral shipping for returns (only when enabled) |
Status
Current status information for the DHL integration.
| Field | Description |
|---|---|
| Last Label Created | Date and time of the last label created |
| Labels Created Today | Number of labels created today (highlighted in green) |
| Last Error Message | Last error message from the DHL API (red when error) |
| Last Error DateTime | Timestamp of the last error |
Actions
| Action | Description |
|---|---|
| Test Connection | Tests the connection to the DHL API with the current credentials. Sends a test request and displays the result |
Notes
API Key
The API key is created via the DHL Developer Portal. Activation by DHL is required for production use.
Singleton Page
This page has exactly one record. When opened for the first time, the record is created automatically.