DHL Paket
Overview
DHL Paket is DHL’s parcel delivery service for Germany and European shipments, supporting domestic, European, and international parcel deliveries. The DHL Paket integration enables shipment creation, label generation, shipment cancellation, return label generation, and tracking using the DHL Parcel DE Shipping API.
Shipments can be created through the Orders API, which returns shipment labels directly from the carrier. Each request creates a single package shipment, so shipments containing multiple packages require multiple API requests.
Onboarding
To access the DHL Paket API, you must complete the onboarding process with DHL.
Requirements
- Contact person
- Customer number
- System user
- Billing numbers
Onboarding Process
- Send a request email to the DHL contact person to enable web service access.
- If the user does not have a system user in the DHL business customer portal, they must create one.
- Once access is granted, DHL will notify the user that the API is available.
Note
- The system user password is valid for one year!
- Shortly before expiration, the registered email will receive a notification to update the password!
Supported Operations
The following operations are supported through the DHL Paket integration.
| Operation | Endpoint | Description |
|---|---|---|
| Create Shipment | POST /orders |
Creates a shipment and generates a label |
| Cancel Shipment | DELETE /orders |
Cancels an existing shipment |
| Create Return Shipment | POST /orders (Returns API) |
Generates return labels |
| Tracking | Shipment Tracking – Unified Push API | Receives shipment tracking updates |
| Proof of Delivery (POD) | Shipment Tracking – Unified Push API | Delivery confirmation information |
Multi-Package Shipments
The DHL Paket API only allows one package per request. For shipments containing multiple packages, multiple requests must be sent.
Carrier Services
DHL Paket supports a variety of shipment services depending on the selected product.
| Service | Product | Description |
|---|---|---|
| Premium | Paket International / Warenpost International | Priority delivery service |
| Economy | Paket International / Warenpost International | Economy international shipping |
| Closest Drop Point | Paket International | Deliver to nearest pickup point |
| Preferred Neighbour | Paket / Kleinpaket | Deliver to a specified neighbour |
| Preferred Location | Paket / Kleinpaket | Deliver to a specified location |
| Visual Check of Age | Paket | Age verification service |
| Named Person Only | Paket | Deliver only to named recipient |
| Ident Check | Paket | Identity verification during delivery |
| Signed for by Recipient | Paket | Signature required upon delivery |
| No Neighbour Delivery | Paket | Prevent neighbour delivery |
| Preferred Day | Paket | Choose a delivery date |
| Endorsement | Paket International | Additional delivery instructions |
| Go Green | All products | Automatically applied carbon-neutral shipping |
| Go Green Plus | Paket / Kleinpaket | Enhanced climate-neutral shipping |
| Additional Insurance | Paket / Paket International / Europaket | Extra shipment insurance |
| Bulky Goods | Paket / Paket International | Large parcel handling |
| Cash on Delivery | Paket / Paket International | Payment collected at delivery |
| Parcel Outlet Routing | Paket / Kleinpaket | Deliver to parcel outlet |
| Postal Delivery Duty Paid | Paket International | Duties paid by sender |
| DHL Retoure | Paket / Kleinpaket | Return shipment service |
Service Restrictions
- Preferred Neighbour and Preferred Location cannot be used together.
- Visual Check of Age, Named Person Only, Ident Check, and Signed for by Recipient are mutually exclusive.
- Preferred Day must be 2–6 working days after shipment date.
- Go Green is automatically applied if configured for the billing number.
Supported Products
The following DHL Paket products are supported.
| Code | Product Name | Region |
|---|---|---|
| V01PAK | DHL Paket | National |
| V54EPAK | DHL Europaket | Europe |
| V53WPAK | DHL Paket International | International |
| V62KP | DHL Kleinpaket | National |
| V66WPI | Warenpost International | International |
Label Formats
The DHL Paket API supports the following label encoding formats.
| Label Format | Code |
|---|---|
| ZPL | ZPL2 |
Label Sizes
The following label sizes are supported.
| Label Size |
|---|
| A4 |
| A5 |
| 910-300-600 |
| 910-300-610 |
| 910-300-700 |
| 910-300-700-oz |
| 910-300-710 |
| 910-300-300 |
| 910-300-300-oz |
| 910-300-400 |
| 910-300-410 |
| 100x70mm |
Integration Notes
Shipment Creation
Shipments are created using the endpoint in DHL Parcel DE Shipping API:
POST /orders
Each request creates one package shipment.
Shipment Cancellation
Shipments can be cancelled using the endpoint in DHL Parcel DE Shipping API:
DELETE /orders
Return Shipments
Return labels can be created using the endpoint in DHL Parcel DE Returns API:
POST /orders
Tracking Integration
DHL Paket uses the DHL Unified Tracking Push API for tracking updates. This requires a webhook endpoint capable of receiving tracking events from DHL.
Proof of Delivery (POD)
POD can be retrieved through DHL’s DHL Unified Tracking Push API.
Freight Cost Handling
DHL Paket does not provide a freight cost calculation API. Freight rates must be configured manually using uploaded price tables.