FedEx

Ensure your FedEx account is registered and verified, and create FedEx shipping labels.

About FedExĀ® shipping

You can create FedExĀ® shipping labels for the service methods and packaging types listed in this document.

FedEx service methods supported

The following service methods are supported for FedEx:

  • FedEx International EconomyĀ®
  • FedEx International GroundĀ®
  • FedExĀ® International Connect Plus
  • FedEx Standard OvernightĀ®
  • FedEx 2DayĀ®
  • FedEx 2DayĀ® A.M.
  • FedEx Home DeliveryĀ®
  • FedEx First OvernightĀ®
  • FedEx Priority OvernightĀ®
  • FedEx Express SaverĀ®
  • FedEx GroundĀ®
  • FedEx International PriorityĀ® Express
  • FedEx International FirstĀ®
  • FedEx International PriorityĀ®
  • FedEx EconomyĀ®
  • FedEx GroundĀ® Economy
  • FedEx GroundĀ® Economy Bound Printed Matter
  • FedEx GroundĀ® Economy Media Mail
  • FedEx GroundĀ® Economy Returns
  • FedEx GroundĀ® Economy (under 1 lb.)
  • FedExĀ® Electronic Trade Documents
  • FedEx First OvernightĀ® Extra Hours
  • FedEx Standard OvernightĀ® Extra Hours
  • FedEx Priority OvernightĀ® Extra Hours
  • FedEx One RateĀ®. Additional details for using FedEx One Rate are included in the About FedEx One Rate section of this document.

FedEx also offers the following delivery signature options:

  • No Signature Required
  • Indirect Signature Required
  • Direct Signature Required
  • Adult Signature Required

In addition, these home delivery options are available:

  • FedEx Date Certain Home DeliveryĀ®
  • FedEx Evening Home DeliveryĀ®
  • FedEx Appointment Home DeliveryĀ®

FedEx packaging types supported

The following packaging types are supported for FedEx shipments:

  • FedExĀ® Envelope
  • FedExĀ® Pak
  • FedExĀ® Box
  • FedExĀ® Small Box
  • FedExĀ® Medium Box
  • FedExĀ® Large Box
  • FedExĀ® Extra Large Box
  • FedExĀ® Tube
  • Your Packaging

FedEx service marks are owned by Federal Express Corporation and are used by permission.

Declared value for packages

When shipping with FedEx, you may optionally declare a value for the package being shipped. The following FedEx service methods are available to declare a package value:

  • FedEx Express SaverĀ®
  • FedEx Express SaverĀ® - One Rate
  • FedEx First OvernightĀ®
  • FedEx GroundĀ®
  • FedEx GroundĀ® - From Alaska
  • FedEx GroundĀ® - From Hawaii
  • FedEx GroundĀ® Economy
  • FedEx GroundĀ® Economy - Lightweight
  • FedEx Priority OvernightĀ®
  • FedEx Priority OvernightĀ® - From Alaska
  • FedEx Priority OvernightĀ® - From Hawaii
  • FedEx Priority OvernightĀ® - One Rate
  • FedEx Priority OvernightĀ® - One Rate From Alaska
  • FedEx Priority OvernightĀ® - One Rate From Hawaii

To declare a package value, you'll include the optional fields in the table below as part of the shipmentParameters in your API call.

Reference fieldRequired/OptionalField propertiesDescription
totalDeclaredValue .declaredValueOptionalNumber ($float)
Ex.: 500
The value to be passed through as the total monetary amount of the declared value for the package. This is what will be reimbursed if the package is damaged. If the declared value exceeds the carrier's free threshold, there may be a surcharge for passing a declared value.
totalDeclaredValue .currencyCodeOptionalString
Ex.: usd
The currency code for the declared value

A snippet of the JSON request for the API call with the required fields is included. This example is for a single-parcel shipment. A multi-parcel shipment would be included in multiParcelShipmentParameters.

{
"shipmentParameters": {

   "totalDeclaredValue": {
        "declaredValue": 5000,
        "currencyCode": "usd",
 ...
     }
}

Configure your FedEx account with Shipium

To configure your FedEx account within the Shipium platform, you'll first need to confirm the account number associated with your login. The FedEx Log In homepage is where you'll log in to verify the account.

Next, you'll need to access the Shipium Console. From the navigation menu, you'll select Configure and then FedEx Account Registration. You'll provide your FedEx account billing address and indicate your acceptance of the license agreement authorizing Shipium to access your FedEx account on your behalf. Once you've entered all the required information, you'll select the Validate button.

The next step is selecting the multi-factor authentication method preferred for the account. You can provide a past FedEx invoice, you can be sent a one-time PIN, or you can contact FedEx directly. If providing a past invoice, you'll enter the required data and select Validate.

If choosing the PIN method, you'll choose the way you wish to receive the PIN verification: via SMS text message, email, or phone call. You'll provide the seven-digit verification code once you have it.

If contacting FedEx, you'll call customer support and provide the required details to validate your identity and authorize your access and select Validate once you've completed the process.

Finally, you'll see the successful registration message in the console. With a successful registration, the values for your FedEx Child API Key and FedEx Child API Secret will auto populate.

About FedEx One RateĀ®

FedEx One Rate is a flat-rate shipping option that lets your organization ship packages that weigh 50 pounds or less to anywhere in the U.S. for a fixed price. This shipping method does not include dangerous goods. You can find more details about this shipping method in FedEx's One Rate documentation.

Shipium supports selection of the One Rate shipping method. Some One Rate methods require designating them in your calls to Shipium's Carrier and Method Selection and Label Service APIs, while others are automatically included in rate shopping considerations based on package dimensions.

To use the FedEx One Rate shipping methods, you'll first need to set up a carrier contract for the FedEx One Rate in the Shipium Console.

Configure FedEx One Rate for your account

To start using FedEx One Rate within the Shipium platform, you'll need to set up your account in the Shipium Console to include applicable FedEx One Rate service methods. You can find instructions for establishing a fulfillment context for your organization and attaching a carrier service method and rate to that context in the Fulfillment Contexts documentation.

Specifically, once you have configured a fulfillment context with an origin (or fulfillment center), you'll follow the guidance in the Carrier Contracts documentation to establish carrier contracts, accounts, and rates. The carrier rates configuration is where you'll select the FedEx One Rate service methods applicable to your account.

Within the carrier rate workflow, you'll select the carrier service method to associate with the carrier rate from a dropdown menu, as shown in the following screenshot.

After completing this configuration, you can designate FedEx One Rate as your shipping method.

Designate FedEx One Rate as your shipping method

For FedEx One Rate methods that include boxes, you do not need to specify the method type in your API call. These methods are automatically included in rate shopping, based on the package dimensions you include in your call request. Dimensions for the packaging your organization will use to ship via FedEx One Rate must be within the volume thresholds defined by FedEx for each box package type:

  • FedEx One Rate Extra Large Box, maximum volume 2,200 cubic inches
  • FedEx One Rate Large Box, maximum volume 1,100 cubic inches
  • FedEx One Rate Medium Box, maximum volume 650 cubic inches
  • FedEx One Rate Small Box, maximum volume 420 cubic inches

However, for three of the non-box FedEx One Rate methods, you'll need to designate the specific method you wish to use. As part of the shipment parameters of an API call, you'll provide one of these three FedEx One Rate service methods as the shipment's packaging material, as part of the packaging type:

  • FedEx One Rate Envelope
  • FedEx One Rate Pak
  • FedEx One Rate Tube

The following is a snippet of a JSON request call to Shipium's APIs. The minimum required fields for successfully selecting a FedEx One Rate delivery method are included in the sample request and are defined in the table below, which also includes optional fields that you may include in your call.

You can find information about package dimensions and FedEx One Rate service methods in FedEx's One Rate documentation.

"packagingType": {
        "packagingMaterial": "fedex_one_rate_envelope"
      },
      "totalWeight": {
        "weightUnit": "lb",
        "weight": 0.5
FieldRequired / OptionalTypeDescription
shipmentParameters .packagingType .packagingMaterialRequiredString
Values can be:

- fedex_one_rate_envelope
- fedex_one_rate_pak
- fedex_one_rate_tube
The applicable FedEx One Rate service method should be included as the packagingMaterial value.
shipmentParameters .packagingType .totalWeight .weightUnitRequiredString
Weight units include:

- g (gram)
- kg (kilogram)
- lb (pound)
- oz (ounce)
The unit in which weight values are provided
shipmentParameters .packagingType .totalWeight.weightRequiredNumber ($float)
Ex.: 50
The value of the weight. Weights are limited to 10 pounds for envelopes and 50 pounds for boxes using the FedEx One Rate service methods.
shipmentParameters .packagingType .packagingSizeNameOptionalString
Ex.: 13x12x10 box
A custom name for the packaging
shipmentParameters .packagingType .packagingTypeIdOptionalString
Ex.: ebd94f8b-d390-4c9c-987f-b88343f5bf45
The packagingTypeId that was used for this package. When this value is present, the dimensions defined in the partner are used. When this value is absent, linearDimensions is required.
shipmentParameters .packagingType .linearDimensions .linearUnitOptional, but required if the packagingTypeId is not includedString
Values include:

- cm (centimeter)
- in (inch)
The unit in which linear dimensions are provided
shipmentParameters .packagingType .linearDimensions .lengthOptional, but required if the packagingTypeId is not includedNumber ($float)
Ex.: 13
The longest linear dimension (i.e., the longest side of a box or envelope)
shipmentParameters .packagingType .linearDimensions .widthOptional, but required if the packagingTypeId is not includedNumber ($float)
Ex.: 12
The second longest linear dimension (i.e., the second longest side of a box or envelope)
shipmentParameters .packagingType .linearDimensions .heightOptional, but required if the packagingTypeId is not includedNumber ($float)
Ex.: 10
The least long linear dimension (i.e., the shortest side of a box or envelope). Note on envelopes: This height should represent the highest product you would reasonably put in this envelope before losing more than 10% of the length of the envelope in other dimensions.
shipmentParameters .packagingType .packagingWeight .weightUnitOptionalString
Weight units include:

- g (gram)
- kg (kilogram)
- lb (pound)
- oz (ounce)
The unit in which weight values are provided
shipmentParameters .packagingType .packagingWeight .weightOptionalNumber ($float)
Ex.: 50
The value of the weight

The sample snippet from the JSON request would look like this if you included the optional fields referenced in the table above. If you choose not to provide the optional fields in your API call, they will be autofilled.

"packagingType": {
        "packagingMaterial": "fedex_one_rate_envelope",
        "packagingSizeName": "4x6x10 Envelope",
        "packagingTypeId": "ebd94f8b-d390-4c9c-987f-b88343f5bf45",
        "linearDimensions": {
          "linearUnit": "in",
          "length": 10,
          "width": 6,
          "height": 4
        },
        "packagingWeight": {
          "weightUnit": "lb",
          "weight": 0.5
        }
      },
      "totalWeight": {
        "weightUnit": "lb",
        "weight": 1

About FedEx Ground Economy (formerly SmartPost)

FedEx Ground Economy, formerly referred to as FedEx SmartPost, is a shipping method that requires you to provide an identification (ID) number for the FedEx processing hub located closest to your fulfillment center, or origin. You can find guidance for providing your hub ID in the Carrier Contracts documentation.

FAQ

Q: Can I use FedEx Ground shipping as part of the FedEx One Rate?
A: No. FedEx Ground shipping is not available with FedEx One Rate pricing.


Q: Will there be additional surcharges, like fuel, added to my invoice if I use FedEx One Rate shipping methods?
A: Additional surcharges can apply. The FedEx One Rate documentation provides details.


Q: Can I ship hazardous materials (hazmat) via FedEx One Rate methods?
A: No. Because dangerous goods cannot be shipped in FedEx Express packaging, FedEx One Rate is not available. The FedEx One Rate documentation provides details.

Resources

Your Shipium team member is available to help along the way. However, you might find these resources helpful: