FedEx - Validar Dirección

Descripción

Este modulo valida una dirección de envío utilizando el servicio Address Validation de FedEx. Recibe las líneas de dirección (separadas por salto de línea), ciudad, estado/provincia, código postal y pais. Realiza una petición POST al endpoint /address/v1/addresses/resolve y retorna la dirección resuelta, clasificación (RESIDENTIAL o BUSINESS), indicador de residencial y atributos adicionales.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial FedEx (provider: fedex)
street_lines	textarea	Si	Líneas de dirección separadas por salto de línea
city	text	Si	Ciudad
state_or_province	text	Si	Estado o provincia
postal_code	text	Si	Código postal
country_code	text	Si	Código ISO del pais (por defecto: US)

Credenciales

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

client_id: Client ID de la API de FedEx
client_secret: Client Secret de la API de FedEx

Salida

{
  "success": true,
  "resolved_address": {
    "streetLinesToken": ["123 MAIN ST"],
    "city": "MEMPHIS",
    "stateOrProvinceCode": "TN",
    "postalCode": "38118",
    "countryCode": "US"
  },
  "classification": "RESIDENTIAL",
  "is_residential": true,
  "attributes": {},
  "message": "Direccion validada: RESIDENTIAL"
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi_credencial_fedex",
  "street_lines": "123 Main Street\nApt 4B",
  "city": "Memphis",
  "state_or_province": "TN",
  "postal_code": "38118",
  "country_code": "US"
}

API Utilizada

Endpoint: POST /address/v1/addresses/resolve
Base: FedEx API (via helper _fedexHelper)
Documentación: https://developer.fedex.com/api/en-us/catalog.html

Notas

Las líneas de dirección se separan por saltos de línea y se filtran las líneas vacias
La clasificación indica si la dirección es RESIDENTIAL o BUSINESS
El campo is_residential es un booleano derivado de la clasificación
Útil para determinar cargos residenciales antes de crear un envío