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

In order to create a Preference for FedEx in the Multi-carrier application please obtain the credentials below directly from the carrier. Typically this information is obtainable from your carrier account manager or your internal logistics team.

How to Test

If you don't have your live credentials available during implementation phase, Zenkraft can provide test credentials. Click on the Use Test Account toggle and select the Test Account Country from the dropdown.

Service Types

Service Types Value Description
FedEx 1 Day Freight 1_day_freight - Copy
FedEx 2 Day 2_day - Copy
FedEx 2 Day AM 2_day_am - Copy
FedEx 2 Day Freight 2_day_freight - Copy
FedEx 3 Day Freight 3_day_freight - Copy
FedEx Express Saver express_saver - Copy
FedEx First Freight first_freight - Copy
FedEx Freight Economy freight_economy - Copy
FedEx Freight Priority freight_priority - Copy
FedEx Ground ground - Copy
FedEx First Overnight first_overnight - Copy
FedEx Ground Home Delivery ground_home_delivery - Copy
FedEx Priority Overnight priority_overnight - Copy
FedEx Smart Post Media MAil smart_post_media_mail - Copy
FedEx Smart Post Parcel Select smart_post_parcel_select - Copy
FedEx Smart Post Presorted Bound Printed Matter smart_post_presorted_bound_printed_matter - Copy
FedEx Smart Post Presorted Standard smart_post_presorted_standard - Copy
FedEx Smart Post Parcel Return smart_post_parcel_return - Copy
FedEx Standard Overnight standard_overnight - Copy
FedEx Europe First International Priority europe_first_international_priority - Copy
FedEx International Economy international_economy - Copy
FedEx International Economy Freight international_economy_freight - Copy
FedEx International First international_first - Copy
FedEx International Priority international_priority - Copy
FedEx International Priority Express international_priority_express - Copy
FedEx International Priority Freight international_priority_freight - Copy
FedEx Next Day Early Morning next_day_early_morning - Copy
FedEx Next Day Mid Morning next_day_mid_morning - Copy
FedEx Next Day Afternoon next_day_afternoon - Copy
FedEx Next Day End of Day next_day_end_of_day - Copy
FedEx Economy distance_deferred - Copy
FedEx Next Day Freight next_day_freight - Copy
FedEx Regional Economy regional_economy - Copy
FedEx International Connect Plus international_connect_plus - Copy
FedEx First first - Copy
FedEx Priority priority - Copy
FedEx Priority Express priority_express - Copy
FedEx International Priority international_priority - Copy
FedEx International Express international_express - Copy
FedEx Transborder Distribution transborder_distribution - Copy

Packaging Types

Packaging Types Value
FedEx 10KG Box fedex_10kg_box Copy
FedEx 25KG Box fedex_25kg_box Copy
FedEx Box fedex_box Copy
FedEx Envelope fedex_envelope Copy
FedEx PAK fedex_pak Copy
FedEx Tube fedex_tube Copy
Your Packaging your_packaging Copy

Reference Types

Reference Types Value
Customer Reference ref Copy
Customer Reference customer_reference Copy
Customer Reference reference Copy
Department Number department_number Copy
Invoice Number invoice_number Copy
P O Number p_o_number Copy
RMA Number rma_number Copy

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.

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

Returns

QR code returns

QR code returns are available with our FedEx (API) integration. Please make sure to acquire the necessary credentials and authorization through your FedEx account manager.

Once your account is authorized you can add the FedEx (API): Include QR special service to your Custom Address Source.

Pickups

  • Ground - Next business day, cannot take anything other than Ground, pickup date needs to be in the future
  • Express - Same day, cannot take anything other than Express shipments, pickup date can be same day or future date

Email Notifications

FedEx SmartPost®

FedEx One Rate®

Hazardous Materials

Label Formats

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

Label Types Value
PDF PDF Copy
PNG PNG Copy
EPL2 EPL2 Copy
ZPLII ZPLII Copy
ZPL ZPL Copy

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.

Shipping to/from Puerto Rico

FedEx recognizes shipments from Puerto Rico (PR) destined to the United States (US) as INTERNATIONAL, and requires duty and tax payment terms, and full commodity data to be included with the shipment.

Is domestic shipment available in my country?

Domestic shipments are not supported in every country. Please find below the list of locations where intra-country shipments are supported:

  • Austria
  • Belgium
  • Canada
  • Colombia
  • Czech Republic
  • Denmark
  • Finland
  • France
  • Germany
  • Hungary
  • India
  • Italy
  • Luxembourg
  • Mexico
  • Norway
  • Poland
  • Spain
  • Sweden
  • Switzerland
  • The Netherlands
  • United Arab Emirates
  • United Kingdom
  • United States

Error Messages

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

'Authentication failed'

If you are using a test account please turn Demo mode ON. If you are using a live account please turn Demo mode OFF.

'CarrierCodeType FXSP is invalid'

This is always accompanied by another error message detailing the exact issue, ie. missing post code, incorrect service type etc.

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.

If your commodity value is less than 2500USD you might still see this issue due to different Export Control regulations. We recommend reading through this guide or contacting FedEx for up-to-date information.

'Unable to retrieve Letterhead and/or Signature images.'

Sometimes these images get corrupted over time and therefore FedEx is unable to retrieve them.
Solution: Re-upload the letterhead and signature images and set the default to these newly uploaded images.

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.

Can I use FedEx Regional Economy and FedEx Regional Economy Freight?

Yes. If these services are enabled on your account you can use them in our application as well.
FedEx Regional Economy: A new intra-Europe, day-definite, customs-cleared, door-to-door economy cost effective service for less urgent shipments up to 68kg per package
FedEx Regional Economy Freight: A new intra-Europe, day-definite, customs-cleared, door-to-door cost effective economy service for less urgent shipments above 68kg per package

Can I use last minute rates?

No, unfortunately FedEx Last Minute Rates are not available via their API.

Can I print on a tear away label?

If you use the label type of ZPLII STOCK_4x6.75_LEADING_DOC_TAB then it will leave the top 3/4 inch of the label blank (which would be the tear away part).

Back to Top