XPO LTL Freight Quotes for WooCommerce
Don’t forget to read the “Manage Your License” section. You will need this information to upgrade your subscription once your free trial expires.
- WooCommerce Sign Up
- Download the File
- Install the Plugin
- Activate the Plugin
- How to obtain an API key for XPO?
- How to perform Connection Settings
- Quote Settings
- Identify drop ship locations and warehouses
- How to enable the Plugin
- Shipping parameters of product
- What Your Customer Sees
- What you see
- How to Manage Your License
In-Store Pick up
For an In-store pickup feature, you must have an Advanced Plan. You will see the following message next to the setting header if you are not already on the Advanced Plan.
In-store pick up is an option for customers who prefer to collect their product directly rather than have it delivered. This is only available when enabled, and the order is placed at only one stocking location: either a warehouse or drop ship. In-store pick up settings can be performed on the page where you edit or add drop ship locations and warehouse settings.
Enable in-store pick up: Check box to enable this feature.
Offer if address is within (miles): Enter the distance (in miles) if you are offering an in-store pick up option based on distance. If not, leave it as it is. If you evaluate on the basis of zip code or distance to address, the in-store option will automatically appear if either is matched.
Offer if postal code matches: You can set the postal codes to those that you would like to offer in-store pick up, or you can leave it empty if you don’t plan on using this criteria to determine the availability of this offer. If you evaluate on the basis of zip code or distance to address, the in-store option will automatically appear if either is matched.
Checkout description: This is the description of the option you choose during checkout. It should be In-store pick up, but you can write any other option you may want.
WooCommerce Sign up
Follow the steps given below for WooCommerce Sign Up:
- Go to SHIPROW and click Sign Up button on the top right corner
- Fill all the required fields of Sign Up form, Select WooCommerce from ‘Select platform’ dropdown.
- Click ‘Sign Up’
Download The File
Enter your login credentials that you used to register at Shiprow.com. You will be delivered to the customer dashboard, where you can download the plugin installation file. Remember where you save the plugin as you will need access to it while performing the installation.
This plugin can also be downloaded from www.wordpress.org.
Note: No matter where you have downloaded this plugin, you will have to choose a subscription plan and enter the required information in the registration form.
Local delivery settings
For the In-store pickup feature, you must have an Advanced Plan. If you are not already on it you will see the message “Advance Plan Required” next to the setting header.
The Local Delivery Feature needs to be enabled in order to give this option to the shopper at the time of checkout. The Local Delivery option can only be offered to shoppers within the set distance and depends on the postal code of the customer. There may be a small fee for local delivery, or it may be free of cost depending on the selected company’s policy. The local delivery settings can be performed on the page where you edit or add drop ship locations and warehouse settings.
Enable local delivery: Check the box to enable the Local Delivery option.
Offer if address is within (miles): Insert the distance (in miles) if you are offering Local Delivery based on the distance. Leave it empty if you don’t plan on using distance as criteria to offer local delivery. If you evaluate on the basis of zip code or ‘distance to address’, the local delivery option will automatically appear if either is matched.
Offer if postal code matches: You can set the postal codes to those that you would like to offer local delivery, or you can leave it empty if you don’t use this criteria to determine the availability of this offer. If you evaluate on the basis of zip code or distance to address, a local delivery option will automatically appear if either is matched.
Checkout description: This is the description of the option offered during checkout, it should be local delivery, but you can write any other option you may want.
Local delivery fee: Leave it empty if you offer the Local Delivery service free of charge. Otherwise, enter the amount to be charged for Local Delivery.
Suppress other rates: Check the box if you want to hide all other options when you offer Local Delivery. Do not check the box if you are offering Local Delivery along with other shipping options.
Install the Plugin
- Use administrative credentials to sign in to the WordPress Dashboard.
- Hover the cursor over the Plugins menu (on the left) to display sub-menu options.
- Click on Add New, and you will be taken to the Plugins page.
- Click on Upload Plugin located at the top of this page (You can also use the search bar to download and install our plugin).
Click on the Choose File button and choose the installation file that you have saved. Then, click Install Now.
Installation progress can be seen at the bottom of the page. Following completion, you will see a Plugin Installed Successfully message.
Activate the Plugin
When the installation is complete, click the Activate Plugin link.
If you close that page but later decide to activate the plugin, you can go to the Plugins Menu and click on the Installed Plugins link.
On the Installed Plugins page, locate and click on the Activate link underneath “XPO LTL Freight Quotes.”
How to enable or disable a carrier
In the SHIPROW app, locate and click Marketplace from the side menu where you will be able to enable/disable carrier(s) from the given list. Please see the screenshot below:
How to obtain an API key for XPO?
This application deals with two different versions of XPO’s APIs. There are many improvements in the newer version. The app will detect and use the latest version of the API when you insert your API key into the Connection Settings page. Obtaining and using the latest version of the API is recommended. If you don’t have your API key, simply email [email protected] stating following information:
- Your web user ID (if you don’t have one, you can register at XPO’s website).
- You are not interested in having a JAVA SDK.
- You are performing integration with the RATING REST API.
- XML is being used for the XPO LTL integration.
An email containing your API key will be sent to you within 1 business day.
How to perform Connection Settings
Open the WooCommerce menu and click on Settings.
Choose XPO Freight from the top menu for the configuration purposes.
Begin with Connection Settings. To access the Connection, Quote, and Warehouse settings, use the links shown at the top of the page.
Customer Account Number: If you have already obtained your XPO Logistics account number, insert it. Otherwise, contact XPO Logistics.
Username: This is the same username that you use to get access to the online shipping system of XPO Logistics.
Password: This is the password to your username.
Pickup/Delivery Postal Code: Enter the postal code of your registered billing address with XPO Logistics.
Bill To Account Number: XPO Bill To Account Number is required if you want to provide shipping quotes for the origin/area that you don’t have a Customer Account Number for.
Access Token: This is the API key you received through an email in Step 2. We recommend that you fill out this field, otherwise the application will use the older version of API which is not as efficient.
Plugin License Key: SHIPROW only issues the plugin license key to registered clients.
The License Key will be issued when you subscribe to one of our 3 plans. You will have 15 days of access to our Basic Plan, which is our Trial version of the plan. The other two plans are: the Standard Plan and the Advanced Plan. We display rates for monthly or yearly subscriptions. Further details about Plans and License Keys are given in the Manage Your License section.
Save your settings when you are finished. Then, click on the Test Connection button to make sure the connection is successfully established. In case of an error, double check the information you have entered. Make sure to check capitalization, as the information is case sensitive.
To make the plugins menu visible, click on WooCommerce, then choose Settings.
Now, locate and click on the XPO Freight tab. Then, click on the Quote Settings link.
Label As: Define how you want your quote to be labeled at the time of checkout. Usually, it is labeled as XPO Freight, but you can leave it empty. An empty field means quotes will be labeled as “Freight.”
Show delivery estimate: If you check this box, it will display the estimated delivery time for that particular carrier.
Always quote residential delivery: The residential delivery fee will be included in the quote if this feature is enabled.
Auto-detect residential addresses: We have an add-on for this plugin, which is called Residential Address Detection. This add-on checks the USPS database record when a residential address is detected. The residential delivery fee will be included in the quote.
If you see the phrase, “Click here to add the Residential Address Detection module,” the add-on is not installed.
Always quote tail lift delivery: The quote will automatically include the Tail Lift charges of a particular carrier if the “Always Quote Tail Lift Delivery” option is marked.
Offer tail lift delivery as an option: If enabled, the tail lift delivery option will be displayed, and the fee will be included.
Always include tail lift delivery when a residential address is detected: If checked, the tail lift charges will automatically be added into the shipping rate estimate. This only occurs when a residential delivery address is detected. In these cases, the “offer tail lift delivery” option will disappear, even if enabled. If both options (offer tail lift delivery and include tail lift delivery when residential delivery is detected) are enabled, it allows a commercial customer to select whether the tail lift service is required but is always added for residential customers.
Note: This will only show if you have the Residential Address Detection add-on installed.
Hold at station: To access the Hold at Station feature, you need to have an Advanced Plan. If you are not already on the required plan, you will see the words “Advanced Plan required.” Click on it if you wish to upgrade your current plan to a higher plan. To perform this upgrade, you have to be logged in as a store administrator.
When you have this option checked, a “Request To Keep The Order At Delivering Terminal” option will be displayed to the shopper. This is considered a more economical option for shoppers who would otherwise be subject to the residential address and/or tail lift delivery fee(s). If the address is commercial and it doesn’t require tail lift service, the quoted amount will be the same as a quote to the ship to address.
Handling Cost/Mark Up: Enter the amount for Handling Fee in addition to the actual quote rate, and it will be added before it is displayed to the shopper. When you enter numbers in this field, they will be considered as dollars and cents unless you put the ‘%’ sign with them.
Handling Cost/Mark Up 2: The second handling fee is applicable after the first handling fee. This increments the displayed amount. When you enter numbers in this field, they will be considered as dollars and cents unless you put the ‘%’ sign with them.
Drop ship locations and warehouses
To add drop ship locations and warehouses, simply click the Location option given under Products and then choose Add Location. For warehouses, it is necessary to have a complete inventory of products; otherwise, it is considered drop shipped. If two or more warehouses are on the list, the one nearest to the shopper will be considered to calculate shipping rates.
Drop shipping is a method of supply chain management where a retailer does not keep products in stock. Instead, it transfers customer’s shipment information to another retailer or manufacturer who then delivers to the customer on your behalf. The checkout shopping cart will show a single figure estimate if drop shipped products are included in the order. The single figure rate represents the total after calculating shipping requirements for each item.
How to enable the Plugin
Click WooCommerce, then click on Settings.
Choose the Shipping tab, then click on the Shipping Zones link.
To add shipping zones, click on Add shipping zone. An appropriate shipping zone is required in order to add the shipping method.
Click on the “Add Shipping Method” button as seen in the screenshot below to add the shipping method.
You will be shown a list of shipping methods. Select the appropriate one from the list and click on the Add shipping method button and then save changes.
You need to go through this process for each shipping zone. We recommend that you carry out a test for each shipping zone to ensure that the application supports the geographical locations defined.
Shipping parameters of the product
Congratulations! You are finished with application settings, you can now move on to product settings. You will use the same instructions for each product that you want to ship through LTL freight.
Locate and click on the Products from the menu list located on the left. This will take you to the product’s detail page. On this page, you will see the list of products. Click on the Edit Settings button of any product that you wish to enter the parameters of.
You will be redirected to the Product Setting page, where you will have to enter product details like dimensions, weight, freight class, etc. Fill in all of the blank fields by entering the required information. Then, choose Save at the bottom of the page.
Weight: The product weight should always be in pounds. It should also include the weight of any material involved in the packaging of shipment such as pallets, shrink wraps, cardboard, etc.
Dimensions: Dimensions of the products should be entered in inches.
Shipping Class: Choose “No Shipping Class” if you want the product to be quoted as a shipping parcel. This is only possible if the Small Package Quotes plugin is installed.
If you have the LTL Freight Quotes enabled, choose the LTL Freight option, and it will return quotes for LTL Freight.
Enable Drop Ship Location: Checking this box means that the product will be shipped from a drop ship location. Explanations on how to define warehouse and drop ship locations were provided in Step 7. This option will be only shown when drop ship locations are defined.
Drop Ship Location: Here, you will choose the drop ship location from the given list. An explanation on defining warehouse and drop ship locations can be found in step 7. This option will be only shown when drop ship locations are defined.
Freight Classification: Here, you will categorize or classify the products. You will have to define the freight class of all the products if you are offering both LTL Freight shipping and Small Package/Parcel shipping. The Density Based option is the alternative industry accepted way to define the freight class of shipment. In most cases, density based calculation will provide the accurate freight class, but it is your responsibility to check the accuracy of the freight class of your product(s).
In case of a Variable Product, go to the Variations page and define product variations.
The following points should be kept in mind while performing product classification:
- Freight Classification is only possible when the Freight Quotes plugin is installed.
- When complete, click the Update button.
What Your Customer Sees
When an online purchase is complete, this plugin will display the shipping charges, and it will use the available sources to display the best possible shipping rates. This is in case two or more products in the cart are missing either weight or dimensions. For Example: If you have two products in the cart and one of them is missing weight or dimensions, the shipping rates shown will be based on the product that has specified weight and dimensions. If no product has dimensions or weight recorded, the Plugin will not return any quotes.
Note: There is a high chance of inaccuracy of rates if the product is missing dimensions, weight, or both.
The shipping rates will be returned to the shopping cart once the “ship to” details are provided by the customer. These rates will depend on the settings used for the plugin. For more details about these settings, please check the installation guide. The presentation of shipping rates can be managed on the Settings Page of WooCommerce.
If the plugin fails to display shipping rates, a message will be displayed. Here are the possible reasons for failure to display rates:
- Absence of freight class, dimensions, etc.
- Invalid credentials, suspended account, expired license, etc.
- Invalid address.
- Web service of the carrier is not operational.
Here is a screenshot of when the plugin fails to display shipping rates:
What you see
The additional details widget on the Order Details page will display all information related to shipping. The contents will be shown in two categories
- Shipment Origin & Services
- Shipment Content
Shipment Origin & Services:
All particulars presented in this block will present the name of the carrier service, shipment origin, and any additional services (such as residential delivery, tail lift, etc) required for the order shipment. Information containing Shipment origin and Services information should be displayed separately for each individual shipping location to fulfill the order. This is specifically for stores with multiple warehouses and drop ship locations.
Under Shipment Origin & Services, there is a block for Shipment Content, which presents the items that were quoted as ‘shipping from the location’.
How to Manage Your License
To manage your license, simply sign in to shiprow.com using the same credentials that you used to register for the plugin.
Commonly, the Dashboard is used to upgrade to a paid subscription, change or edit the registered URL to a license, and to see your current licenses.
How to upgrade to a paid subscription
Once your trial version has expired, you will have to upgrade to a paid subscription to keep the plugin functional. To upgrade it, select the Buy License from the side menu, click the Pay Now button of the required plan.
Choose the subscription plan that best meets your needs and enter the required payment information. Note that at the end of each subscription cycle, your plugin will be renewed unless you cancel your subscription.