Setting up FedEx for Shipping Quotes
What We'll Cover
This guide explains how to set up a FedEx developer account and integrate it into your BigCommerce store in order to serve your shoppers shipping quotes for FedEx services. See Resources for Shipping with FedEx for more information about service limits, rate calculation, and troubleshooting common issues and errors.
Getting your FedEx Account Details
If you haven't already, sign up for a FedEx account by going here.
1. Go to the FedEx Developer Resource Center's Solution Finder and click on FedEx Web Services (located under Home on the left-hand side).
2. Click the Move to Production link.
3. Click on the Get Production Key that appears under the production menu.
4. On the following page, you will see a license agreement. Check the boxes indicating that you have read and agree to the terms of service, then click I Accept.
5. Fill out the application profile on the following screen. Choose:
- Do you intend to resell your software: No
- FedEx web services you intend to use: Check FedEx Web Services for Shipping
- Are you a corporate developer or a consultant: Choose Corporate Developer
Click Continue when you are done.
6. You will be brought to another license agreement. Read the terms and conditions and click I accept when you are finished.
7. Now you will need to fill out your contact information. Please note that you cannot have any special characters within the address fields. Watch out for ".", "#", or other non-number or non-letter characters as it may cause a failure. Click Continue when you are done.
Your Account Number can be found by logging into your FedEx account and going to My Profile › Account Management.
8. If you wish to update your developer account with the information, check the box on the next screen, and click the Continue button.
9. You will now see your Access confirmation. This information, which includes the Authentication Key, will not be accessible later unless you contact FedEx support; we recommend that you print this page for your records.
10. In the email associated with your FedEx account, you should now have received an email from FedEx.com Online Services with the subject line, "Your developer Production Key Registration is complete". It contains your Production Password, FedEx Account Number, and Production Meter Number. Use this production password as your password in the following step, not the one you created to access the FedEx account.
Adding the FedEx Shipping Method in BigCommerce
After following the steps above, you should have the following data:
- Authentication Key (from Step 9 above)
- Production Password (from FedEx.com Online Services email)
- FedEx Account Number (from FedEx.com Online Services email)
- Production Meter Number (from Step 9 above or FedEx.com Online Services email)
1. Log in to your store's control panel in BigCommerce.
2. Go to Store Setup › Shipping.
3. Click Configure or Edit beside the zone for which you wish to setup FedEx.
4. Turn on the toggle switch beside FedEx.
5. In the Settings tab, you can adjust your Display name, which your shoppers see when selecting the delivery method at checkout and when estimating shipping and tax on the cart page. Configure your settings for Drop-off Type, Packaging Type, Packing Method, Rate Type, Include Package Value and Destination Type. For Delivery Services, check the box next to the services you want to provide quotes for.
If no package value is declared, by default, FedEx is only liable up to $100 for each package in a shipment.
6. Under the Connection tab, enter your Key, Password, Account Number and Meter Number provided by FedEx.
7. Save your changes. You can test your settings are working by editing the FedEx shipping method and going to the Get Quote tab. You should also do some front-end testing so you can see what the quoting process looks like to your shoppers.
- FedEx support
- FedEx weight, length and girth limits
- Service specifics and rate calculation
- FedEx real time quotes common issues and errors
FedEx’s dedicated support site has answers, information, and resources to assist you will all your shipping needs. There you can find service details and contact information.
- Phone support: 1-800-GOFEDEX (1-800-463-3339)
- Web support: http://www.fedex.com/us/customersupport
FedEx Weight, Length and Girth Limits
|Service||Weight Limit||Dimensions Limit|
|FedEx Express US||150 lbs||119" length; up to 165" length + girth combined|
|FedEx Express International||150 lbs||108" length; up to 130" length + girth combined|
|FedEx Ground*||150 lbs||108" length; up to 165" length + girth combined|
|FedEx Home Delivery**||70 lbs||108" length; up to 165" length + girth combined|
|FedEx Express Freight||Individual skids of 150 lbs or more||Skids exceeding 2,200 lbs or 70" height, 119" length, or 80" width require prior approval|
FedEx also includes good information on their website regarding general packing and shipping best practices and recommendations.
Service Specifics and Rate Calculation
FedEx details delivery times and service availability areas for all services in their FedEx 2016 Service Guide (PDF). FedEx Ground is for commercial shipments, while FedEx Home Delivery is for residential shipments. Home-based businesses do not qualify as a commercial address.
FedEx also provides a Rate and Transit Time Calculator. Using this in conjunction with the Service Guide can prove useful when trying to which FedEx services make the most sense for you, your products, and your customers. This tool can also help identify any additional handling fees or surcharges that are being returned with your quotes, which are not expressly lined out to customers on the storefront, or you in the control panel.
- girth (2 x width) + (2 x height)
- dimensional weight
- distance traveled (fuel surcharge)
- declared value (the combined retail value of all the items inside a package)
- the origin zip code
- destination type (residential or commercial address)
- destination zip code (Delivery area surcharge)
- packaging type (yours or FedEx-supplied)
- service type (e.g. Ground, Express, Home Delivery)
- negotiated pricing for your specific FedEx account
- any additional handling fees or surcharges for shipments exceeding FedEx's limits (see Fees and Other Shipping Information in FedEx's Service Guide)
FedEx Real Time Quotes Common Issues and Errors
Symptom: Returned quotes on the storefront are higher than what is displayed on FedEx's Rates and Transit Times Calculator.
- The package calculated by BigCommerce is heavier or larger than the dimensions you've entered into FedEx's Rates and Transit Times Calculator for comparison.
- One or more of the packages dimensions is exceeding FedEx's limits and has additional handling fees or surcharges included in the returned quote. These charges are lined out on FedEx's calculator but are not explicit when returning a quote on the BigCommerce's storefront or control panel. (See Fees and Other Shipping Information in FedEx's Service Guide)
- Declared value wasn't inputted/considered when calculating the shipment on UPS's Time and Cost Calculator.
- Declared value isn't enabled in your FedEx control panel settings.
- Some merchants who sell small yet expensive products, like jewelry, prefer to use cost instead of price for package value. Disabling Include Package Value may result in more accurate quotes in this case.
- Some Canadian merchants prefer to use USD as their default currency. Shipping from Canada to Canada will cause an error and prevent the quote from being generated. Disabling Package Value can solve for this.
- The Packing Method in your FedEx settings is set to "Each item in its own package".
Symptom: Certain services completely fail to return a quote.
- The package may exceed FedEx's maximum serviceable length for that particular service. Minor overages will trigger additional handling fees and surcharges as mentioned above, but extreme overages may render the package completely incompatible, thus failing to return a quote at all.
- The destination address or country may fall outside of that particular service's specific service area.
- The origin zip code may be wrong or incomplete. Where possible, use the full nine-digit zip code for your origin address ("shipping from" address) in the Shipping Manager.
Common causes for errors include:
- Incorrect credentials
- No service selected or a setting not selected
- Using FedEx Ground instead of Ground Home Delivery
- Trying to send to an unserved country
For a complete list of FedEx errors, see FedEx's Appendix O: Error Codes.