DHL Express - Obtener Tarifas

Descripcion

Este modulo consulta las tarifas de envio disponibles en DHL Express para una ruta y paquete especificos. Recibe las coordenadas de origen y destino (pais, ciudad, codigo postal) junto con el peso y opcionalmente las dimensiones del paquete. Realiza una peticion GET al endpoint /rates de DHL Express y procesa la respuesta para extraer el nombre del producto, codigo, precio, moneda, fecha estimada de entrega y dias de transito. Ademas, identifica automaticamente la tarifa mas economica entre las opciones disponibles.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial DHL Express (provider: dhl_express)
origin_country	text	Si	Codigo ISO del pais de origen (por defecto: ES)
origin_city	text	Si	Ciudad de origen
origin_postal	text	Si	Codigo postal de origen
dest_country	text	Si	Codigo ISO del pais de destino
dest_city	text	Si	Ciudad de destino
dest_postal	text	Si	Codigo 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: Numero 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 basico

{
  "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)
Documentacion: https://developer.dhl.com/api-reference/dhl-express-mydhl-api

Notas

La declaracion de aduanas se determina automaticamente comparando los paises de origen y destino
Las dimensiones son opcionales; si se proporciona alguna dimension, se incluyen todas con unidad metrica
El campo cheapest devuelve la tarifa mas barata comparando precios numericamente
Las unidades de peso siempre son metricas (kg)