DHL Express - Rastrear Envío

Descripción

Este modulo consulta el estado de rastreo de un envío en DHL Express utilizando el número de seguimiento. Realiza una petición GET al endpoint /tracking con el parámetro shipmentTrackingNumber. Procesa la respuesta para extraer el estado actual, descripción del estado, fecha estimada de entrega, origen, destino y el historial completo de eventos con fecha, descripción, ubicación y código de estado.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial DHL Express (provider: dhl_express)
tracking_number	text	Si	Número de seguimiento del envío 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 básico

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

API Utilizada

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

Notas

El modulo toma el primer envío de la respuesta (shipments[0])
Los eventos se mapean con fecha, descripción, ubicación (serviceArea.description) y código de estado
Si el estado no esta disponible, se muestra “Desconocido”