WooCommerce / FedEx LTL Freight

/WooCommerce / FedEx LTL Freight
WooCommerce / FedEx LTL Freight2018-11-22T21:47:45+00:00

LTL Freight Quotes

FedEx Freight Edition for WooCommerce

FedEx Freight is the freight operating unit of FedEx (NYSE: FDX) and is headquartered in Memphis, Tennessee. FedEx Freight is the largest LTL carrier in the United States. It offers a variety of LTL freight services throughout the United States and Canada, and to Mexico, Puerto Rico, and the U.S. Virgin Islands. If you don’t have a FedEx Freight account number, contact them at 800-463-3339, or register online.

Features

Displays negotiated LTL shipping rates in the shopping cart.

Provides quotes for shipments within the United States and to Canada.

Define a custom label to identify the LTL freight rate in the cart.

Elect to display carrier transit times with rate estimates.

Define multiple warehouses.

Identify products that drop ship from vendors.

Product specific shipment parameters: weight, dimensions, freight class.

Option to set a product’s freight class automatically through the built in density calculator.

Support for variable products. Shipment parameters can be set differently for each product variation.

Compatible with the Residential Address Detection plugin. Allows the residential delivery fee to be dynamically added to freight quotes when a residential address is detected.

Multiple options for lift gate delivery service.

Option to mark up shipping rates by a set dollar amount or by a percentage.

Works seamlessly with other quoting apps published by Eniture Technology.

Current version: 1.1.1

Requirements

WooCommerce 3.0 or newer.

A FedEx billing account number.

A FedEx shipper account number. This is particular to FedEx freight enabled accounts. It may or may not be the same as your billing account number.

Your username and password to FedEx.com.

Your FedEx API Authentication Key.

FAQ’S

How do I get a FedEx Freight account number?

Call FedEx at 800-463-3339, or register online.

Where do I find my FedEx username and password?

Contact FedEx Freight customer service (800-463-3339) or the FedEx account manager assigned to your account.

How do I get a license key for the plugin?

You must register your installation of the plugin, regardless of whether you are taking advantage of the trial period or purchased a license outright. At the conclusion of the registration process an email will be sent to you that will include the license key. You can also login to eniture.com using the username and password you created during the registration process and retrieve the license key from the My Licenses tab.

How do I change my plugin license from the trial version to one of the paid subscriptions?

Login to eniture.com and navigate to the My Licenses tab. There you will be able to manage the licensing of all of your Eniture Technology plugins. Refer to the Documentation tab on this page for more thorough instructions.

How do I install the plugin on another website?

The plugin has a single site license. To use it on another website you will need to purchase an additional license. If you want to change the website with which the plugin is registered, login to eniture.com and navigate to the My Licenses tab. There you will be able to change the domain name that is associated with the license key.

Do I have to purchase a second license for my staging or development site?

No. Each license allows you to identify one domain for your production environment and one domain for your staging or development environment. The rate estimates returned in the staging environment will have the word “Sandbox” appended to them.

Why isn’t the plugin working on my other website?

If you can successfully test your credentials from the Connection page (WooCommerce > Settings > FedEx Freight > Connections) then you have one or more of the following licensing issues: 1) You are using the license key on more than one domain. The licenses are for single sites. You will need to purchase an additional license. 2) Your trial period has expired. 3) Your current license has expired and we have been unable to process your form of payment to renew it. Login to eniture.com and go to the My Licenses tab to resolve any of these issues.

Why are the shipment charges I received on the invoice from FedEx Freight different than what was quoted by the app?

Common reasons include a difference in the quoted versus billed shipment parameters (weight, dimensions, freight class), or additional services (such as residential delivery) were required. Compare the details of the invoice to the shipping settings on the products included in the shipment. Consider making changes as needed. Remember that the weight of the packing materials is included in the billable weight for the shipment. If you are unable to reconcile the differences call FedEx Freight customer service (800-463-3339) for assistance.

Why do I sometimes get a message that a shipping rate estimate couldn’t be provided?

There are several possibilities:

The most common reason is that one or more of the products in the shopping cart did not have its shipment parameters (weight, dimensions, freight class) adequately populated. Check the settings for the products on the order and make corrections as necessary.

The city entered for the shipping address may not be valid for the postal code entered. A valid City+State+Postal Code combination is required to retrieve a rate estimate. Contact us by phone (404-369-0680) or email (support@eniture.com) to inquire about Address Validation solutions for this problem.

Your shipment exceeded constraining parameters of FedEx’s web service.

The FedEx web service isn’t operational.

Your FedEx account has been suspended or cancelled.

There is an issue with the Eniture Technology servers.

Your subscription to the application has expired because payment could not be processed.

There is an issue your server.

How do I determine the freight class for my product(s)?

The easiest thing to do is to contact your FedEx Freight representative and ask for assistance. However, the official source is the National Motor Freight Classification (NMFC) directory maintained by the National Motor Freight Transportation Agency (NMFTA.org). You can purchase a hard copy of the directory or obtain an online subscription to it from their web site.

How does the density calculator work?

The density calculator will calculate a freight class by performing a calculation using the product weight and dimensions as inputs. In most cases the returned freight class will match the product’s (commodity’s) freight class as recorded in the National Motor Freight Classification (NMFC) directory. However, this is not always true and in the event there are differences, the freight class recorded in the National Motor Freight Classification (NMFC) directory takes precedence. An incorrectly identified freight class can result in unexpected shipping charges and even fees. You are solely responsible for accurately identifying the correct freight class for your products. If you need help doing this, contact your FedEx Freight representative for assistance.

Installation & User’s Guide

If you are taking advantage of a trial subscription, the plugin will stop working when the trial period ends. Be sure to read the Manage Your License section to learn how to upgrade your subscription.

Overview

Setting up the plugin consists of seven steps:

Other information contained in this guide:

1. Download the Installation File

Return to top.

Select a subscription package. You will be presented with a registration form. The email address and password you enter will serve as your credentials to eniture.com. Use these to gain access to your customer dashboard where you can download the plugin installation file, manage your licenses and update your payment information. When you download the plugin installation file, be sure to save it to a familiar location. You will need to navigate to the file during the installation process.

Note: If you obtained the plugin installation file from the WordPress Plugin Directory, you still need to select a subscription package and complete the registration form.

2. Install the Plugin Application File

Return to top.

Login to the WordPress dashboard as the website administrator.

In the left sidebar, hover your mouse over the Plugins menu to display the sub-menu options.

Select Add New from the sub-menu options. The Add Plugins page will load.

At the top of the Add Plugins page, click on the Upload Plugin button.

upload_plugin

Controls will appear in the middle of page that will allow you to chose and install the plugin application. Choose the Choose File button, navigate to the location where you saved the installation file and select it.

choose_file

Click the Install Now button.

WordPress will display information about the installation progress at the bottom of the page. The plugin has been installed once the message Plugin installed successfully is displayed.

3. Activate the Plugin

Return to top.

Once the plugin has been installed, it must be activated. If you are still on the same page that you were on at the end of Step 2, you can click the Activate Plugin link on the bottom of the page.

If you’ve already navigated away from that page, select Installed Plugins from the Plugins menu.

installed_plugins

Locate the LTL Freight Quotes – FedEx Edition plugin on the list and click the Activate link.

4. Obtain a FedEx API Authentication Key

Return to top.

To successfully connect the app to FedEx Freight you need a FedEx API Authentication key. If you don’t have one, sign into the FedEx Developer Resource Center (click here) using your FedEx.com username and password.On the left hand side of the page, click on FedEx Web Services then locate and click on the link for Move to Production.

fedex-move-to-production

Click on the Get Production Key button in the Moving to Production section.

fedex-get-production-key

On the Application Profile page, answer the questions with the following responses, and then click the Continue button.

Do you intend to resell your software? No
Please check the box to each type of FedEx web services you intend to use in your integration solution: Check the option for FedEx Web Services for Shipping
Please indicate whether you are a developing your FedEx integration solution as a Corporate Developer or as a Consultant. Corporate Developer

fedex-application-profile

On the License Agreement page click the I Accept button to advance to the next step.

The next two steps will ask you to provide information about your company’s account and contact information, and your developer info. On the Developer Info page enter the name and contact information of the person or firm who performs most of the work and maintenance on your website.

When you complete the steps you will be delivered to the Confirmation page. Your Production password will be emailed to you. The Confirmation page will contain your Authentication Key and your Meter Number. Record all of these values. You will use them to establish the connection to FedEx Freight in the next step.

fedex-api-confirmation-2

5. Configure the Plugin

Return to top.

Select Settings from the WooCommerce menu.

woocommerce_settings

Click on the FedEx Freight tab to gain access to the plugin configuration settings.
Use the links at the top of the page to navigate between the Connection, Quote and Warehouse settings. Start with the Connection Settings.

5a. Connection Settings

Return to top.

Billing Account Number Your FedEx billing account number. This is always the main account number on the account and is almost always the account number you would use if you were shipping a parcel shipment. If you don’t have one please contact FedEx.
Meter Number The Meter Number received when you completed the process for obtaining the Authentication Key in the previous step.
Password The Production Password that was emailed to you when you completed the process for obtaining the Authentication Key in the previous step.
Authentication Key Your FedEx API Authentication Key. This is the Authentication Key you retrieved in Step 2 of these instructions.
Shipper Account Number FedEx Freight identifies a specific account number for what it refers to as the “Shipper Account Number”. Often it is the same as the Billing Account Number, but not always. If you aren’t sure, contact FedEx Customer Support.
Billing Address The billing address on record for the main FedEx account.
Physical Address The physical address associated with the Shipper Account Number.
Third Party Account Number FedEx Freight will issue a different account number if your shipments have origin and destination addresses that don’t match the address on file. This is common if you tend to drop ship items from vendors to customers or suppliers. If you have one of these account numbers, enter it here.
Plugin License Key The plugin license key is issued by Eniture Technology to registered users only. If you don’t have a plugin license key, click the link to the right of this field to obtain one.

When you’re done save your connection settings and then test them by clicking on the Test Connection button at the bottom of the page. A message will display at the top of the page letting you know if the plugin succeeded in establishing a connection to the FedEx Freight servers. If you receive an error, confirm the values you entered and try again. Be particularly attentive to capitalization. Most of the information you enter on this page is case sensitive.

5b. Quote Settings

Return to top.

Label As Identify how you want the quote labeled in the checkout process. A common choice for this field is “LTL Freight” or “FedEx Freight”. If left blank quotes will be labeled “Freight”.
Show Delivery Estimate When checked, the carrier’s estimated transit time will be displayed.
Always quote residential delivery When checked, the quotes returned will always include the carrier’s residential delivery fee.
Auto-detect residential addresses Through the use of an addon plugin titled Residential Address Detection, Ship To addresses are checked against database records from the USPS. When the address is identified as residential, the residential delivery fee is included in the rate estimates. If the message “Click here to add the Residential Address Detection module.” is present, then the addon plugin is not installed. Click on the link to install it if you’d like to use this feature. (Learn more)
Auto-renew Displays only if the Residential Address Detection plugin is installed.
Choose a plan that best meets your needs. The credit card associated with quote plugin license will be billed immediately and the plan will become your current plan. Your choice will be retained for the auto-renew option. You can change your auto-renew selection at any time. Plans automatically renew at the end of every monthly billing cycle or upon the depletion of the current plan. To prevent a renewal, choose Disable from the list of options.
Current plan Displays only if the Residential Address Detection plugin is installed.
Displays information about the current plan and the start and end dates of the current subscription period.
Current usage Displays only if the Residential Address Detection plugin is installed.
Displays information about the consumption of the current plan. The date shown is the UTC timestamp of the last time a residential address detection event occured.
Suspend use Displays only if the Residential Address Detection plugin is installed.
Checking this box temporarily suspends the Residential Address Detection plugin. It does not permanently disable it and if the current monthly billing cycle expires, a new plan will be activated. To disable the plugin, deactivate it or choose Disable from the Auto-renew drop down.
Always quote lift gate delivery When checked, the returned quotes will include each carrier’s lift gate delivery fee.
Offer lift gate delivery as an option An additional option for LTL freight will be offered that includes the lift gate delivery fee.
Always include lift gate delivery when a residential address is detected Displays only if the Residential Address Detection plugin is installed.
When enabled, if a residential delivery address is detected the lift gate delivery fee will be included in the shipping rate estimate. In such cases, the option to Offer lift gate delivery as an option will be suppressed, even if enabled. Enabling both the Offer lift gate delivery as an option setting and the Always include lift gate delivery when a residential address is detected setting allows commercial customers to choose whether or not lift gate service is needed while always requiring it for residential customers.
Handling Fee / Mark Up Increases the amount of the returned quote by a specified amount prior to displaying it in the shopping cart. The number entered will be interpreted as dollars and cents unless it is followed by a % sign. For example, entering 5.00 will cause $5.00 to be added to the quotes. Entering 5.00% will cause each quote to be multiplied by 1.05 (= 1 + 5%).
Show WooCommerce shipping options (Yes|No) Permit or prevent the display of shipping rates from other plugins.
Return FedEx Freight quotes when an order’s parcel shipment weight exceeds 150 LBS When checked, the LTL Freight Quote plugin will return quotes when an order’s total weight exceeds 150 lbs (the maximum permitted by FedEx and UPS), even if none of the products have settings to indicate that it will ship LTL. To increase the accuracy of the returned quote(s), all products should have accurate weights and dimensions.

5c. Define Warehouse and Drop Ship Locations

Return to top.

Click the Add button in the appropriate sections to add warehouse and drop ship locations. Warehouses should have a complete inventory of all products not otherwise identified as drop shipped items. If you have more than one warehouse defined, the warehouse closest to the shopper will be used to retrieve shipping rate estimates. You should define at least one warehouse, even if all of your products are drop shipped. This insures that quotes will be returned in the event the drop ship location was overlooked when the product entry was created.

Drop ship locations usually represent vendors that supply items that you don’t inventory. These items are shipped directly to your customer on your behalf. When an order includes drop shipped items the shopping cart will display a single figure for the shipping rate estimate that is equal to the sum of the cheapest option for each shipment required to fulfill the order.

6. Enable the Plugin (WooCommerce 3.0 or later only)

Return to top.

Select Settings from the WooCommerce menu.

woocommerce_settings

Click on the Shipping tab and select the option for Shipping Zones.

The shipping method needs to be added to a shipping zone. If an appropriate shipping zone isn’t already defined, click the Add shipping zone button and define one.

Now add the shipping method to the zone. Click on the “+” inline with the shipping zone…

…select the FedEx Freight option from the drop down list of shipping methods…

…and click on the Add shipping method button.

Repeat this process for each shipping zone you want to the app to return quotes for. You should test each zone to make sure the geography defined by the shipping zone is supported by the app.

7. Product Settings

Return to top.

Navigate to your product list in the WordPress Dashboard by selecting Products from the Products menu.

products_products

Select the product you want to ship LTL freight from the list. Once you’re on the Edit Product page, locate the Product Data region and click on the Shipping option to access the product’s shipping characteristics.

Weight Enter the weight of the product in pounds.
Dimensions Enter the dimensions of the product in inches.
Shipping Class If you have the Small Package Quotes plugin installed and you want the product to be quoted as shipping parcel, select the No shipping class option.

If you have the LTL Freight Quotes plugin installed and you want the product to be quoted as shipping LTL freight, select the LTL Freight option.

Enable Drop Ship Location This option will only be visible if there are drop ship locations defined. Refer to Step 5c: Define Warehouse and Drop Ship Locations for instruction on how to define drop ship locations.

Check this box if this product ships from a drop ship location.

Drop Ship Location This option will only be visible if there are drop ship locations defined. Refer to Step 5c: Define Warehouse and Drop Ship Locations for instruction on how to define drop ship locations.

If the product is drop shipped, select the drop ship location from the list of options.

Freight Classification This option will only be visible if the LTL Freight Quotes plugin is installed.

Select the freight class for the product from the list of options. If you utilize both small package (parcel) and LTL freight shipping methods, you should identify the freight class for all products, even those that normally ship small package (parcel).

The last option in the list of freight classifications is Density Based. In most cases this is an industry accepted alternative for identifying the freight class of an item or shipment. Validate the returned quotes if using this setting. There are exceptions in the NMFC Freight Classification Directory that can render the density calculator results invalid for particular commodities. To be used successfully the product must have its weight and dimensions populated in the Shipping sub-panel.

If your product is a Variable Product, set the shipping parameters for each product variation on the Variations page.

When you are done click the Update button located in the Publish widget located at the top right of the page.

What Your Customer Sees

Return to top.

To facilitate the successful conclusion of an online purchase the plugin always attempts to return an estimate of shipping charges. If multiple products are in the shopping cart and some are missing weight, dimensions or both, the plugin will use what is available to obtain the shipping rate estimates. For example, if you have two products in the shopping cart and the first has weight and dimensions and the second does not, the shipping rate estimate will be based solely on the first product. The plugin will fail to return shipping rate estimates only when none of the products in the shopping cart have weights or dimensions recorded. Please note that shipping rate estimates will be increasingly inaccurate the more omissions there are to the weight and dimensions of products in the shopping cart.

The shopping cart won’t display shipping rate estimates the first time the shopper views the shopping cart because it isn’t aware of the ship to address. The user will be prompted to click on the Calculate Shipping Cost link to provide this information.

Appearance of shopping cart when viewed by a shopper who is not logged in to the website. Appearance of the shopping cart after the user clicks on the Calculate Shipping link.

After the user provides the ship to information, the shopping cart will display the shipping rate estimate based on the settings entered in the plugin.

Appearance of shopping cart when viewed immediately after the ship to information is provided.

If the plugin is unable to display shipping rate estimates, a message will display. Typical reasons why a quote may not be displayed include: 1) Insufficient data on the products in the shopping cart, such as weight or dimensions or freight class; 2) Invalid credentials due to a password change, an expired license, or a suspended account; 3) An invalid or incomplete ship to address was provided; or 4) The carrier’s web service is not operational.

Appearance of shopping cart when the plugin is unable to display shipping rate estimates.

Managing Your License

Return to top.

You can manage your license by signing into eniture.com with the email address and password you entered when you registered for the plugin. After you sign in, My Account will be added to the navigation menu. Click on it to access the Dashboard for your account.

my_account

The most common uses of the Dashboard are to upgrade a trial subscription to a paid subscription, change the URL registered to a license, or to identify the URL of a staging or development site.

Upgrade to a paid subscription

If you fail to upgrade your trial subscription to a paid subscription before the trial expires, the plugin will stop working. To upgrade, click on the My Licenses tab, locate the license, and click the Pay Now button.

Choose one of the subscription packages and then enter the information for your payment method. Your plugin will be automatically renewed at the end of each subscription period unless you return to the Dashboard and cancel the subscription.

Change the URL registered to a license

The plugin license allows you to use the plugin on a single website. To use the plugin on additional websites, you must purchase additional licenses. You can change the URL registered on a license at any time. To do so, click on the My Licenses tab, locate the license, and click the Edit button. Enter the new URL into the Licensed Domain field and then click the Update button.

licensed_domain

Identify a staging or development site

The plugin license will allow one staging or development site. Quotes returned to this site will have the word “Sandbox” appended to them. To identify a staging site, click on the My Licenses tab, locate the license, and click the Edit button. Enter the new URL into the Staging Domain field and then click the Update button.

staging_domain