DHL24
Overview
DHL24 is DHL’s shipping platform used primarily for domestic and international shipments within Poland and Europe. The DHL24 integration enables shipment booking, label generation, and shipment cancellation using the DHL24 WebAPI.
Shipments are created through the CreateShipments API, and labels are generated through a separate GetLabels API. The returned shipmentId serves as the tracking number and is stored in the system for shipment tracking and cancellation operations.
Authentication
Authentication credentials are provided by DHL and must be stored securely in the Admin configuration section.
Sandbox Credentials
| Parameter | Value |
|---|---|
| Username | Provide your assigned user name |
| Password | Provide your password |
The credentials are used for accessing the DHL24 sandbox API environment.
Supported Operations
The following operations are supported through the DHL24 integration.
| Operation | API | Description |
|---|---|---|
| Create Shipment | CreateShipments | Books a shipment and generates shipment IDs |
| Generate Labels | GetLabels | Retrieves shipping labels for created shipments |
| Cancel Shipment | DeleteShipments | Cancels a shipment using the shipment ID |
Carrier Services
The DHL24 integration supports both domestic and international shipments depending on the selected product.
| Service Type | Description |
|---|---|
| Domestic | Shipments within Poland |
| International | Shipments across Europe and other supported regions |
Supported Products
The following DHL24 products are supported.
| Code | Product Name |
|---|---|
| AH | Domestic |
| PR | Premium |
| 09 | Domestic 09 |
| 12 | Domestic 12 |
| DW | Evening Delivery |
| SP | Delivered to Point |
| EK | Connect |
| PI | International |
| CP | Connect Plus |
| CM | Connect Plus Pallet |
The selected product determines the delivery service type and shipment conditions.
Label Formats
Shipment labels must be generated using the GetLabels API after creating a shipment.
Label Mapping
| Platform Label Type | DHL24 Label Code |
|---|---|
| PDF A6 | BLP |
| PDF A4 | LBLP |
| ZPL A6 | ZBLP |
| ZPL A4 | ZBLP |
All related shipment IDs must be provided in an array when requesting labels.
Integration Notes
Shipment Creation
Shipments are created using the DHL24 CreateShipments API.
After creating the shipment, the response returns a shipmentId.
This value should be stored in the system and used as the tracking number.
Label Generation
Labels are not returned during shipment creation. Instead, the GetLabels API must be called separately.
The request must include all relevant shipment IDs.
Shipment Cancellation
Shipments can be cancelled using the DeleteShipments API.
The cancellation request requires the shipmentId.
shipmentId = tracking number
Tracking Identifier
The DHL24 API returns a shipmentId, which should be stored and used as:
- tracking number
- shipment reference
- cancellation identifier