1.Introduction
This document is intended for API customers using end-to-end (E2E) services. It provides integration guidelines covering the entire process—from creating bookings and generating shipping labels to retrieving tracking information.
2.API Documentation
Please refer to the API online documentation guide chapter 3 for the API documentation introduction.
Download API Documentation: https://strmysqlsbrprddconnector.blob.core.windows.net/publicresourcecontainer/SwaggerHub/customerV2.31.20260604.1.html
3.API Integration
3.1 genericDataAndLabel API
1) Introduction
By integrating with the genericDataAndLabel API, customers can create bookings and generate shipping labels. Once system checks are completed (including field validation and denied-party screening), the label will be generated. Please note that duplicate shipment IDs are not allowed for booking creation.
2) Integration Process
Perform API integration testing in the test environment before going live. Once testing is successfully completed, the PI team <ecs.pi_support@dhl.com> will request a D-Connector login account using the email address provided by the customer. The official account creation typically takes 1–2 business days. Please notify us in advance before creating any official bookings.
3) Test account:
"pickupAccountId":"HKCYL001",
"soldToAccountId":"HKCYL001"
4) genericDataAndLabel API Rate Limit
Request rate limit as following:
Service Level | Request frequency per second | Request frequency per day |
Standard | 20 req/s | No limit |
A maximum of 20 requests per second.
3.2 Tracking API
After successfully calling the genericDataAndLabel API and obtaining the last-mile label, the DSP tracking number will be returned. To retrieve last-mile tracking details, customers can integrate with the Tracking API.
The Shipment Tracking API enables customers to:
a. Retrieve tracking information for shipments.
b. Identify the Deutsche Post DHL (DPDHL) service provider handling the shipment.
c. Confirm that DPDHL uses the correct delivery address, helping reduce mis-shipments.
For detailed integration steps, please refer to the Tracking API page.