page last edited on 24 July 2018
Here’s how you can start using this addon with X-Cart:
Make sure the addon FedEx has been installed and activated at your store.
Make sure your store company address has been configured on the Contact information page (Store setup > Contact information). This address will be used as your store’s “Ship from” address when calculating shipping rates.
Create a FedEx account by registering at FedEx.com - this will get you a User ID and a password. Use your account to obtain a set of credentials for access to FedEx API. The credentials include an authentication key, a password, an account number and a meter number. You will need to enter these credentials in your X-Cart store back end to connect your store to your FedEx account and enable it to exchange information with FedEx services via the API provided by FedEx.
In your X-Cart store back end, go to the FedEx addon settings page.
The addon settings page can be accessed using one of the following methods:
In the Shipping section of your X-Cart store’s Admin area (Store setup > Shipping), click the Add shipping method button: This brings up a popup where you will be able to select the shipping method you require.
On the Carrier-calculated rates tab within the popup, locate the icon/link for FedEx and click on it:
The settings page for the addon FedEx opens.
In the My addons section of your store’s Admin area, locate the addon FedEx and click on the Settings link next to its name:
The settings page for the addon FedEx opens.
Configure the general settings for the FedEx addon using your FedEx account information.
Provide your credentials for API access:
- FedEx authentication key: Specify your authentication key.
- FedEx authentication password Specify your password.
- FedEx account number: Specify your FedEx account number.
- FedEx meter number: Specify your FedEx meter number. A FedEx Meter Number is an identification number that FedEx will use to pull your negotiated rates.
Note that you can test your store’s FedEx integration before going into production. You will need to specify that the addon is going to be used in test mode:
- Test mode: Enable/Disable test mode.
To do the testing, you will also need to use your test credentials for access to the API.
Once you decide to switch your store’s FedEx integration to production mode, you will need to replace the test credentials with your production credentials. You will be able to obtain your production credentials after selecting Move to Production in your FedEx account.
In case of FedEx related issues you will want to enable the logging of requests sent to the FedEx services by the store and of responses received from FedEx by the store. This can be done using the following setting:
- Enable debugging: Enable/Disable request/response logging.
The logs will be saved to fedex.log files in the
In the Carrier types section, specify your preferred FedEx configuration:
- FedEx Express (FDXE): Enable FedEx Express if you want to use this service.
- FedEx Ground (FDXG) : Enable FedEx Ground if you want to use this service. FedEx Ground delivers in 1–7 business days, based on distance to the destination.
- FedEx SmartPost (FXSP): Enable FedEx SmartPost if you want to use this service. FXSP picks up (or accepts drop shipments), provides line haul and delivers your packages to a USPS facility for final delivery by a postal carrier.
If FedEx SmartPost is enabled, the following two settings also become available:
Be sure to adjust them as well.
- Hub ID: Select your Hub ID.
- Indicia: Specify the indicia type.
- Rate request type: Select the type of rates that should be used for your shipments.
- Packaging: Select the type of packaging that should be used for your shipments.
- Dropoff type: Select the type of drop off that should be used for your shipments.
- Ship date (days): Set the number of days until the order is shipped.
- Currency code: If the shipping currency is other than USD, specify it in this field.
- Currency rate: If the currency code specified above differs from the currency the store uses for payments, specify a conversion rate to convert the shipping cost returned by FedEx into your store’s currency. If the currencies are the same, leave this set to 1.
- Package dimensions (inches): Use these fields to define the default package size that should be used for FedEx shipments (Length, Width, Height in inches).
- Maximum package weight: Specify the maximum package weight limit.
If you are going to use special services, configure them in the section Special services: Note that special services may imply extra fees.
The section Cash on delivery shows the status of your cash on delivery option for Fedex shipments. Note that this status may not be changed from the FedEx addon setting page directly. To change the status, you will need to go to the Payment settings section of your X-Cart store back end. To do that, you will need to either follow the link in the help note: or simply go to Store setup > Payment methods via the Admin menu.
Important: Cash on delivery method of payment is not available for all FedEx services. Before enabling FedEx COD for your customers, you should contact FedEx to find out which services support COD.
In the Payment settings section, you will find the setting to toggle the cash on delivery option for FedEx next to the name of your FedEx method in the Offline methods list: The status of this setting will be reflected on the FedEx addon settings page. (You may have to refresh the addon settings page to see the correct current status. But be sure to save any unsaved addon settings before refreshing the page.)
After the activation of the cash on delivery option for FedEx, another setting will be added in the Cash on delivery section of the FedEx addon settings page: COD type. Use this setting to select the type of funds that should be collected by FedEx upon package delivery.
Adjust the settings in the Advanced options section as you require. Note that not all FedEx Carrier Services support the advanced options, so please consult FedEx support before using them.
Note that advanced options may affect the shipping rates calculation and may imply extra fees.
Be sure to save your FedEx configuration by clicking the Submit button at the bottom of the page. Once your basic FedEx configuration has been saved, another tab will be added on the FedEx addon settings page: Carrier Services.
Proceed to the Carrier Services tab to specify the set of FedEx carrier services that should be used for shipment. The carrier services you specify here will be available to your customers at checkout if the conditions from the FedEx Settings tab are met.
On the Carrier Services tab, you can enable/disable FedEx carrier services, change the services sort order and apply tax classes to shipments, if applicable.
By default, carrier services are sorted alphabetically. If you want to change the sort order, you can drag-n-drop the carrier services to re-adjust their positions. During checkout, the available shipping methods will be displayed to your customers in the very same order in which they are shown on the Carrier Services tab.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.