FedEx - Validate Address

Description

This module validates a shipping address using the FedEx Address Validation service. It receives the address lines (separated by line breaks), city, state/province, zip code, and country. It makes a POST request to the /address/v1/addresses/resolve endpoint and returns the resolved address, classification (RESIDENTIAL or BUSINESS), residential indicator, and additional attributes.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	FedEx credential (provider: fedex)
street_lines	textarea	Yes	Address lines separated by line breaks
city	text	Yes	City
state_or_province	text	Yes	State or province
postal_code	text	Yes	Zip code
country_code	text	Yes	ISO country code (default: US)

Credentials

A fedex type credential is required with the following fields:

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

Output

{
  "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"
}

Usage Example

Basic case

{
  "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 Used

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

Notes

Address lines are separated by line breaks and empty lines are filtered out
The classification indicates whether the address is RESIDENTIAL or BUSINESS
The is_residential field is a boolean derived from the classification
Useful for determining residential surcharges before creating a shipment