DHL Express - Rastrear Envio

Descripcion

Este modulo consulta el estado de rastreo de un envio en DHL Express utilizando el numero de seguimiento. Realiza una peticion GET al endpoint /tracking con el parametro shipmentTrackingNumber. Procesa la respuesta para extraer el estado actual, descripcion del estado, fecha estimada de entrega, origen, destino y el historial completo de eventos con fecha, descripcion, ubicacion y codigo de estado.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial DHL Express (provider: dhl_express)
tracking_number	text	Si	Numero de seguimiento del envio DHL

Credenciales

Se requiere una credencial de tipo dhl_express con los siguientes campos:

api_key: API Key de DHL Express

Las credenciales se obtienen desde el portal de desarrolladores de DHL (https://developer.dhl.com/).

Salida

{
  "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"
}

Ejemplo de Uso

Caso basico

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

API Utilizada

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

Notas

El modulo toma el primer envio de la respuesta (shipments[0])
Los eventos se mapean con fecha, descripcion, ubicacion (serviceArea.description) y codigo de estado
Si el estado no esta disponible, se muestra “Desconocido”