FedEx

Details about ShipStation's integration with FedEx. Includes integration requirements, connection process, features, notes, and troubleshooting.

FedEx COVID-Related Service Updates!

As of April 6th, 2020, FedEx implemented a temporary surcharge on all international parcel and freight shipments from the United States. Please review the FedEx Shipping Rates: Surcharges and Fees page for details.

For additional COVID-related updates for FedEx services, please review the FedEx Coronavirus Updates page.

ShipStation is an official Fedex Compatible Diamond Solution that supports FedEx domestic and international shipping for US-based users, as well as SmartPost and FedEx International MailService. Use your contract rates with FedEx when creating labels, or sign up for pre-negotiated discount rates offered through ShipStation's partnership with FedEx.

FedEx Requirements

Connection Requirements:

  • An active account with FedEx.

  • Your FedEx account number.

  • Your FedEx account shipping address (located in your FedEx account admin details).

  • The email address and phone number associated with your FedEx account.

  • To ship internationally, you must also upload a signature and letterhead image file to ShipStation. See the Upload Letterhead and Signature section below for details.

International Requirements:

  • Commercial Invoices are automatically generated by FedEx and sent electronically (if supported by the destination country). You may be required to upload a header and signature image in ShipStation for some countries.

  • DDP is supported.

  • ShipStation will send your EORI and VAT numbers when creating your label.

Connect a FedEx Account to ShipStation

To connect your FedEx account to ShipStation:

  1. Select the FedEx tile and click Connect.

    FedEx Logo
  2. Read through the FedEx End-User license Agreement and click I Accept.

  3. Fill out your FedEx Account No and default Shipping Address.

    If you do not know your FedEx Shipping Address:

    Log in to your FedEx account and click on your profile name. Then go to Administrative Tools > FedEx Accounts and click on your account number. The FedEx Shipping Address will be listed on this page.

    Fedex admin tools Shipping address section highlighted
  4. Enter an Account Nickname to help you identify the account in ShipStation.

  5. Click Connect.

Available Features for FedEx Integration

ShipStation's integration with FedEx supports these standard features:

Common ShipStation Features

*PDF provided only for FedEx Ground Shipments that meet certain criteria. See Additional Features below.

Domestic Services

FedEx Ground®

FedEx Home Delivery®

FedEx 2Day®

FedEx 2Day® A.M.

FedEx Express Saver®

FedEx Standard Overnight®

FedEx Priority Overnight®

FedEx First Overnight®

FedEx 1Day® Freight

FedEx 2Day® Freight

FedEx 3Day® Freight

FedEx First Overnight® Freight

International Services

FedEx International Economy®

FedEx International Ground®

FedEx International Priority®

FedEx International First®

FedEx International Economy® Freight

FedEx International Priority® Freight

Package Options

Package

Custom Packages

FedEx® 10kg Box

FedEx® 25kg Box

FedEx® Box

FedEx® Envelope

FedEx® One Rate Envelope

FedEx® One Rate Extra Large Box

FedEx® One Rate Large Box

FedEx® One Rate Medium Box

FedEx® One Rate Pak

FedEx® One Rate Small Box

FedEx® One Rate Tube

FedEx® Pak

FedEx® Tube

Confirmation Options

No Signature Required

Indirect Signature

Adult Signature

Direct Signature

FedEx Additional Features

ShipStation's integration with FedEx allows for these additional features when you use standard FedEx services:

Feature

Description

FedEx SmartPost

Enable FedEx SmartPost services for use in ShipStation.

See our FedEx SmartPost article for more details.

Invoiced carrier

FedEx bills you for only the labels you use, which are invoiced monthly to you on your account. FedEx does not charge your account when you create the label in ShipStation.

Any FedEx labels you create in ShipStation that are NOT used to ship a package will not be billed on your invoice. However, you may still wish to void labels you don't use for improved accuracy in your shipment records.

Electronic Trade Documents (ETD)

ShipStation will automatically try to submit customs information electronically through FedEx's ETD program.

Labels created using ETD will have ETD printed somewhere on the label. If ShipStation is not able to submit customs information through ETD (either because it's not enabled for your FedEx account, or because the destination country does not support ETD), you will need to print any necessary customs forms.

FedEx One Rate®

ShipStation supports the use of FedEx One Rate® flat-rate package options for domestic shipments.

Choose an applicable shipping service and use the appropriate FedEx One Rate® package type when you configure a shipment. Shipping services that support One Rate package types include:

  • FedEx 2Day® and FedEx 2Day® A.M.

  • FedEx Express Saver®

  • FedEx First, Priority, and Standard Overnight®.

ShipStation configure shipment widget with service set to FedEx Priority overnight and Package set to FedEx one rate box

See the FedEx One Rate® site for more information and restrictions. Additional fees may apply when you add certain shipping options.

Not available for return labels or multi-package shipping.

FedEx Ground Manifest

For certain kinds of FedEx Ground and FedEx Home Delivery shipments, a FedEx Ground Manifest will be available to print from ShipStation. Print this form within the End of Day section in the Shipments tab.

To be included in the FedEx Ground Manifest, a shipment must meet one or more of the criteria listed here:

  • Collect on Delivery Amount (COD Amount)

  • Declared Value greater than $100 U.S. dollars

  • Oversize (Length + Girth greater than 84")

  • Additional Handling applied to shipment

  • Acknowledgment of Delivery (A.O.D)

  • Residential delivery address

Third-party and Recipient billing

You may bill label charges to an account other than the FedEx account connected to your ShipStation account. This is called Third-party billing.

To bill label fees to a third-party account:

  1. Select the FedEx service, package type, weight, and other options for the shipment, as usual.

  2. Go to Other Shipping Options and choose ThirdParty from the Shipping Account drop-down menu.

    Shipping sidebar other shipping options shows ThirdParty as Shipping Account
  3. Enter the Account #, Country, and account zip code.

  4. Create the label.

You must have your FedEx account connected to ShipStation to choose a FedEx service for a shipment and add a third-party account.

FedEx Ground Collect

FedEx Ground shipments have the option to use FedEx Ground Collect in the Shipping Account drop-down. You may want to use this option when you ship to a vendor and they wish to charge the shipping fees to their own FedEx account.

Shipping sidebar show Service as FedEx Ground and Shipping Account as FedEx Ground Collect

When FedEx delivers the parcel to the recipient, the recipient supplies their account placard. FedEx will scan this placard and that will then bill the receiver's account.

Currently available in the US and Canada. For more information about FedEx Ground Collect, review the FedEx Ground Collect information page.

Bill duties and taxes to payor of shipping charges

Enable this option to have the costs of duties and taxes billed back to your FedEx account.

If used in conjunction with third-party or recipient billing, the billed account will be responsible for the duties and taxes.

Collect on Delivery

When you create FedEx shipping labels, enable Collect on Delivery so that FedEx will collect funds from the recipient when they deliver the package.

Saturday Delivery

When you create FedEx shipping labels, enable the option to allow for package delivery on Saturdays. See FedEx's page on Saturday Delivery for more information and restrictions.

Alcohol shipping

When you create FedEx shipping labels, enable the option to let FedEx know the package contains alcohol. See FedEx's page on Alcohol Shipping for more information and restrictions.

Dry Ice shipping

When you create FedEx shipping labels, enable the option to let FedEx know the package contains dry ice. You must use your own packaging when you ship dry ice. See FedEx's page on Dry Ice Shipping for more information and restrictions.

FedEx Support-Enabled Features

In addition to the features listed above, the following can be enabled by ShipStation Support.

Feature

Description

FedEx International MailService

After you've connected your FedEx account, ShipStation Support can enable FedEx International MailService for use in ShipStation. See our section on FedEx International MailService for more details.

FedEx Retail Rates

If this setting is enabled, the estimated rates you'll see when you Get Rates in ShipStation will reflect FedEx's retail rates. You'll still be charged based on your FedEx account, and the Carrier Fee for generated labels will reflect the estimated cost of the label based on your account.

Bypass ETD

If this setting is enabled, ShipStation will not attempt to submit customs information through ETD. You will be responsible for providing any necessary customs documents to FedEx.

The carrier integration can be used to create domestic shipping labels.

The carrier integration can be used to create international shipping labels.

ShipStation will submit international customs information electronically to the carrier.

The carrier integration can be used to create domestic return labels.

ShipStation will display estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipStation.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

When tracking is available, ShipStation will automatically track the shipment status and update the tracking status on the Shipments tab. This feature allows for other advanced ShipStation features like delayed notifications and the Branded Tracking Page.

ShipStation can perform an End of Day process for the carrier and creates an End of Day PDF file that can be printed and provided to the carrier. The End of Day process can be mandatory or optional, based on the carrier and your account with them. The file may or may not be submitted electronically, see End of Day (Electronic).

ShipStation can print the store's logo on shipping labels created for this carrier. Label branding may not be available for all shipping services.

ShipStation can include information that will be displayed on the label as a label message. Label messages may not be available for all shipping services.

The carrier integration can be used to create multi-package shipments, where multiple individual packages are linked together into a single shipment record with a master tracking number.

You can connect this carrier integration to ShipStation multiple times using different account information, and choose which account will be used to create each shipment.

Schedule a FedEx Pickup in ShipStation

You can schedule a pickup of your FedEx Ground or FedEx Express shipments within the ShipStation app. These instructions outline how to schedule and the requirements to ensure a timely pickup.

Requirements

To ensure that FedEx can accept the pickup request, the shipment must meet these requirements:

  • Total package weight cannot exceed 150lbs.

  • Maximum number of packages for a single pickup request is 99.

  • Include the latest time your package can be picked up or your company’s close time.

  • FedEx Ground Pickup can be scheduled for the next business day or any business day up to 2 weeks in advance.

  • FedEx Express pickup can be scheduled for the current or next business day.

  • If you need to schedule a pickup for both FedEx Express and FedEx Ground packages, you need to schedule a pickup for each of the services individually.

    Carrier pickup popup showing available FedEx services
  • You cannot edit a pickup request. To change a request, you must delete the original request and enter a new request.

  • For FedEx Ground and FedEx Express pickups, you may request an alternate pickup address other than the shipping location attached to the FedEx account number. An additional surcharge will apply.

  • If you already have a regularly scheduled pickup, it is not necessary to schedule a one-time pickup or to add another regularly scheduled pickup.

Scheduling a Pickup
  1. Select FedEx from the Schedule a Pickup drop-down menu.

    Schedule a pickup drop-down menu with FedEx account selected
  2. Fill out the required information on the Schedule a Pickup form.

    FedEx pickup pop-up screen showing all options
  3. Click Schedule a Pickup to complete the request.

Surcharges do not display in ShipStation!

ShipStation will not display any additional fees that the FedEx pickup request may charge.

FedEx Hold at Location

FedEx Hold at Location (HAL) is a service that customers can select at checkout to hold their items at a designated location such as a FedEx Store instead of shipping to their home or business address.

Hold at Location orders import into ShipStation differently to meet FedEx requirements:

  • The suffix -HAL appears on the Requested Service and "FedEx Hold at Location order” appears in Internal Notes on Order details.

    • The Internal Notes or Requested Service can be used for Automation Rules or Service Mapping.

    • Use the Internal Notes filter to quickly identify HAL orders:

      Internal notes files set to "contains" with value set to "fedex"

      Set the Internal Notes filter to Contains "fedex" and apply.

  • The Ship To address is the FedEx hold location and is locked so it cannot be edited in ShipStation.

    Order details with a HAL order and info message stating address is locked
  • Only FedEx services will be available from the Service drop-down.

  • Orders cannot be combined or split into multiple shipments.

  • You cannot apply Shipping Presets to FedEx HAL orders.

The process to create a label and ship the order is the same as any other order in ShipStation. The label will include the Sold To name above the Ship To address. To pick up the package, your customer must present an ID that matches the Sold To name, or present an ID with the shipment's tracking number.

For support related to a Hold at Location shipment, contact FedEx Support at 1-800-GoFedEx (1-800-463-3339).

Enable Hold at Location

Your Selling Channel Checkout must be configured to include FedEx Hold at Location as a service. There is no additional setup needed in ShipStation.

Currently, this service is available with the following Selling Channels:

FedEx Branded Labels and Messages

For services that support branded labels, your store logo will appear in the center of the FedEx shipping label.

For services that support label messages, Label Message 1 will print in the REF (Reference) field, Label Message 2 will print in the INV (Invoice) field, and Label Message 3 will print in the PO (Purchase Order) field.

Example:

FedEx sample label Logo and Message area highlighted.

Label Messages will also print on the commercial invoice for international shipments. Label Message 1 will print in the Special Instructions field, and Label Message 3 will print in the Purchase Order No field.

Label Message 2 is not used for commercial invoices. Instead, ShipStation submits the Order Number as Invoice No.

Example:

FedEx Commercial Invoice Invoice number and special instructions highlighted.

FedEx International MailService

After you've connected your FedEx account to ShipStation, contact ShipStation Support to have FedEx International MailService enabled.

Requires Approval From FedEx

Your FedEx account must be approved for FedEx International MailService to use it in ShipStation.

For more information about FedEx International MailService services and how to apply, see the FedEx page on FedEx International MailService.

FedEx International MailService will appear as it's own carrier, and will be listed separately from other FedEx services in the Service drop-down.

FedEx service drop-down with FedEx International MailService

Remember the following when you use FedEx International MailService within ShipStation:

  • ShipStation only supports the standard service level for FedEx International MailService.

  • Estimated rates and tracking are not available for shipments created using FedEx International MailService through ShipStation.

  • Third-party and Recipient billing, Collect on Delivery, Alcohol Shipping, and Dry Ice shipping are not available for shipments created using FedEx International MailService.

Upload ETD Letterhead and Signature

To simplify the process of international shipping, FedEx uses Electronic Trade Documents (ETD). ETD submits international documentation (like customs forms) electronically and you no longer have to print and attach documents to the shipment. To use the FedEx ETD option in ShipStation, you must add your letterhead and signature images to your account.

Image Requirements

  • Both Letterhead and Signature images must be in either GIF or PNG format.

  • Dimensions for the Signature image are a maximum of 240 x 25 pixels (3.5 x 0.5 in).

  • Dimensions for the Letterhead are a maximum of700 x 50 pixels (7.5 x 1.6 in).

See the FedEx Instructional Help Guide for step-by-step instructions on how to create a signature image.

To upload:

  1. Click Settings on your FedEx account.

    Settings page with FedEx Settings link outlined
  2. Use the Select a File and Upload buttons to upload your signature and letterhead images.

    FedEx settings popup with the Upload signature and Upload letterhead section outlined
  3. Click Confirm.

You can now ship international parcels with FedEx and your international documentation will be sent electronically!

Additional Details about the FedEx Integration

  • ShipStation does not support "Cash Only" FedEx account types. You must be on a billed account to connect FedEx with ShipStation.

  • The Ship Date for created labels must be within 10 days of the current date.

  • If you include carrier insurance and the declared value exceeds $500, FedEx will require a Direct Signature for delivery regardless of the confirmation option selected in ShipStation.

    This requirement will apply to each package valued at over $500 in a multi-package shipment, thus adding Direct Signature fees to those packages. If this multi-package shipment has only one master tracking number, check with FedEx billing support for details about the signature requirements/fees for each individual package.

  • The international setting Sign Customs As does not apply to FedEx shipments. Instead, customs forms will be signed using the Return Name from the Ship From Location.

  • ShipStation's address validation tool determines if an address is Residential or Commercial. This tool is based on the Stamps.com database, and it pulls heavily from the USPS database. Since FedEx uses their own database to determine Residential and Commercial addresses, there are rare cases where the address-type set by ShipStation does not match FedEx's address-type for the same address. This can result in a mismatch between the estimated rate and the actual amount that FedEx bills you for the shipment.

  • When you get rates for FedEx on a Saturday, a Saturday-Pickup fee will be included in the estimated rate. This fee will only apply when the package is actually picked up on a Saturday.

  • Label Message 3: To use Label Message 3, you must also use Label message 1 and 2.

  • The Drop Off Type you select in the FedEx carrier settings can affect estimated rates. We recommend that you choose the same Drop Off Type you and your FedEx representative set up to use with your account. The available options are as follows:

    • Regular Pickup: The shipper already has an every-day pickup scheduled with a courier.

    • Request Courier: The shipper will call FedEx to ask for a courier.

    • Drop Box: The shipper will drop the package in a FedEx dropbox.

    • Business Service Center: The shipper will drop off the package at an authorized FedEx business service center.

    • Station: The shipper will drop off the package at a FedEx Station.

FedEx Troubleshooting Tips

Here are some common issues, potential causes, and troubleshooting tips.

Issue

How to troubleshoot or resolve

Some labels are blank for multi-package labels with some FedEx services when using the Google Chrome browser.

To resolve the blank label issue, preview and print the labels with an alternate browser.

The tracking number, barcode, and other information are absent from the label.

This issue can happen if the address or label messages contain special or Unicode characters not supported by FedEx. In these cases, we submit the information to FedEx and FedEx creates a shipment as expected, but the label image itself is corrupted and multiple details are absent.

To resolve the issue, you'll need to void the shipment, then correct the information as needed.

  • If the issue occurs for all FedEx shipments, it's most likely an issue with the Ship From address or the label messages.

  • If the issue only occurs for a specific order, it's most likely an issue with the Ship To address.

The most common cause of this issue is a line-break Unicode character in Address Line 1. This character is not visible in the ShipStation interface, but it's still sent to FedEx when you create the label. To fix the character, completely erase Address Line 1 and retype it manually. Once corrected, create a new shipping label.

Negotiated rates do not appear in ShipStation

If your FedEx account has negotiated rates enabled, you will first need to create a FedEx label through ShipStation's Rate Calculator. Once you have done so, ShipStation will then display your account's negotiated rates.

If you do not need to use the label created via the Rate Calculator, simply void the label afterwards.

If your negotiated rates still do not appear in ShipStation, remove and re-add your FedEx account in Settings > Shipping > Carriers & Fulfillment. Then create another label via the rate calculator.

Error "Unable to register meter: Shipping address provided does not match our records" when getting rates or creating labels

To create FedEx labels, ShipStation must register each Ship From Location in your account with FedEx. This registry creates a meter number that we store on our backend. If a Ship From Location does not have a meter number yet, ShipStation will attempt to register it when you get rates or create a shipment. This error message occurs when the address we're using to register does not match the FedEx account's Shipping Address.

There are two ways you should try to resolve the error:

  1. Go to Settings > Shipping > Carriers & Fulfillment, and click the Settings link for your FedEx account. Update the FedEx Account Address to match your FedEx Shipping Address, then click Confirm.

  2. Go to Settings > Shipping > Ship From Locations and Edit the Ship From Location. Update the Ship From Address to match your FedEx Shipping Address, then click Save Changes.

To ensure it worked, go back to the Orders tab and try to get a rate for the same order that returned the error. The error message should disappear and display a rate from FedEx.

If you updated your Ship From Location, you can edit it again and set it back to your actual Ship From Address. We only need the address to match FedEx's Shipping Address when we register the Ship From Location for the meter number.

Error "FedEx: Package - Minimum dimensions..." when shipping with FedEx SmartPost.

This error means that the shipment dimensions do not meet FedEx's guidelines for this shipping service.

SmartPost Parcel Select must meet the following criteria:

  • Dimensions: No more than 130" in combined length and girth (L+2W+2H).

  • No one dimension can be greater than 60".

  • Minimum Dimensions are 6" Length X 4" Width X 1" Height.

SmartPost Standard Mail, Bound Printed Matter, and Media have the following restrictions:

  • Dimensions: No more than 84" in combined length and girth (L+2W+2H).

  • No one dimension greater than 60".

  • Minimum dimensions are 6" Length X 4" Width X 1" Height.

For more information about SmartPost and these guidelines, see Service Details: FedEx SmartPost.

Error "Unable to create FedEx shipment. Drop off type is not allowed" when creating return labels.

This error usually occurs when your FedEx account is set to use a Drop Off Type that FedEx does support for return labels. To resolve this issue, you'll need to change the Drop Off Type selected for your FedEx account.

Go to Settings > Shipping > Carriers & Fulfillment, and click the Settings link for your FedEx account. Then, set the Drop Off Type to Regular Pickup.

You can then create return labels as needed. After you create your return labels, we recommend you set the Drop Off Type back to whatever you normally use.

Error "FedEx: Commodity # - Commodity is required" when creating international shipments.

This error message occurs because customs information is absent from the shipment, or the customs declaration contains characters that FedEx cannot process. The # in the error will indicate which customs line is causing the error.

To resolve this error, open the order details and ensure customs information exists for the shipment. If no customs declarations exist, add them to resolve the error.

If the customs declarations are present, check for any special characters (like # $ or ’) and remove them.

Error "Unable to create FedEx shipment. Incomplete commodity description #." when creating international shipments.

This error means the customs description for an item did not meet FedEx's keyword criteria and must be more descriptive. Update the customs declaration to clarify what the international shipment includes. The # will point to which customs line is causing the error.

See FedEx's page on Commodity Descriptions for more details.

Why can't I see FedEx One Rate® package options?

To use FedEx One Rate® package options in ShipStation, you must enable the package type for your account. Go to Settings > Shipping > Packages, and make sure the One Rate® package types are enabled for FedEx. See the Edit Services and Package Types section of our Connect a Postage Provider article for more information.

The carrier integration can be used to create domestic shipping labels.

The carrier integration can be used to create international shipping labels.

ShipStation will submit international customs information electronically to the carrier.

The carrier integration can be used to create domestic return labels.

ShipStation will display estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipStation.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

When tracking is available, ShipStation will automatically track the shipment status and update the tracking status on the Shipments tab. This feature allows for other advanced ShipStation features like delayed notifications and the Branded Tracking Page.

ShipStation can perform an End of Day process for the carrier and creates an End of Day PDF file that can be printed and provided to the carrier. The End of Day process can be mandatory or optional, based on the carrier and your account with them. The file may or may not be submitted electronically, see End of Day (Electronic).

ShipStation can print the store's logo on shipping labels created for this carrier. Label branding may not be available for all shipping services.

ShipStation can include information that will be displayed on the label as a label message. Label messages may not be available for all shipping services.

The carrier integration can be used to create multi-package shipments, where multiple individual packages are linked together into a single shipment record with a master tracking number.

You can connect this carrier integration to ShipStation multiple times using different account information, and choose which account will be used to create each shipment.