FedEx - Validar Direccion

Descripcion

Este modulo valida una direccion de envio utilizando el servicio Address Validation de FedEx. Recibe las lineas de direccion (separadas por salto de linea), ciudad, estado/provincia, codigo postal y pais. Realiza una peticion POST al endpoint /address/v1/addresses/resolve y retorna la direccion resuelta, clasificacion (RESIDENTIAL o BUSINESS), indicador de residencial y atributos adicionales.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial FedEx (provider: fedex)
street_lines	textarea	Si	Lineas de direccion separadas por salto de linea
city	text	Si	Ciudad
state_or_province	text	Si	Estado o provincia
postal_code	text	Si	Codigo postal
country_code	text	Si	Codigo 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 basico

{
  "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)
Documentacion: https://developer.fedex.com/api/en-us/catalog.html

Notas

Las lineas de direccion se separan por saltos de linea y se filtran las lineas vacias
La clasificacion indica si la direccion es RESIDENTIAL o BUSINESS
El campo is_residential es un booleano derivado de la clasificacion
Util para determinar cargos residenciales antes de crear un envio