1. Home
Log a Case

FedEx Implementation Guide


Includes all FedEx origins and destinations. Certified in US, EMEA, APAC and LAC. Supporting both parcel, freight as well as all special services and electronic trade documents


To setup a FedEx preference you need to know your account number and the shipping/billing addresses linked to that account. FedEx authenticate your account number against you shipping/billing address so make sure you enter these details correctly.

If your FedEx account is SmartPost enabled please select whether it's enabled for outbound and/or return. You will also need to enter your SmartPost Hub ID. You FedEx account representative can help you determine what this is.

Test Account

We provide a FedEx test account in the application, so you can test some functionalities without a live carrier account.

To set up the FedEx test account open Zenkraft Settings from the app launcher. Make sure Demo Mode is turned on.

Scroll down to the Test Preference and Demo Data section and click Create FedEx Test Preference once. This will generate a FedEx Shipping Preference. If you also need demo data to test with, then click Generate FedEx Demo Data.

Service Types

Service Types Value Description
FedEx 2Day® FEDEX_2_DAY 2 business days by 4:30 p.m. to U.S. businesses; by 8 p.m. to residences
FedEx 2Day® A.M. FEDEX_2_DAY_AM 2 business days by 10:30 a.m. to U.S. businesses and by noon to residences
FedEx 1Day® Freight FEDEX_1_DAY_FREIGHT Next-business-day delivery by 10:30 a.m. for most shipments
FedEx 2Day® Freight FEDEX_2_DAY_FREIGHT 2 business-days by noon for most shipments
FedEx 3Day® Freight FEDEX_3_DAY_FREIGHT 3 business-days by 3 p.m. for most shipments
FedEx Express Saver® FEDEX_EXPRESS_SAVER 3 business days by 4:30 p.m. to U.S. businesses; by 8 p.m. to residences
FedEx First Overnight® Freight FEDEX_FIRST_FREIGHT Next-business-day delivery by 9 a.m. or 10:30 a.m. to most areas
FedEx Freight® Economy FEDEX_FREIGHT_ECONOMY Cost‑effective delivery of LTL Freight with delivery options of 10:30 a.m. or 5 p.m.
FedEx Freight® Priority FEDEX_FREIGHT_PRIORITY Fast-transit delivery of LTL Freight with delivery options of 10:30 a.m. or 5 p.m.
FedEx Ground® FEDEX_GROUND Cost-effective, on-time delivery in 1 to 7 business days.
FedEx Home Delivery® GROUND_HOME_DELIVERY Cost-effective, on-time delivery in 1 to 7 business days.
FedEx First Overnight® FIRST_OVERNIGHT Next-business-day delivery by 8, 8:30 or 9 a.m. to most areas
FedEx Priority Overnight® PRIORITY_OVERNIGHT Next-business-day delivery by 10:30 a.m. to U.S. businesses, noon to most residences
FedEx Standard Overnight® STANDARD_OVERNIGHT Next-business-day delivery by 4:30 p.m. to U.S. businesses and by 8 p.m. to residences
FedEx SmartPost® SMART_POST Customized solution, where FedEx deliver your packages to a USPS facility for final delivery by a postal carrier
FedEx Europe First® EUROPE_FIRST_INTERNATIONAL_PRIORITY Delivery between 9 and 10 a.m. in major destination cities across Europe.
FedEx International Economy® INTERNATIONAL_ECONOMY 2–5 business days
FedEx International Economy® Freight INTERNATIONAL_ECONOMY_FREIGHT Within 5-business days
FedEx International First® INTERNATIONAL_FIRST 1–3 business days with delivery as early as 10 a.m.
FedEx International Priority® INTERNATIONAL_PRIORITY 1–3 business days by close of business
FedEx International Priority® Freight INTERNATIONAL_PRIORITY_FREIGHT 1–3 business-days with delivery as early as 10 a.m.
FedEx International Priority Distribution INTERNATIONAL_PRIORITY_DISTRIBUTION The shipment will clear Customs as one unit, then individual pieces will be delivered to multiple addresses in a destination country/territory.
FedEx SameDay® SAME_DAY US cross-country door-to-door delivery within hours, depending on availability.
FedEx SameDay® City SAME_DAY_CITY Arrives within hours of pickup. Detailed information on FedEx SameDay.

Packaging Types

Packaging Types Value
FedEx 10kg Box FEDEX_10KG_BOX
FedEx 25kg Box FEDEX_25KG_BOX

Special Services

These are special services offered by the carrier which can be selected either during the Shipment creation, or can be defaulted in the Custom Address Source. In this section you can find the most commonly used services.

Alcohol Shipping

Alcohol Shipment is a checkbox field, which requires TRUE value.
Alcohol Recipient Type requires either of these values: CONSUMER or LICENSEE.

Dry Ice

If certain products require to be shipped with dry ice, select the below field in Packages section using Child Object.

If dry ice is a default for all shipments, then add this checkbox.

Lithium Batteries

In case lithium batteries are included in the shipment, you can default the checkbox by adding FedEx: Lithium Batteries/Cells under Specific Carrier Fields.

Delivery Signature

You can default the FedEx® by adding the FedEx: FedEx® Delivery Signature Options under Specific Carrier Fields.

International Shipping

In this section you'll find the required or recommended fields and settings for international shipments.

Mandatory fields for Customs items

  • Description
  • Quantity
  • Quantity Units
  • Weight
  • Unit price
  • Country
  • # of pieces
  • Harmonised Code

Package Contents

Package contents can either be Documents or Commodities. To automate the selection you need to add FedEx: Package Contents under Specific Carrier Fields with one of the following API values:

Override Paperless for Intl Documents

Generally documents are electronically transmitted to the carrier. Ticking this checkbox will turn off this transmission and a printed invoice will be required to be included in the package. If a country doesn't accept electronic documents a pop-up message will come up.

Commercial Invoice

For some international shipments a Commercial Invoice is required.

Other Documents

If you have any other external documents, you can add them to Other Documents. However, bear in mind that these documents will transmit to FedEx.

FedEx SmartPost®

SmartPost® is a customized solution offered by the carrier, where FedEx deliver your packages to a USPS facility for final delivery by a postal carrier

1. Setup

Your FedEx account must already be SmartPost® enabled before you can start creating SmartPost® labels. If its not already enabled, then please contact your FedEx account manager to get this set up.

To enable the SmartPost® options on the shipping wizard you will need to create your FedEx account preference, and be sure to set the checkboxes related to SmartPost® as you can see here:


2. SmartPost Options

Once you are on the shipping Wizard page, in section 4 you can select the SmartPost Service type:


You are then able to select the SmartPost® indicia type which are detailed below:

  • FedEx SmartPost® Parcel Select
  • FedEx SmartPost® Parcel Select Lightweight
  • FedEx SmartPost® Bound Printed Matter
  • FedEx SmartPost® Media

Depending on the Indicia type you use, your next choice is related to the Ancillary Endorsement. This lets FedEx know what to do with undelivered packages.


Here are the options:

  1. Address Correction
  2. Carrier Leave If No Response
  3. Change Service
  4. Forwarding Service
  5. Return Service

*Note that not all options are available for all Indicia types.

3. Example Label

This is an example SmartPost® Label for reference


FedEx One Rate®

You can ship using FedEx One Rate® with the following Packaging Types for domestic US shipments.

  • FedEx Envelope
  • FedEx Extra Large Box
  • FedEx Large Box
  • FedEx Medium Box
  • FedEx Small Box
  • FedEx Pak
  • FedEx Tube

You can select it under Special Services,

or you can default it in the Custom Address Source.

Hazardous Materials

What are the correct HazMat Names, UN numbers and Packaging Types?

Refer to the FedEx HazMat table.

Are Dangerous Goods / HazMat details required for all FedEx Shipments?

FedEx will require the details for any non-air freight shipments. You will enter these details in our DG/HazMat object and select the 'Hazardous Materials' special service in the wizard.
For Air Freight, you will only need to select the 'Dangerous Goods' special service, and mark the dangerous goods as 'ACCESSIBLE' or 'INACCESSIBLE'

Label Formats

Available label formats

Description Values
  • PAPER_4X6
  • PAPER_4X8
  • PAPER_4X9
  • PAPER_7X4.75
  • PAPER_4X6
  • PAPER_4X8
  • PAPER_4X9
  • PAPER_7X4.75
  • STOCK_4X6
  • STOCK_4X8
  • STOCK_4X6
  • STOCK_4X8


What is the maximum declared value allowed?

$50,000 for the FedEx Box, FedEx Tube, and Your Packaging package types

Restrictions for Returns

The following limitations apply for return shipments.

  • Not available with less-than-truckload (LTL) or distribution services
  • Not available with multiple piece shipment (MPS) pricing
  • Not available with hazardous materials (hazmat)
  • Ground returns are subject to a 1 lb., Zone 6 minimum transportation charge, unless requested otherwise through the Pricing Request System (PRS) or Enterprise Pricing Request System (ePRS)
  • Outbound discounts do not apply to Ground returns
  • Not available with Priority Alert (PA), Third Party Consignee (TPC), International Traffic in Arms Regulations(ITAR), or FedEx International Controlled Export (FICE)
  • Not available with Puerto Rico to US, US to Puerto Rico, or intra-Puerto Rico shipments
    *With regular shipping services. Smartpost is the only service that allows for returns from Puerto Rico to the US.

Can I create a return shipment from an APO location?

FedEx SmartPost allows customers to ship orders to APO, FPO or DPO locations, but return shipments are not supported.

Error Messages

In this section you can find the most common error messages, what they mean and how to solve them.

A FedEx-generated COMMERCIAL_INVOICE is prohibited for the shipment. The document was not generated

This means that FedEx cannot generate a commercial invoice for the Recipient Country entered.
You can read more about which FedEx documents are supported here.

'Unable to subscribe with FedEx using the shipping address provided. Please contact FedEx and verify that this shipping address is associated with this FedEx account'

This error occurs when the demo FedEx account is deleted and cannot be recreated.
Solution: update is required.

'The FTR Exemption or AES Citation you provided is not valid for EEI.'

This error means that the commodity you tried to ship is over $2500 in value. You need to file via AESDirect to get an exception number. Once you have this number you need to add it to the shipment in the wizard.

Common Questions

In this section you can find our most commonly asked questions regarding this carrier. If you have a question not listed here please contact us.

Why are the special services not populating when using the Custom Address Source?

Be sure that the Package Type, Service Type, and Package weight have been set in the Custom Address Source correctly.

Can I require that Address Validation is used for each shipment?

Yes, by using the Disable Rate/Ship for Invalid Address checkbox in Setup | Custom Settings.

Can I automate carrier pickups?

It is possible to set up automated carrier pickups from any custom or standard object. You can find more information and detailed steps in our Automated Pickups guide.

Will shipments created via Multi Carrier / API show up on the my FedEx login via the website?

No. You will be sent an itemized invoice from FedEx every month. Any shipments not created via the FedEx website will not show up on the website via your login.

Can I cancel a shipment with multiple packages?

Yes. All you need to do is cancel the master tracking number which is related to the first package, and it will cancel the whole shipment and all related packages.

Can Hold at Location be changed after the shipment has been created?

HAL packages cannot be redirected to another location.
If the package had not already been generated with HAL it could be redirected to HAL using the InFlight service but f it was already generated using HAL it cannot be redirected to a different HAL location.

How long will labels stay valid if unused?

Printed return labels do not expire and are valid for transportation use anytime. However, if the label is more than 255 days old, then the customer will not be able to track the shipment, even though the label is still usable.

How far in advance can you schedule a ship date? (Future Ship Date)

FedEx Ground, FedEx SmartPost, and FedEx Freight future day shipments may be created up to 10 days in advance.

Why does Ground Call Tag not return costs?

You can create a rate request to get the costs for a standard shipment, then add the Call tag fee which is $7 dollars if the package is being picked up at a commercial location, $8 for a residential location.
You can find more information on the FedEx Fees Information page.

Why did a FedEx Customs Trade Specialist contact the recipient about the International Shipment?

FedEx Customs Trade Specialists may email the recipient because it's the responsibility of the recipient to get it through customs. It is likely that Trade Specialists proactively contact the customer to help get the shipment through customs.

How can I update the return address on the return label?

It is not possible to update the return address via API. This is because the (return) shipping address is associated with the FedEx account. It is not possible to override it via webservices. If you need to change the address please contact the FedEx Revenue team.

Back to Top