DHL Express - Validar Dirección

Descripción

Este modulo valida una dirección de envío utilizando el servicio de validación de direcciones de DHL Express. Recibe el código de pais, código postal y opcionalmente la ciudad. Realiza una petición GET al endpoint /address-validate con estos parámetros. Retorna las direcciones encontradas y posibles advertencias. Si se encuentran direcciones validas, se indica como “Dirección valida”; en caso contrario, “Dirección no encontrada”.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial DHL Express (provider: dhl_express)
country_code	text	Si	Código ISO del pais (por defecto: ES)
postal_code	text	Si	Código postal a validar
city_name	text	No	Nombre de la ciudad

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,
  "addresses": [
    {
      "cityName": "Madrid",
      "countryCode": "ES",
      "postalCode": "28001"
    }
  ],
  "warnings": [],
  "message": "Direccion valida"
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi_credencial_dhl",
  "country_code": "ES",
  "postal_code": "28001",
  "city_name": "Madrid"
}

API Utilizada

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

Notas

Útil para validar direcciones antes de crear un envío y evitar rechazos
La ciudad es opcional pero mejora la precision de la validación
El campo warnings contiene advertencias sobre la dirección proporcionada