DHL Express - Obtener Tarifas

Descripción

Este modulo consulta las tarifas de envío disponibles en DHL Express para una ruta y paquete especificos. Recibe las coordenadas de origen y destino (pais, ciudad, código postal) junto con el peso y opcionalmente las dimensiones del paquete. Realiza una petición GET al endpoint /rates de DHL Express y procesa la respuesta para extraer el nombre del producto, código, precio, moneda, fecha estimada de entrega y dias de transito. Además, identifica automáticamente la tarifa mas economica entre las opciones disponibles.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial DHL Express (provider: dhl_express)
origin_country	text	Si	Código ISO del pais de origen (por defecto: ES)
origin_city	text	Si	Ciudad de origen
origin_postal	text	Si	Código postal de origen
dest_country	text	Si	Código ISO del pais de destino
dest_city	text	Si	Ciudad de destino
dest_postal	text	Si	Código postal de destino
weight	text	Si	Peso del paquete en kilogramos
length	text	No	Largo del paquete en centimetros
width	text	No	Ancho del paquete en centimetros
height	text	No	Alto del paquete en centimetros

Credenciales

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

api_key: API Key de DHL Express
account_number: Número de cuenta de DHL Express

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

Salida

{
  "success": true,
  "rates": [
    {
      "product_name": "EXPRESS WORLDWIDE",
      "product_code": "P",
      "local_product_code": "P",
      "price": "45.50",
      "currency": "EUR",
      "delivery_date": "2026-03-25T23:59:00",
      "transit_days": 2
    }
  ],
  "rates_count": 3,
  "cheapest": {
    "product_name": "EXPRESS WORLDWIDE",
    "product_code": "P",
    "price": "45.50",
    "currency": "EUR"
  },
  "message": "3 tarifas DHL Express obtenidas"
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi_credencial_dhl",
  "origin_country": "ES",
  "origin_city": "Madrid",
  "origin_postal": "28001",
  "dest_country": "DE",
  "dest_city": "Berlin",
  "dest_postal": "10115",
  "weight": "2.5"
}

API Utilizada

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

Notas

La declaración de aduanas se determina automáticamente comparando los paises de origen y destino
Las dimensiones son opcionales; si se proporciona alguna dimension, se incluyen todas con unidad métrica
El campo cheapest devuelve la tarifa mas barata comparando precios numericamente
Las unidades de peso siempre son métricas (kg)