The Purolator LTL Freight Quotes plugin retrieves your negotiated LTL freight rates, takes action on them according to the plugin settings, and displays the results as shipping options in the WooCommerce cart and checkout page. Purolator is headquartered in Mississauga, Ontario and is Canada’s premier shipping company. If you don’t have a Purolator account number, contact them at 888-744-7123, or register online.
Basic Plan
Live negotiated carrier rates returned to the checkout process.
Supported origins: Canada.
Supported destinations: Canada, United States.
Customize the text used to label quotes displayed to shoppers.
Elect to display the carrier’s transit time with the rate estimate.
Option to always include the residential delivery fee.
Option to always include the lift gate delivery fee.
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.
Offer an option for residential delivery.
Offer an option for lift gate delivery.
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.
Current version: 2.1.1
Requirements
WooCommerce 5.7 or newer.
A Purolator account number.
Your username and password to purolator.com.
Your Purolator Production Key.
A license from Eniture Technology.
FAQ’S
How do I get a Purolator account number?
Contact them at 888-744-7123, or register online.
Where do I find my purolator.com username and password?
Contact Purolator customer service at 888-744-7123, or try to recover it online.
Where do I get my Purolator Production Key?
Obtaining a Purolator Production Key is done on purolator.com and requires a few steps. Refer to the Documentation tab on this page for detailed instructions.
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 > Purolator 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 Purolator 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 Purolator customer service for assistance. (888-744-7123)
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 Purolator’s web service.
The Purolator web service isn’t operational.
Your Purolator account has been suspended or cancelled.
There is an issue with the Eniture Technology servers.
Your subscription to the plugin 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 Purolator 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 Purolator 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 the following steps:
Other information contained in this guide:
1. Download the Installation File |
Return to top. |
On the Features tab of this webpage (you’re currently on the Documentation tab) is a list of available subscription plans and a description of the features included in each one. Click on the green button associated with the plan you want to subscribe to. The image below shows where to click to sign up for a monthly subscription to the plugin’s Basic Plan. There is also a button for a free 15 day trial beneath the name of the plugin at the top of the page.
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.
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 chose and install the plugin application. Choose the Choose File button, navigate to the location where you saved the installation 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 LTL Freight Quotes – Purolator Edition plugin on the list and click the Activate link.
4. Obtain a Purolator Production Key |
Return to top. |
To successfully connect the app to Purolator, in addition to a Purolator account, and purolator.com username and password, you also need a Purolator Production Key. If you don’t have one, sign into purolator.com and navigate to Purolator E-Ship Resource Centre.On the left hand side of the page, locate and click on the button to register for Purolator E-Ship Web Services.
You will be presented with three choices. Choose the Corporate Account Holder option.
Complete the Profile Information form and click the Submit Registration button.
You will receive an email from Purolator containing a link to use to complete the registration process. Click on it and log back into the E-Ship Resource Center. A message will appear informing you that your registration is complete.
Now you’re ready to request your Production Key. Sign back into the Purolator E-Ship Resource Centre. You will be presented with the main Purolator E-Ship Resource Centre page. Click on the Ready for Production tile.
Select the Corporate option.
Complete the form and click the Submit button. The Production Key you receive will be inactive until Purolator verifies the request. A Purolator representative may contact you for security purposes before the Production Key is activated. If you intend to use the app’s multiple warehouse and/or drop ship feature, ask the Purolator representative to remove the sender address restriction.
Once the Production Key is activated you can connect the Purolator LTL Freight Quotes app to the Purolator E-Ship Web Service by following the instructions in Step 3.
5. Connection Settings |
Return to top. |
Select Settings from the WooCommerce menu.
Click on the Purolator 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.
| Production Key | Enter the Production Key you obtained in Step 2 of these instructions. |
| Production Password | Enter the Production Password you obtained in Step 2 of these instructions. |
| Registered Account Number | Enter your Purolator account number. |
| 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. |
| Access Level | Choose Testing or Production. (Since the plugin is only retrieving quotes, there is no reason to use the Testing setting.) |
The plugin’s License Key will be tied to a subscription. The Trial Plan will give you 15 days of free access to the Basic Plan. Two other plans are available; the Standard Plan and the Advanced Plan. The features associated with each plan are listed on the Features tab of this web page. Each plan is available for a monthly or yearly subscription rate. To manage your License Key, including which plan is associated with it, see the section titled Managing your license. at the end of this User’s Guide.
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 Purolator 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.
6. Quote Settings |
Return to top. |
If you don’t have visibility to the plugin’s navigation menu, select Settings from the WooCommerce menu.
Click on the Purolator Freight tab to gain access to the plugin configuration settings. Using the links at the top of the page, select Quote Settings.
| Service Type | Select which Purolator LTL freight services you’d like to have quoted. |
| Always include the residential delivery fee | When checked, the quote will include the carrier’s residential delivery fee. |
| Offer residential delivery as an option | The Standard Plan or higher is required to use this feature. If you aren’t on the Standard Plan or higher the words Standard plan required will be displayed. Click on the Standard plan required text to upgrade your plan and gain access to the feature.
When enabled, the shopper will be presented with an additional option for LTL freight that includes residential delivery. |
| Provide an option for residential delivery | The Standard Plan or higher is required to use this feature. If you aren’t on the Standard Plan or higher the words Standard plan required will be displayed. Click on the Standard plan required text to upgrade your plan and gain access to the feature.
When enabled, the list of available shipping methods will include an entry for LTL freight with residential delivery service. If the setting Provide an option for tailgate delivery is also enabled, the the list of shipping methods will also include an entry for LTL freight with residential & tailgate delivery service |
| Tailgate Delivery Options | Always include the tailgate delivery fee When checked, the returned quotes will the tailgate delivery fee. Provide an option for tailgate delivery
An additional option for LTL freight will be offered that includes the tailgate delivery fee. |
| Show Delivery Estimate | When checked, the carrier’s estimated transit time will be displayed. |
| Label As (Standard) | Identify how you want the quote labeled in the checkout process. A common choice for this field is “LTL Freight” or “Purolator LTL – Standard”. If left blank quotes will be labeled “Freight” |
| Label As (Expedited) | Identify how you want the quote labeled in the checkout process. A common choice for this field is “LTL Freight” or “Purolator LTL – Expedited”. If left blank quotes will be labeled “Freight” |
| Handling unit settings | Weight of Handling Unit Enter in pounds the weight of your pallet, skid, crate or other type of handling unit you use. The amount entered will be added to shipment weight prior to requesting a quote. Maximum Weight per Handling Unit
Enter in pounds the maximum weight that can be placed on the handling unit. If the total weight of the cart exceeds this value, the weight of additional handling units will be added as needed. For example, if the maximum weight is 500 LBS, and the total weight of the cart is 1200 LBS, the weight of the handling units added to the shipment shall be 3 times the weight entered in the Weight of Handling Unit field. (=roundup(1200/500,0)*Weight of Handling Unit) |
| Handling Fee / Mark Up | Increases the amount of the 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 quote. Entering 5.00% will cause each quote to be multiplied by 1.05 (= 1 + 5%). |
| Enable Logs | Enable the checkbox to have API transactions logged on the Logs page. The plugin’s navigation will only display an entry for Logs when this setting is enabled. The page will contain as many as 25 of the most recent transactions. |
| Show WooCommerce shipping options | (Yes|No) Permit or prevent the display of shipping rates from other plugins. |
| Return LTL quotes when an order’s parcel shipment weight exceeds the weight threshold. | When checked, the LTL Freight Quote plugin will return quotes when the cart’s total weight exceeds the weight threshold, 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. |
| Weight threshold for LTL freight | Enter the weight threshold for LTL freight in pounds. |
7. Define Warehouse and Drop Ship Locations |
Return to top. |
If you don’t have visibility to the plugin’s navigation menu, select Settings from the WooCommerce menu.
Click on the Purolator Freight tab to gain access to the plugin configuration settings. Using the links at the top of the page, select Warehouses.
Click the Add button in the appropriate sections to add warehouse and drop ship locations. On the Basic Plan you can define one warehouse and multiple drop ship locations. To define multiple warehouse locations you must be on the Standard Plan or higher.
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.
| Steet 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. |
| Handling Fee / Mark Up | Increases the amount of the quotes received for this location 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%).
Note: The plugin has four settings that can be used to mark up shipping quotes. They are applied to shipping quotes in the following order: 1) Product-specific Mark Up (Product settings); 2) Location-specific Handling Fee / Mark Up (Warehouse settings); 3) Service-specific Mark Up (Quote settings); and 4) General Handling Fee / Mark Up (Quote settings).
|
7a. 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. |
7b. 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. |
8. Enable the Plugin (WooCommerce 3.0 or later only) |
Return to top. |
Select Settings from the WooCommerce menu.
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.
If an appropriate shipping zone is already defined, click on its name to access the page where the shipping method can be added.
Click on the Add shipping method button…
…select the Purolator 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.
9. Product Settings |
Return to top. |
Navigate to your product list in the WordPress Dashboard 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 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. |
| Mark Up | Increases the amount of the shipping quotes received when this item is in the 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 the mark up to be calculated as a percentage of the product’s price.
Note: The plugin has four settings that can be used to mark up shipping quotes. They are applied to shipping quotes in the following order: 1) Product-specific Mark Up (Product settings); 2) Location-specific Handling Fee / Mark Up (Warehouse settings); 3) Service-specific Mark Up (Quote settings); and 4) General Handling Fee / Mark Up (Quote settings).
|
| 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. |
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.
Logs |
Return to top. |
The Quote Settings page contains the Enable Logs setting. When enabled, the plugin’s navigation will include a link to the Logs page. Up to 25 of the most recent transactions will appear on the Logs page. The Response column shows the outcome of each transaction. Click on a transaction’s response result to view its details.
When viewing the transaction details, click on the “+” symbols to expand the level of detail and “–” to collapse it. A basic understanding of Application Programming Interfaces (APIs) will be useful when viewing the logs.
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.
Use the links below to navigate to documents in the knowledge base related to common topics of interest.