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.
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.
|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.|
|FedEx 10kg Box||FEDEX_10KG_BOX|
|FedEx 25kg Box||FEDEX_25KG_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|
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 Shipment is a checkbox field, which requires TRUE value.
Alcohol Recipient Type requires either of these values: CONSUMER or LICENSEE.
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.
In case lithium batteries are included in the shipment, you can default the checkbox by adding FedEx: Lithium Batteries/Cells under Specific Carrier Fields.
You can default the FedEx® by adding the FedEx: FedEx® Delivery Signature Options under Specific Carrier Fields.
In this section you'll find the required or recommended fields and settings for international shipments.
Mandatory fields for Customs items
- Quantity Units
- Unit price
- # of pieces
- Harmonised Code
Package ContentsPackage 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.
For some international shipments a Commercial Invoice is required.
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.
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
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:
- Address Correction
- Carrier Leave If No Response
- Change Service
- Forwarding 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.
Refer to the FedEx HazMat table.
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'
Available label formats
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.
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.
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
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.