1. Home
Log a Case

FedEx Implementation Guide

Introduction

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

Preferences

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.

At the bottom of the Shipping Preference you can set the default Drop Off Type.

You can override this drop off type from the Custom Address Source under Specific Carrier fields.

  • Drop off package at a FedEx® drop box - DROP_BOX
  • Drop off package at a FedEx® business service center - BUSINESS_SERVICE_CENTER
  • Use an already scheduled pickup at my location - REGULAR_PICKUP
  • Schedule a pickup (must be scheduled separately) - REQUEST_COURIER
  • Drop off package at a FedEx® station - STATION

FedEx Signature and Letterhead

Electronic Signature and Letterhead are required by FedEx. You need the set this up on the Preference. Go to Shipping Preferences and select your FedEx preference.

Click on the arrow and select FedEx Setup Signature and Letter Head.

Upload a new image by clicking on the + sign.

Once the images are uploaded match the right image to the right function.

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 Distance Deferred FEDEX_DISTANCE_DEFERRED
FedEx Next Day Afternoon FEDEX_NEXT_DAY_AFTERNOON
FedEx Next Day Early Morning FEDEX_NEXT_DAY_EARLY_MORNING
FedEx Next Day Mid Morning FEDEX_NEXT_DAY_MID_MORNING
FedEx Next Day End of Day FEDEX_NEXT_DAY_END_OF_DAY
FedEx Next Day Freight FEDEX_NEXT_DAY_FREIGHT
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
FedEx Box FEDEX_BOX
FedEx Extra Large Box FEDEX_EXTRA_LARGE_BOX
FedEx Large Box FEDEX_LARGE_BOX
FedEx Medium Box FEDEX_MEDIUM_BOX
FedEx Small Box FEDEX_SMALL_BOX
FedEx Envelope FEDEX_ENVELOPE
FedEx Pak FEDEX_PAK
FedEx Tube FEDEX_TUBE
Your Packaging YOUR_PACKAGING

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.

  • No Signature Required - NO_SIGNATURE_REQUIRED
  • Indirect Signature Required - INDIRECT
  • Direct Signature Required - DIRECT
  • Adult Signature Required - ADULT

For more information on delivery signature options please visit the FedEx Delivery Signature Options guide.

NOTE: Please note that due to the Covid 19 pandemic delivery signatures are temporarily suspended for most deliveries in Canada and the US. A physical signature is not required for FedEx Express and FedEx Ground shipments except when an adult signature is required.

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

You can map the Quantity Units and # of Pieces in the custom address source.

You need to add the following field mappings. We'll include the most common quantity units and unit of measures here.

  • FedEx: Quantity Units - Piece (PC), Each (EA), Quantity Not Required (X)

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:
  • DOCUMENTS_ONLY
  • NON_DOCUMENTS

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.

EEI/AES filing

For international shipments from the US over $2500 in value an AES citation needs to be submitted. This reference needs to be entered in the Export Compliance Statement field.

Commercial Invoice

For most international shipments a Commercial Invoice is required. By setting this section below, FedEx will generate the commercial invoice for you and submit it electronically.

Some countries do not accept electronic trade documents, so for those countries you need to select Override Paperless and then create and print our your own Commercial Invoice to use. Otherwise you might recieve an error like this: A FedEx generated commercial invoice is prohibited for the shipment

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.

As of July 1st, its is recommended that any shipments into the European Union need to have an IOSS number submitted when creating the shipment.

FedEx allows you to utilize the Sender Tax ID to do this, which you are set via our Zenkraft Multi Carrier application under the Billing and Reference section.

Email Notifications

FedEx provides notification emails for every tracking step. In the Shipping Preference you can decide when you want your customers or yourself to receive these notification, if at all.

Open your FedEx shipping preference and scroll down to the Email Notifications section.

  • Email Message Default - you can type here the message you'd like your customers to see
  • Send Email Notification to Shipper - if this checkbox is checked, you, or the person whose email address is added to the sender details, will be notified at the checkpoints selected below
  • Send Email Notification to Recipient - if this checkbox is checked the person whose email address is added to the recipient details, will be notified at the checkpoints selected below
  • Email Notify on Exception - the people selected above will receive a notification when the shipment is in Exception stage
  • Email Notify on Delivery - the people selected above will receive a notification when the shipment is in Delivered stage
  • Email Notify on Shipment - the people selected above will receive a notification when the shipment is created
  • Email Notify on Estimated Delivery - the people selected above will receive a notification when the estimated delivery is available
  • Email Notify on Tender - the people selected above will receive a notification when the shipping label is scanned by FedEx and the shipment enters the network

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:

smartpost-options

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.

ancillary-list

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

example-label

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

You can ship dangerous goods and hazmat goods with the Multi Carrier package.

You can only ship Hazmat goods via FedEx Ground, but you can ship Dangerous goods via any FedEx service type.

Dangerous Goods

When selecting the special service of dangerous goods you should see this section appear:

For each package that you are sending you need to specify whether the dangerous good is accessible or inaccessible.

You can also specify the HazMat detail if you want to but this is not required. If you want to specify this, then you first need to go to the DG/HazMat tab

and create a new HazMat detail.

Fill in as much detail as you can on this page.

Once the shipment is created you get an extra form like this downloaded that you need to print out 3 times.

Hazardous Materials

When selecting the special service of dangerous goods you should see this section appear:

You must specify the HazMat detail, to do this you first need to go to the DG/HazMat tab

and create a new HazMat detail.

Fill in as much detail as you can on this page.

Once the shipment is created you get an extra form like this downloaded that you need to include with the shipment. You will need to utilize the special red backed paper that your FedEx representative can provide.

ORM-D

When selecting the special service of ORM-D you should see this section appear:

For each package that you are sending you need to specify the ORM-D. This is created by going to DG/HazMat tab

and create a new Dangerous Goods detail.

Fill in as much detail as you can on this page.

Once the shipment is created you get an extra form like this downloaded that you need to print out 3 times.

Common Questions

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

Refer to the FedEx HazMat table.

Label Formats

The available label formats can be usually grouped into two types: thermal and non-thermal labels.

Description Values
PDF
  • PAPER_4X6
  • PAPER_4X8
  • PAPER_4X9
  • PAPER_7X4.75
  • PAPER_8.5X11_BOTTOM_HALF_LABEL
  • PAPER_8.5X11_TOP_HALF_LABEL
PNG
  • PAPER_4X6
  • PAPER_4X8
  • PAPER_4X9
  • PAPER_7X4.75
  • PAPER_8.5X11_BOTTOM_HALF_LABEL
  • PAPER_8.5X11_TOP_HALF_LABEL
EPL2
  • STOCK_4X6
  • STOCK_4X6.75_TRAILING_DOC_TAB
  • STOCK_4X8
  • STOCK_4X9_LEADING_DOC_TAB.75
  • STOCK_4X9_TRAILING_DOC_TAB
ZPLII
  • STOCK_4X6
  • STOCK_4X6.75_LEADING_DOC_TAB
  • STOCK_4X6.75_TRAILING_DOC_TAB
  • STOCK_4X8
  • STOCK_4X9_LEADING_DOC_TAB.75
  • STOCK_4X9_TRAILING_DOC_TAB

Limitations

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 ship to/create a return shipment from an APO location?

Shipping to an APO location is not possible with a regular FedEx account. FedEx SmartPost allows customers to ship 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 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.

'Recipient's street can have 2 lines at most'

FedEx only allows two address lines for shipments. You need to review the recipient address and update accordingly.

'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 send oversize boxes, and if yes, where can I mark they are oversize?

Yes, it is possible to create shipments for oversize packages. Oversize charge is applied to any package that exceeds 96 inches in length or 130 inches in length and girth. If you add the dimensions to the package FedEx will automatically apply the charge.

I keep getting an 'invalid address' error for a valid address. Is address validation not working?

FedEx only provides address validation for US addresses. The 'Validate Address' button will still be there for other addresses, but the result might be incorrect..

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.

How do I do an end of day manifest?

FedEx auto manifests the shipments as soon as they are created, so there is no need to do an end of day manifest.

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