WooCommerce / Worldwide Express LTL Freight Plugin

/WooCommerce / Worldwide Express LTL Freight Plugin
WooCommerce / Worldwide Express LTL Freight Plugin2018-11-10T17:55:58+00:00

LTL Freight Quotes

Worldwide Express Edition for WooCommerce

Worldwide Express (wwex.com ) is a third party logistics company that gives its customers access to over 60 LTL freight carriers through a single account relationship. The plugin retrieves your negotiated Worldwide Express rates, takes action on them according to the plugin settings, and displays the result as shipping charges in your WooCommerce shopping cart. To request a Worldwide Express account click here to access the new account request form.

Features

Three Rating Options: Cheapest, Cheapest Options and Average.

Create a custom label to identify the freight charges in the shopping cart and checkout page. The default is “Freight”, but you might change it to “LTL Freight” or “LTL Freight via Worldwide Express” or any other value. (Cheapest and Average methods only.)

Control the number of LTL freight options displayed in the shopping cart. (Cheapest Options method only.)

Option to include transit time estimates with the rate quote. (Cheapest and Cheapest Options methods only.)

Ability to limit the carrier list

Product specific freight classes

Support for variable products

Option to determine a product’s class using the density calculation method.

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.

Mark up rates by applying a set dollar amount or percentage.

Intelligently recognizes when the shopping cart contains products that will ship LTL freight and obtains LTL quotes only in those instances.

Does not interfere with installed plugins for FedEx, UPS and USPS when the shopping cart doesn’t contain a product that will ship LTL freight.

Includes LTL freight charges in the shopping cart total, checkout page, sales order and customer’s order acknowledgement / receipt.

Current version: 2.0

Requirements

WooCommerce version 3.0 or later.

Tested through WordPress 4.7.

A Worldwide Express account number.

Your username and password to Worldwide Express’s
online shipping system.

Your Worldwide Express web services authentication key.

A license key from Eniture Technology.

FAQ’S

What happens when my shopping cart contains products that ship LTL and products that would normally ship FedEx or UPS?

If the shopping cart contains one or more products tagged to ship LTL freight, all of the products in the shopping cart are assumed to ship LTL freight. To ensure the most accurate quote possible, make sure that every product has a weight and dimensions recorded.

What happens if I forget to identify a freight classification for a product?

In the absence of a freight class, the plugin will determine the freight classification using the density calculation method. To do so the products weight and dimensions must be recorded.

Why was the invoice I received from Worldwide Express more than what was quoted by the plugin?

One of the shipment parameters (weight, dimensions, freight class) is different, or additional services (such as residential delivery, lift gate, delivery by appointment and others) 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 packaging materials,such as a pallet, is included by the carrier in the billable weight for the shipment.

How do I find out what freight classification to use for my products?

Contact your local Worldwide Express office for assistance. You might also consider getting a subscription to ClassIT offered by the National Motor Freight Traffic Association (NMFTA). Visit them online at classit.nmfta.org.

How do I get a Worldwide Express account number?

Worldwide Express is a US national franchise organization. Check your phone book for local listings or click here to access the new account request form.

Where do I find my Worldwide Express username and password?

Usernames and passwords to Worldwide Express’s online shipping system are issued by Worldwide Express. Contact the Worldwide Express office servicing your account to request them. If you don’t have a Worldwide Express account, click here to access the new account request form.

Where do I get my Worldwide Express authentication key?

You can can request an authentication key by logging into Worldwide Express’s online shipping system (speedship.wwex.com) and navigating to Services > Web Services. An authentication key will be emailed to you, usually within the hour.

How do I get a license key for my 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 trail 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.

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 > Speedfreight > Connections) then you have one or more of the following licensing issue:
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.

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 of the User’s Guide (see link above left) 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.

When you 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 your plugins, 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. The file is named ‘woocommercefreight.zip’. Some browsers may automatically extract the contents of the ZIP file.
If so, search your download folder for the original ZIP file. You must have the ZIP file to complete the next step.

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.

Controls will appear in the middle of page that will allow you to choose and install the plugin application. Click on the Choose File button, navigate to the location where you saved the ‘woocommercefreight.zip’ file and select it.

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.

Locate the WooCommerce Freight plugin on the list and click the Activate link.

4. Get Your Worldwide Express Authentication Key

Return to top.

To connect to the Worldwide Express web services you need to obtain an Authentication Key. To do so, sign into Worldwide Express’s online shipping system, Speedship. Select Web Services from the Services menu.

Click on the Request Authentication Key button…

…and complete the form. Select Speedship from the Web Services drop down list if you are requesting an authentication key for small package quotes (UPS/parcel), or Speedfreight for LTL freight quotes. (Note: If you will be using both, you only need to perform this exercise once. The Authentication Key will be the same in both cases. The selection from the drop down list is used to inform the Worldwide Express sales staff, not to activate a particular web service.)

An email containing the Authentication Key will be sent to the email address entered into the form.

5. Configure the Plugin

Return to top.

Select Settings from the WooCommerce menu.

Click on the Speedfreight tab to gain access to the plugin configuration settings. Use the links at the top of the page to navigate to the
different categories of configuration settings. Start with the Connection settings.

5a. Connection Settings

Return to top.

woo-ltl-connection-settings-16-12-06

Worldwide Express Account Number Your Worldwide Express account number. If you don’t have one please contact your local Worldwide Express office to obtain one.
Speedfreight Username The Speedfreight username issued to you by Worldwide Express. It is sometimes referred to as the Speedship username. It is the same username you’d use to login to Worldwide Express’s online shipping application located at http://speedship.wwex.com.
Speedfreight Password The password associated with the provided username.
Authentication Key The authentication key issued by Worldwide Express. It can be obtained by logging into http://speedship.wwex.com using your Speedfreight credentials, navigating to Services > Web Services and following the instruction provided there.
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 entering your connection settings, 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 Worldwide Express 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. Carrier Settings

Return to top.

woo-ltl-carrier-settings-16-12-06

This page identifies which carriers will be included in the list of quotes retrieved from Worldwide Express. You can exclude a carrier by removing its checkmark from the Include column.

Not all carriers service all orgin and destination points. If a carrier doesn’t service either one of the addresses, it is automatically omitted. Consider conferring with your Worldwide Express representative if you want to reduce the number of carrier responses.

5c. Quote Settings

Return to top.

woo-ltl-quote-settings-16-12-06

Rating Method The rating method determines what will be displayed in the shopping cart. There are three rating methods:

Cheapest
The cheapest rate returned by Worldwide Express is selected for use in the shopping
cart.

Cheapest Options
A list of the cheapest options returned by Worldwide Express is selected for use in the shopping cart. The number of options is set by the Number Of Options  setting which displays when this selection is chosen.

Average
An average of a specified number of cheapest  options is selected for use in the shopping cart. The number of options is set by  the Number Of Options
setting which displays when this selection is  chosen.

Number Of Options Displays only when the Rating Method is set to Cheapest Options or Average. Identifies how many of the quotes returned by Worldwide Express should be included in the operation.
Show Delivery Estimate Displays only when the Rating Method is set to Cheapest or Cheapest Options. When checked, the transit time estimate appears with the quote(s).
Label As Displays only when the Rating Method is set to Cheapest or Average. The entered value is used to describe the shipping charge in the shopping cart. If left blank, then the shipping charge is described as “Freight”.
Always quote residential delivery When checked, the returned quotes will include each 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 each returned quote by a specified amount prior to displaying it/them 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%).
Allow for Own Arrangement Checking this box adds another option in the shopping cart that can be selected to indicate that the purchaser will make and pay for the LTL freight arrangements. When selected, the shipping charges included in the shopping cart are zero.
Text for Own Arrangement You can customize the text that is displayed in the shopping cart for the Own Arrangement option. For example, you may want it to appear as “Pickup Order” or “Hold for pickup”.
Show WooCommerce shipping options (Yes|No) By default the plugin suppresses shipping rates from all other plugins when the shopping cart contains an item you have indicated will ship LTL Freight. Enabling this setting will allow the native WooCommerce shipping options to also display.
Return LTL 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.

5d. 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.

woo-ltl-warehouses

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.

shipping zone

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. The Worldwide Express Speedfreight web service will only return quotes for the continental United States, so the shipping zone should be no larger than that.

us48_shipping_zone

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

define_ltl_shipping_zone

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

add_ltl_shipping_method

…and click on the Add shipping method button.

7. Product Settings

Return to top.

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

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 4: Configure the Plugin > Define Warehouse and Drop Ship Locations of the Installation Guide 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 4: Configure the Plugin > Define Warehouse and Drop Ship Locations of the Installation Guide 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.

What Your Customer Sees

Return to top.

When any product in the shopping cart is designated to ship LTL freight, all products in the shopping cart are assumed to ship LTL freight. Therefore, it’s recommended that all products be assigned a freight class; even those that don’t normally ship LTL freight. If a freight class isn’t available, the plugin will attempt to calculate one using the density based calculation. This requires that both the product’s weight and dimensions are recorded, which is a recommended practice regardless of what shipping method is used. If the weight and dimensions aren’t recorded, the plugin follows a complex set rules to make an effort to return a estimated rate so the shopper isn’t discouraged from completing the transaction. The absence of freight class, weight or dimensions will impact the accuracy of the quote.

The shopping cart won’t display a LTL freight quote 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 LTL freight quote(s) based on the settings entered in for the plugin. The settings for the illustrations below were to return the three cheapest options. Refer to the installation guide for a list of other available options and how to enable them.

Appearance of shopping cart when viewed immediately after the ship to information is provided. Cheapest 3 options rating method enabled. Appearance of the shopping when LTL freight quotes have been returned and the shopper is accessing the list of options. Cheapest 3 options rating method enabled, and the option to allow the shopper to make their own arrangements.

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

Appearance of shopping cart when the plugin is unable to display LTL freight quotes.

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.

my_licenses

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