Zenkraft is now called Bringg on Salesforce Read More
  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.

NOTE: If the billing address is not accepted please try to insert the shipping address and vice versa.

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 (v1.114 and below) or Bringg Settings (v1.118 and above) 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

Reference Types

There are five different references available with FedEx.

  • FedEx: Your Reference
  • FedEx: P.O. Number
  • FedEx: Invoice Number
  • FedEx: Department Number
  • FedEx: RMA Number / only available for returns

NOTE: If you are using SmartPost only one reference will be displayed on the label.

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.

Saturday Delivery

Saturday Delivery can be enabled if:

  • It is available for the selected destination
  • The service type supports Saturday delivery
  • In case of Next Day Delivery service the shipping date is a Friday

If Saturday delivery is available you can select it in the shipping wizard:

Or mapped from the custom address source:

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

Dry ice is used for shipping products that need to be kept cool or frozen during shipping.

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.

Non Standard Packaging

For the full definition of non-standard packaging please visit the FedEx guide.

FedEx Priority Alert

Please visit the FedEx website for more information on FedEx Priority Alert.

Returns Clearance

Please visit the FedEx website for more information on Returns Clearance.

FedEx Ground COD

FedEx Ground Collect On Delivery is a service where payment for the package is collected upon delivery.

Hold at FedEx Location

It is possible to request a package to be delivered to the nearest or preferred FedEx location. Check the Fedex Hold at Location special service. In the wizard you will see the address fields.

You can either fill these in manually or select one of the locations listed below. These suggested locations are the closest to the address specified in the Recipient section.

Once you select your location the address details will be filled automatically.

You can also default these fields from the Custom Address Source. Go to Carrier Specific Fields and look for "hold" in the template search box.

You will see a list of fields where you can add the address details.

Delivery Signature

There are different delivery signature options available to confirm that a package was delivered.

You can default the signature options 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.

We include the most common quantity units here:

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

QUANTITY: This is the total quantity of an individual commodity within the shipment.
Example: if you are shipping ten individual golf balls in a single package, then the Quantity Unit should be Each and the Quantity 10. If these same golf balls are shipped in two separate packages, then the Quantity remains 10, but the Number of Pieces will change (see below). If these golf balls are packaged in two boxes of 5, then your quantity should be 2.

NUMBER OF PIECES: This is the total number of packages in the shipment that contain this item.
Example: if you are shipping ten individual golf balls in a single package, then the Number of Pieces should be 1. If these ten golf balls are divided into two packages, each having it's on label, then the Number of Pieces should be 2.

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.

Broker Details

You can add your broker details to the shipment and commercial invoice.

If the special service is selected, you can manually enter the information in the shipping wizard:

Our you can map it from the Custom Address Source. Make sure you enable the "FedEx: Broker Select Option" is enabled, otherwise the rest of the details will not be visible.

EEI/AES filing

For international shipments from the US over $2500 in value an AES citation needs to be submitted. You need to file via AESDirect to get an exception number. This reference needs to be entered in the Export Compliance Statement field.

If you do your filing before creating the shipment you can store the exception number on the record and map automatically via the CAS.

For other filing options please visit the FedEx EEI Portal.

Personal Customs Clearance Code (PCC)

Shipping to some countries might require you to use a PCC code. You can add that to the Recipient TIN (Tax Identification Number) using Business National type.

IOSS Number

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.

B13 Filing

Please contact FedEx International Services to help you file the B13 form.

Commercial Invoice

For most international shipments a Commercial Invoice is required. By setting up a commercial invoice template and adding it either manually within the wizard or automatically via the Custom Address Source, 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 receive an error like this: A FedEx generated commercial invoice is prohibited for the shipment

Other Documents

If you have any other externally created documents you want to send to FedEx you can add them to Other Documents.

Upload Documents

It is possible to upload documents created outside of the Multi-Carrier application. The documents need to be stored on your original object, so for example if you are shipping from an Order object, you need to store the files that you would like to upload on the Order object under the Notes and Attachments or the Files related list. You also need to name the file according to the document type.

For example, if you want to upload a commercial invoice, name your file [COMMERCIAL_INVOICE]your_file_name

Uploading your document WHEN creating the shipment

Using this method you can upload the external document with the shipment creation request.

Go to the Custom Address Source, edit it, and scroll down to Enhanced Functionality Settings. You need to set the following information:

  • All Carriers: International Documents: Parent Id - this should be the Salesforce ID of the record you are creating the shipment from
  • All Carriers: International Documents: Storage Type - this determines the document storage type
  • All Carriers: International Documents: Filter (SoQL condition) - this decides what kind of document to use
  • All Carriers: International Documents: Save documents to shipment record - you can either move of copy the document over to the Shipment

The process runs when the shipment is created. It is possible to set a Success and an Error field too:

Uploading your document AFTER creating the shipment

NOTE: Only available from v1.113.1
Using this method you can upload the external document after the shipment is already created.

Go to the Custom Address Source, edit it, and scroll down to Carrier Specific Settings. Add "FedEx: Enable Post Shipment Upload" and set it to TRUE.

By setting this option you are creating an open shipment to which you can later attach additional documents and you can then utilize the UploadETD invocable method via a process builder to upload your documents.

Below is an example of the process builder that you can set up. In this example the process runs after the shipment is created and we are getting the necessary IDs via field reference.

  • Salesforce Object Id - specify the salesforce ID of the object that holds the files to be uploaded
  • Attachment Or File - specify File or Attachment, depending on how you store your documents
  • SoQL Condition - specify the criteria to choose the files to upload. You might have a situation where you store other files but only want to upload the PDF documents. An example value you could use is : FileType= 'PDF'
  • Tracking Number - please specify the tracking number of the shipment the document is connected to
  • Custom Address Source Id - please specify the custom address source Salesforce id that was used to create this shipment
  • Preference ID - please specify the shipping preference Salesforce ID that was used for this shipment
  • Save documents to shipment record (optional) - you can copy or move the uploaded documents to be stored on the shipment

Error Handling

From v1.113 onwards it is possible to map and error handler field in the custom address source to display any error message provided by the carrier in the API response.


It is possible to create a Custom Address Source specifically for returns. (If you need help setting up a Custom Address Source please use this guide.) In the Custom Address Source the Shipment Type should be set to Return.

Under Specific Carrier Fields you can set the FedEx: Return Type. This is required for international shipments. For more information on return types please visit the FedEx website.

Multi-package returns

Please note that FedEx does not support multi-package returns. If you need to ship multiple packages you need to create a separate return shipment for each package.

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:


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

  • FedEx SmartPost® Parcel Select - PARCEL_SELECT
  • FedEx SmartPost® Parcel Select Lightweight - PRESORTED_STANDARD
  • FedEx SmartPost® Bound Printed Matter - PRESORTED_BOUND_PRINTED_MATTER
  • FedEx SmartPost® Media - MEDIA_MAIL

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 - ADDRESS_CORRECTION
  2. Carrier Leave If No Response - CARRIER_LEAVE_IF_NO_RESPONSE
  3. Change Service - CHANGE_SERVICE
  4. Forwarding Service - FORWARDING_SERVICE
  5. Return Service - 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

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.


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
  • 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 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

Back to Top