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. This application retrieves your negotiated Worldwide Express rates, takes action on them according to the extension settings, and displays the result as shipping charges in the Magento shopping cart. To request a Worldwide Express account click here and complete the form.
Basic Plan
Live negotiated carrier rates returned to the checkout process.
Supported origins: United States.
Supported destinations: Canada*, United States. (*Requires connection to new API)
Three Rating Options: Cheapest, Cheapest Options and Average.
Customize the text used to label quotes displayed to shoppers. (Cheapest and Average methods only.)
Elect to display the carrier’s transit time with the rate estimate. (Cheapest and Cheapest Options methods only.)
Option to always include the residential delivery fee.
Compatible with the Residential Address Detection plugin which automatically includes the residential address delivery fee when the Ship To address is a residence.
Option to always include the lift gate delivery fee.
Additional options for lift gate delivery are enabled with the installation of the Residential Address Detection plugin.
Assign products a freight class, weight and optionally dimensions.
Identify one warehouse and multiple drop ship locations.
Embed a handling charge in the displayed rates to recover the cost of packaging materials or other shipping related expenses.
Dynamic presentation of parcel and LTL freight rates with the installation of compatible apps from Eniture Technology.
Standard Plan
Everything in the Basic Plan, plus…
Define multiple warehouses.
The warehouse closest to the shopper is used as the shipment origin to keep shipping costs low and delivery times fast.
Support for products that ship as hazardous material.
Advanced Plan
Everything in the Standard Plan, plus…
Offer in-store pick up based on the shopper’s ZIP code or distance to the warehouse.
Offer local delivery based on the shopper’s ZIP code or distance to the warehouse.
Identify a charge for local delivery.
Support for products that can be nested when shipped, such as garbage cans. The freight class for nested products is identified using the built in freight class calculator.
Current version: 1.0
Requirements
An installation of Magento CE (Version 2.x).
A Worldwide Express account number.
Your username and password to Worldwide Express’s online shipping system.
Your Worldwide Express web services authentication key.
FAQ’S
How do I get this application?
This application can be downloaded from this website after selecting a subscription package. It will also be available from Magento Connect, Magento’s online marketplace for extensions. If you download it from Magento Connect, you will still need to return to eniture.com to choose a subscription package and obtain a license key.
Will this work with Magento Enterprise Edition?
We have reports of companies using the extension successfully in Magento Enterprise. You can install a trial version and verify that it will work for you. Be advised though, we can not provide support for installations on Magento Enterprise Edition.
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 this Magento extension?
You must register your installation of the extension, 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 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 extensions.
How do I install the extension on another website?
The extension 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 extension 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 extension working on my other website?
If you can successfully test your credentials using the Test Connection button (System > Configuration > Shipping Methods > Worldwide Express LTL Freight) 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 were the shipment charges I received on the invoice from Worldwide Express different than what was quoted by the application?
The rates will be the same if the shipment parameters used to obtain the quote are exactly the same as those that were used for the invoice. Compare the shipment parameters in the application with those on the invoice. Pay close attention to freight class, product weight, dimensions and various accessorial fees like residential delivery. Consider making changes as needed. Remember that the weight of packaging materials is included in the weight of the shipment and that your use of pallet or box size may have an impact on the shipment’s billable weight. If you are unable to reconcile the differences call your local Worldwide Express office for assistance.
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.
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.
Why do I sometimes get a message that a shipping rate estimate couldn’t be provided?
There are several possibilities:
There wasn’t enough information about the weight or dimensions for the products in the shopping cart to retrieve a shipping rate estimate.
The Worldwide Express web service isn’t operational.
Your Worldwide Express account has been suspended or cancelled.
Your subscription to the application has expired because payment could not be processed.
There is an issue with the Eniture Technology servers.
There is an issue with the server that hosts your installation of Magento.
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 application to display LTL freight quotes consists of the steps listed below. Each step is bookmarked to the relevant section of the User’s Guide. In the heading of each section there is a Return to top link which will deliver you back to the list of steps.
- Pre-installation preparations.
- Register for the module License Key.
- Download the module installation file.
- Install the module.
- Get your Worldwide Express Authentication Key.
- Enable the delivery method.
- Connect the module to your shipping account.
- Carrier settings.
- Identify your warehouse and drop ship locations.
- Choose your quote settings.
- Enter the product shipping parameters.
Other information contained in this guide:
1. Pre-installation Preparations |
Return to top. |
Before installing the module, make sure you’ve made the following preparations:
- Set up a server that meets the Magento 2 system requirements.
- Create the Magento file system owner.
2. Register for the module License Key |
Return to top. |
You’ll be presented with a registration form. The email address and password you enter will serve as your credentials to eniture.com. You’ll use these to gain access to the customer dashboard where you can download the module installation file, manage your license, and update your payment information.
If you’re starting with the free trial, you’ll receive a verification email. You must complete the verification step described in the email before you can access the customer dashboard. You’ll have immediate access to the customer dashboard if you choose to start with one of the paid subscriptions.
You’ll receive an email containing your license key. The license key will work for one production site and one staging site. You entered the domain for the production site when you completed the registration form. You can change the production site domain or add/update a staging site anytime from the customer dashboard.
To access the customer dashboard, login to eniture.com and click on the My Licenses tab. Click the Edit button associated with the license you want to update.
3. Download the module installation file |
Return to top. |
While logged into eniture.com with the credentials created in Step 2 (Register for the module License Key), select Downloads > Magento. Locate the module and then click the link to download the installation file. Save the file to a familiar location because you will need to navigate to it during the installation process.
4. Install the module |
Return to top. |
- Go to the magento-root/app directory using FTP.
- Create a code directory if it doesn’t exist.
- Create a Eniture directory in the magento-root/app/code directory.
- Upload the WweLtlFreightQuotes folder retrieved in Step 3 to the magento-root/app/code/Eniture directory.
- Open SSH.
- Execute the following commands:
php bin/magento setup:upgrade
- Clear the cache using the following command (or do it from the admin panel):
php bin/magento cache:flush
- Re-deploy the static contents (production mode only) by executing the following command:
php bin/magento s:s:d
5. 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.
6. Enable the delivery method |
Return to top. |
7. Connect the module to your shipping account |
Return to top. |
7a. Connect to Worldwide Express’s New API |
Return to top. |
Follow these instructions if you have a Client ID and Client Secret and will be connecting to Worldwide Express via its new API.
| Which API Will You Connect To? | Select New API from the list of options. |
| Client ID | Enter the Client ID you received for the New API. |
| Client Secret | Enter the Client Secret you you received for the New API. |
| Username | The Speedship username issued to you by Worldwide Express. It is the same username you’d use to login to Worldwide Express’s online shipping application located at http://speedship.wwex.com. |
| Password | The password associated with the provided username. |
| Plugin License Key | Enter the License Key you received when registering for a license for the module. If you can’t find the it, login to eniture.com and retrieve it from the customer dashboard.
Related document:
|
7b. Connect to Worldwide Express’s Legacy API |
Return to top. |
Follow these instructions if you have an Authentication Key and will be connecting to Worldwide Express via its legacy API.
| Which API Will You Connect To? | Select Legacy API from the list of options. |
| Account Number | Your Worldwide Express account number. If you don’t have one please contact your local Worldwide Express office to obtain one. |
| Username | The Speedship username issued to you by Worldwide Express. It is the same username you’d use to login to Worldwide Express’s online shipping application located at http://speedship.wwex.com. |
| 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 Speedship credentials, navigating to Services > Web Services and following the instruction provided there. |
| Plugin License Key | Enter the License Key you received when registering for a license for the module. If you can’t find the it, login to eniture.com and retrieve it from the customer dashboard.
Related document:
|
8. Carrier settings |
Return to top. |
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 origin 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.
9. Identify your warehouse and dropship locations |
Return to top. |
Click the Add button in the appropriate sections to add warehouse and drop ship locations.
If you ship products from only one location, add the location as a warehouse and proceed to the next step.
If you ship from more than one location, then you need to understand the distinction the programming makes between warehouses and drop ship locations.
Warehouses are understood to have a complete inventory of all products not otherwise assigned to a drop ship location. If you have more than one warehouse defined, the warehouse closest to the shopper will be used to retrieve the shipping rate estimates. When you have more than one warehouse defined, the relationship between a product (that is not assigned to a drop ship location) and warehouses is one-to-many.
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. Items that ship from a drop ship location are assigned to the drop ship location in the product settings. The item is understood to only ship from that location. The relationship between a product assigned to a drop ship location and the drop ship location is one-to-one.
If you have only drop ship locations (no warehouses), a recommended best practice is to define the drop ship location that sources most of your orders as a warehouse instead of a drop ship location. This insures that quotes will be returned in the event you forget to assign a product to a drop ship location.
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.
Warehouses versus Drop Ship Locations
| Street Address | Optional. Enter the street address for the location. This will be displayed along with the city, state, and postal code when the setting for in-store pick up is enabled. |
| ZIP | Enter the postal code for the location. Enter only the five digit ZIP Code for US addresses. |
| City | The plugin will attempt to prefill the City based on the postal code. Edit it if the prefilled value is incorrect. |
| State | The plugin will attempt to prefill the State based on the postal code. Edit it if the prefilled value is incorrect. |
| Country | The plugin will attempt to prefill the Country based on the postal code. Edit it if the prefilled value is incorrect. Use only the two character standardized country code. |
9a. In-store pick up settings |
Return to top. |
The Advanced Plan is required to use this feature. If you aren’t on the Advanced Plan the words Advanced plan required will appear adjacent to the settings header, and the fields associated with the feature will be inaccessible.
In-store pick up can be offered as an option in the checkout process based the shopper’s postal code or proximity. It will only be offered if the feature is enabled and only one stocking location (warehouse or drop ship location) is involved in providing a quote. The settings for In-store pick up are visible on the page used to add or edit a warehouse or drop ship location.
| Enable in-store pick up | Check the box to enable the in-store pick up feature. |
| Offer if address is within (miles) | The distance in miles within which you’d like to offer in-store pick up. The distance is route miles (driving distance). Leave blank if you don’t want to use distance to determine if in-store pick up should be offered. If both distance and postal codes are used as evaluation criteria, in-store pick up will display if either is satisfied. |
| Offer if postal code matches | The postal codes to which you’d like to offer in-store pick up. Enter only the five digit ZIP Code for US addresses. Leave blank if you don’t want to use postal codes to determine if in-store pick up should be offered. If both distance and postal codes are used as evaluation criteria, in-store pick up will display if either is satisfied. |
| Checkout description | The description to use to identify the option in the checkout process. The most obvious candidate is In-store pick up, but you can make it anything you’d like. |
| Phone number | Enter the phone number to display in the description of the in-store pickup option. |
9b. Local delivery settings |
Return to top. |
The Advanced Plan is required to use this feature. If you aren’t on the Advanced Plan the words Advanced plan required will appear adjacent to the settings header, and the fields associated with the feature will be inaccessible.
Local delivery can be offered as an option in the checkout process based the shopper’s postal code or proximity. It will only be offered if the feature is enabled and only one stocking location (warehouse or drop ship location) is involved in providing a quote. Local delivery can display as a free option or have a charge associated with it. Other shipping options provided by the app can be suppressed when local delivery is to be offered. The settings for Local delivery are visible on the page used to add or edit a warehouse or drop ship location.
| Enable local delivery | Check the box to enable the local delivery feature. |
| Offer if address is within (miles) | The distance in miles within which you’d like to offer local delivery. The distance is route miles (driving distance). Leave blank if you don’t want to use distance to determine if local delivery should be offered. If both distance and postal codes are used as evaluation criteria, local delivery will display if either is satisfied. |
| Offer if postal code matches | The postal codes to which you’d like to offer local delivery. Enter only the five digit ZIP Code for US addresses. Leave blank if you don’t want to use postal codes to determine if local delivery should be offered. If both distance and postal codes are used as evaluation criteria, local delivery will display if either is satisfied. |
| Checkout description | The description to use to identify the option in the checkout process. The most obvious candidate is Local delivery, but you can make it anything you’d like. |
| Local delivery fee | Enter the amount to charge for local delivery. Leave blank to offer local delivery for free. |
| Suppress other rates | Check the box to show only the option for local delivery when the criteria for doing so (distance or postal code) is met. Leave unchecked to have local delivery offered in addition to the shipping options normally displayed by the app. |
10. Choose your quote settings |
Return to top. |
Select Quote Settings from the Eniture – Worldwide Express LTL Freight Quotes navigation menu. If you don’t see the module’s navigation menu, first use the Magento ADMIN menu to navigate to Stores > Configuration > Eniture – Worldwide Express LTL Freight Quotes.
| Quote Service Options | Select the carriers will be included in the list of quotes retrieved from Worldwide Express. Not all carriers service all origin 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. Hold down the CTRL button (PC) or Command button (Mac) while clicking on the carrier names to make multiple selections. |
| Rating Method | The rating method determines what will be displayed in the shopping cart. There are three rating methods:
Cheapest Cheapest Options Average |
| 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”. |
| Number Of Options | Displays only when the Rating Method is set to Cheapest Options or Average. Identifies how many of the quotes returned to the module 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). |
| Residential Delivery | When enabled, the quotes will include each carrier’s residential delivery fee. |
| Residential Address Detection | Through the use of an add-on module 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 add-on module is not installed. Click on the link to install it if you’d like to use this feature. (Learn more)
These settings display only if the Residential Address Detection module is installed. Auto-renew
Choose a plan that best meets your needs. The credit card associated with quote module 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 information about the current plan and the start and end dates of the current subscription period. Current Usage
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 occurred. Suspend Use
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. Default unconfirmed address types to
Select Residential or Commercial. In rare cases the module may be unable to confirm the address type. This occurs when a match for the address can’t be found in the USPS database. Invalid addresses are the most common reason for this. In extremely rare cases an address may be valid, but the match found in the USPS database has a low confidence metric. Choose how you want addresses treated in these cases. |
| Lift Gate Delivery Settings | Lift Gate Delivery When enabled, the quotes will include each carrier’s lift gate delivery fee. Offer lift gate delivery as an option
When enabled, lift gate delivery will be offered as a separate option for each quoted carrier. Always include lift gate delivery when a residential address is detected.
Displays only if the Residential Address Detection module is installed. |
| Insurance Category | If you’ll be purchasing insurance for your shipments when certain items are in the cart, select the correct insurance category from the list. If you’re uncertain which category to select, contact your Worldwide Express representative. |
| Handling Fee / Markup | 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 | Yes|No Dropdown When enabled, this setting 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
This field only displays if the Allow for Own Arrangement setting is set to “Yes”. 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”. |
| 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. |
11. Product Settings |
Return to top. |
Now that the application settings have been established, it’s time enter the product settings. Repeat these instructions for every product that you want to ship via LTL freight. Select Products > Catalog > Products from Magento Admin Panel menu. Locate the product on the list and choose it by clicking on it. You’ll be delivered to the product’s details page.
| Ship Via LTL Freight | (Yes|No) Select “Yes” to indicate that by default, this product ships LTL freight. |
| Freight Class | Select the product’s freight class from the drop down list. You may also select Density Based from the list, which will calculate freight class on the fly using the product’s weight and dimensions. The density based calculation will return the correct freight class in most, but not all cases. You are solely responsible to identify the correct freight class of your product(s). If you need assistance, contact your Worldwide Express representative or refer to the National Motor Freight Classification (NMFC) directory published by the National Motor Freight Transportation Agency (NMFTA.org). |
| Length | Enter the length of the product in inches. It should include any incremental inches added by packaging materials that may be required to ship the product. |
| Width | Enter the width of the product in inches. It should include any incremental inches added by packaging materials that may be required to ship the product. |
| Height | Enter the height of the product in inches. It should include any incremental inches added by packaging materials that may be required to ship the product. |
| Weight | Enter the weight of the product in pounds. It should include the weight of any packaging materials that may be required to ship the product, such as cardboard, bubble wrap and styrofoam peanuts. |
| Hazardous material | The Standard Plan is required to use this feature. If you aren’t on the Standard Plan or higher, the words Standard plan required will appear adjacent to the settings header, and the fields associated with the feature will be inaccessible.
Enable this checkbox if the item is subject to a hazardous material fee. |
| Insure this item | The Standard Plan is required to use this feature. If you aren’t on the Standard Plan or higher, the words Standard plan required will appear adjacent to the settings header, and the fields associated with the feature will be inaccessible.
Enable this checkbox if you want to insure the shipment if this item is in the cart. |
| Enable Drop Ship | Select Yes if the item will ship from a drop ship location. |
| Drop Ship Location | Select the drop ship location from which the item will ship. This setting is only active if the Enable Drop Ship location is set to Yes. |
What your shopper sees |
Return to top. |
Once you’ve completed the preceding steps, your Magento store is ready to begin quoting LTL freight services offered through Worldwide Express. To ensure the best possible outcome, it is highly recommended that freight class, weight and dimensions be entered for every product you sell. The exact presentation of the rates in the checkout process will depend on the options selected in the Quote Settings. The illustration below shows an example with multiple service options enabled.
What you see |
Return to top. |
When an order is placed, the quote details are available to you on the Order View page. The shipping method chosen by the customer is shown in the Payment & Shipping Method section of the Information page.
The Additional Order Details page will contain information related how the quote was obtained. Identified will be the shipment origin, the shipping method, any additional pertinent information, and a list of items shipping from that location. If more than one stocking location was required to obtain the quote, each location and its associated data will be listed in succession.
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 extension. After you sign in, My Account will be added to the navigation menu. Click on it to access the Dashboard for your account.
Use the links below to navigate to documents in the knowledge base related to common topics of interest.