DHL Express - Validar Direccion

Descripcion

Este modulo valida una direccion de envio utilizando el servicio de validacion de direcciones de DHL Express. Recibe el codigo de pais, codigo postal y opcionalmente la ciudad. Realiza una peticion GET al endpoint /address-validate con estos parametros. Retorna las direcciones encontradas y posibles advertencias. Si se encuentran direcciones validas, se indica como “Direccion valida”; en caso contrario, “Direccion no encontrada”.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial DHL Express (provider: dhl_express)
country_code	text	Si	Codigo ISO del pais (por defecto: ES)
postal_code	text	Si	Codigo 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 basico

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

Notas

Util para validar direcciones antes de crear un envio y evitar rechazos
La ciudad es opcional pero mejora la precision de la validacion
El campo warnings contiene advertencias sobre la direccion proporcionada