FedEx - Get Rates

Description

This module queries the available FedEx shipping rates for a given package. It receives the shipper and recipient addresses in simplified JSON format (zip code and country), weight, optional dimensions, and optional service type. It makes a POST request to the /rate/v1/rates/quotes endpoint and processes the response to extract the service type, name, price, currency, estimated delivery date, and transit days. It automatically identifies the cheapest rate.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	FedEx credential (provider: fedex)
shipper	textarea	Yes	Shipper address in JSON (postalCode, countryCode)
recipient	textarea	Yes	Recipient address in JSON (postalCode, countryCode)
package_weight	text	Yes	Package weight in kilograms
package_dimensions	textarea	No	Dimensions in JSON (length, width, height)
service_type	select	No	Filter by specific service type or leave empty for all

Credentials

A fedex type credential is required with the following fields:

client_id: FedEx API Client ID
client_secret: FedEx API Client Secret
account_number: FedEx account number

Output

{
  "success": true,
  "rates": [
    {
      "service_type": "FEDEX_INTERNATIONAL_PRIORITY",
      "service_name": "FedEx International Priority",
      "price": "52.30",
      "currency": "EUR",
      "delivery_timestamp": "2026-03-25",
      "transit_days": "2"
    }
  ],
  "rates_count": 5,
  "cheapest": {
    "service_type": "FEDEX_GROUND",
    "service_name": "FedEx Ground",
    "price": "15.20",
    "currency": "EUR"
  },
  "message": "5 tarifas FedEx obtenidas"
}

Usage Example

Basic case

{
  "credentials_id": "mi_credencial_fedex",
  "shipper": "{\"postalCode\":\"28001\",\"countryCode\":\"ES\"}",
  "recipient": "{\"postalCode\":\"08001\",\"countryCode\":\"ES\"}",
  "package_weight": "2.0"
}

API Used

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

Notes

If no service type is specified, all available options are returned
The pickup type is set to DROPOFF_AT_FEDEX_LOCATION
Dimensions are optional and expressed in centimeters
The cheapest field automatically identifies the lowest rate