DHL Express - Track Shipment

Description

This module queries the tracking status of a DHL Express shipment using the tracking number. It makes a GET request to the /tracking endpoint with the shipmentTrackingNumber parameter. It processes the response to extract the current status, status description, estimated delivery date, origin, destination, and the complete event history with date, description, location, and status code.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	DHL Express credential (provider: dhl_express)
tracking_number	text	Yes	DHL shipment tracking number

Credentials

A dhl_express type credential is required with the following fields:

api_key: DHL Express API Key

Credentials are obtained from the DHL developer portal (https://developer.dhl.com/).

Output

{
  "success": true,
  "tracking_number": "1234567890",
  "status": "transit",
  "status_description": "En transito",
  "estimated_delivery": "2026-03-25",
  "origin": {"city": "Madrid", "country": "ES"},
  "destination": {"city": "Berlin", "country": "DE"},
  "events": [
    {
      "date": "2026-03-23T10:30:00",
      "description": "Shipment picked up",
      "location": "Madrid - Spain",
      "status_code": "PU"
    }
  ],
  "message": "Estado: transit"
}

Usage Example

Basic case

{
  "credentials_id": "mi_credencial_dhl",
  "tracking_number": "1234567890"
}

API Used

Endpoint: GET /tracking
Base: DHL Express API (via helper _dhlHelper)
Documentation: https://developer.dhl.com/api-reference/dhl-express-mydhl-api

Notes

The module takes the first shipment from the response (shipments[0])
Events are mapped with date, description, location (serviceArea.description), and status code
If the status is not available, “Unknown” is displayed