Search Knowledge Base by Keyword

How to setup Multi-Carrier Shipping Plugin for WooCommerce?

This article explains how to set up the Multi-Carrier Shipping Plugin for WooCommerce to get real-time shipping rates from UPS, USPS, FedEx, Stamps.com, and DHL. It is a complete guide to using multiple shipping carriers on your WooCommerce store along with WooCommerce Flat Rate and Free Shipping based on factors like Weight, Quantity, and Price.

Contents:

Overview

The APIs of major shipping carriers like FedEx, UPS, USPS, Stamps, DHL, etc. provide real-time domestic and international shipping rates for store owners. This information helps store owners to display competitive shipping rates to their customers. Each shipping carrier has varied shipping services which can be accessed by a dedicated plugin for that carrier. How about one plugin which calculates shipping rates of five major shipping carriers?

The Multi-Carrier Shipping Plugin for WooCommerce provides real-time shipping rates of FedEx, UPS, USPS, Stamps USPS and DHL Express shipping carriers. You can create business rules based on various parameters such as the shipping class, product category, rates based on weight, item quantity and price.

The major advantage of this plugin over independent shipping carrier plugin (like FedEx, UPS and so on) is the ability to fetch real-time shipping rates from five major shipping carriers. Since it is a single request and you receive multiple responses, it is relatively faster than independent shipping carrier plugins.
Also, the plugin allows you to set custom rules based on your requirement, with greater flexibility than the individual shipping carrier plugins.

This article intends to provide detailed, step-by-step instructions that’ll help you set up this plugin.

Pre-requisites

  • Your Email ID to get the free Shipping API Key.
  • Create accounts in FedEx, UPS, USPS, Stamps USPS and DHL Express.
  • Shipping Area Management: You need to set up Shipping Area Management so that the plugin can return the shipping rates. Shipping Area Management can be configured based on
    • Shipping Zones
    • Country
    • State
    • ZIP Codes

Installation

After purchasing the Multi-Carrier Shipping Plugin for WooCommerce, the plugin will be available as a zip file in the API Downloads section of your MY ACCOUNT page.

  1. Download the zip file from API Downloads by logging into your XAdapter MY ACCOUNTS page.
  2. Log in as the WordPress Admin of your online store.
  3. Navigate to Plugins > Add New to upload the downloaded plugin.
  4. Choose the plugin file to upload.
  5. Finally, activate the plugin.

Getting started with the plugin

Once the activation is successful, two new settings are displayed in the Shipping settings of WooCommerce.
You can navigate these settings in two ways:

  • WooCommerce > Settings > Shipping > Multi-Carrier Shipping  or
  • Plugins > Installed Plugins > Settings for Multi-Carrier Shipping Plugin for WooCommerce

Shipping Area Management

With Shipping Area Management, you can create your own areas using Shipping zones, country names, city names, and postcodes. You can access this setting in two ways:

  • Navigate to WooCommerce > Settings > Shipping > Shipping Area Management  or
  • Navigate to Plugins > Installed Plugins > Shipping Area for Multi-Carrier Shipping Plugin for WooCommerce
Shipping Area Management
Shipping Area Management

This image shows the settings which contain a Zone matrix with two attributes:

  • Area Name: Allows you to set a customized area name.
  • List: Contains possible selections by the type of area list selected.

To create a new area, click the Add button. A new window pops up that allows you to select the type of area list.

Area list
Area list

There are 4 options:

  •  Zone List: Allows you to set an area with your created Shipping Zones. All the created Shipping zones will be available in the List attribute. If you have not created any shipping zones, the List attribute will only contain the default shipping zone “Rest of the world.”
    Zone List
    Zone List
  • Country List:  Allows you to select countries where you ship your products.
    Country List
    Country List
  • State List: Allows you to select states to create a new area.
    State List
    State List
  • Postal Code List: Allows you to enter multiple postal codes.
Postal Code List
Postal Code List

General settings

License Activation

To activate the plugin, you need to enter the Plugin License Key and the License email ID used for the purchase.  You can find the Plugin License Key in the order completion email or in the API Keys section.

Multi-Carrier license settings

*Note: You can skip entering the License Keys while testing the plugin in the Test Mode. However, the License key is required while using the plugin in the Live Mode.

Multi-Carrier Shipping Settings

plugin setting page

The General settings contain the following:

  • Enable/Disable: Tick the checkbox to enable this shipping method.
  • Shipping API Email ID: Enter your preferred email address to enable the shipping API.
  • Shipping API Key: Once the email ID is entered, click the Get API Key (Free) button to receive the API key. Enter the key in the given text box.
  • Test Mode: Enable this option to run the plugin in the test environment. The test credentials are provided by the respective shipping carrier.
    Note: To run this plugin on a live website, replace the test credentials with live credentials provided by the respective shipping carriers and disable the Test Mode.
  • Debug: If you are not getting proper rates (lesser or higher than expected), all the available shipping options, or no rates at all, enable Debug option to find the error(s). You can also see the warning(s) by the plugin.
    By enabling debug mode, you can trace issues using log. See information about debugging at the top of the Cart and Checkout page. After enabling debug mode, add a product to cart. Go to cart or checkout page to see the debugging information.
  • Method Title: You can set your preferred method title. This title is visible in the cart/checkout page under shipping options.

Shipper Settings

To access this setting, head to Shipping Area Management section.

Shipper Settings
Shipper Settings

This setting contains the following fields:

  • Origin Address: Enter the shipper address, i.e, the address from where you’ll ship your products
  • Origin City: Enter the specific city name.
  • Origin Countries: Select the country where your shipping address is based.
  • Origin State Code: Select the state corresponding to your country.
  • Origin Postcode: Enter postcode of your shipping address.
  • Origin Phone Number: Enter your contact number.

FedEx Settings

To get the API access, you need to have FedEx credentials for the Test Account as well as the Live Account. By using the Test Account details, you can get real-time rates. After successful testing, contact FedEx to get the Live access. The Multi-Carrier Shipping Plugin needs the following information to get shipping rates from FedEx.

FedEx Settings
FedEx Settings

Once you successfully create an account in FedEx, you receive the test credentials in your email. These credentials include FedEx Account NumberFedEx Meter Number, and FedEx Web Services Password. To receive FedEx Web Services Key, follow the link in your email or login to your FedEx developer account.
Here’s how you can create FedEx account and access API credentials.

UPS Settings

The UPS Settings follow the same path. Create an account in UPS to receive test API credentials. The following information is required to access shipping rates in the Multi-Carrier Shipping Plugin.

UPS Settings
UPS Settings

Enter your Test credentials for UPS User IDUPS PasswordUPS Access Key and UPS Account Number provided to you once you have created a UPS developer account.

USPS Settings

Create an account in USPS to receive your credentials.

USPS Settings
USPS Settings

The Multi-Carrier Shipping Plugin requires two important credentials; USPS User ID and USPS Password.

Stamps USPS Settings

To receive these credentials, create an account in stamps.com.

Stamps USPS Settings
Stamps USPS Settings

Enter the Stamps USPS User ID and Stamps USPS Password obtained after successful creation of your stamps account.

DHL Express Settings

The following DHL information is required for accessing shipping rates in Multi-Carrier Shipping Plugin.

DHL Settings
DHL Settings

Enter your DHL Account No., DHL Site ID and DHL Password as obtained from DHL.

Rule Table

The Rule Table consist of 9 attributes:

  • Method Title: Allows you to set customized shipping method title (i.e FedEx Standard, Priority Shipping, etc.) for the rule. Each rule will be identified by its method title.
  • Area List: This list contains all the Area Names created in the Shipping Area Management.
    *If you haven’t created any area in the Shipping Area Management section, this list will be empty.
    *Make sure you create areas in the Shipping Area Management section before setting up a rule matrix or the plugin will not save the shipping rules that you have set.

  • Shipping Class: The Shipping Class attribute contains all the created Shipping Classes in your WooCommerce settings. Remember to create shipping classes before setting this in the rule matrix.
  • Product Category: This attribute contains all the product categories that you have created in your WooCommerce settings. Make sure you have created product categories before selecting values in this attribute.
  • Based on: Allows you to calculate the shipping rate based on 3 characteristics: Weight, Item Quantity or Price of the products.
  • Min-Max (Weight, Price, Item Qty): Based on the characteristics you select for calculating shipping rates, you can set a range for the same. That is the range for product weight, product quantity or product price.
  • Cost (Flat Rate): This amount will be used as a flat rate or added to the rates received by the carrier in the respective rule.
  • Cost Per Unit: Using this, you will be able to adjust shipping rates based on per unit weight, price or quantity of products that are in the cart. The image below shows the option to add the shipping cost per unit based on the factor selected.
    Adding-Cost-Per-Unit-for-Multi-Carrier-Shipping-plugin
  • Shipping Option: These settings contain the following possible options for shipping:
    • Flat Rate ~ For setting standard Flat Rate or Free Shipping for products.
    • FedEx ~ For using real-time FedEx shipping services.
    • UPS ~ For using real-time UPS shipping services.
    • USPS ~ For using real-time USPS shipping services.
    • Stamps USPS ~  For using real-time Stamps USPS shipping services.
    • DHL Express ~ For using real-time DHL Express shipping services.
  • Service: Allows you to select your preferred shipping service based on the selected shipping carrier in the Shipping Option list. You can select the services based on your requirement. For more information about the services, check the respective websites of the shipping carrier.

Set Shipping Rules

In order to get shipping rates on your cart page, you need to set up shipping rules based on your shipping scenario. Let us consider a simple example.

I require shipping rates based on weight for domestic and international destinations, for UPS, FedEx & USPS, for the following services.

  • FedEx 2-Day Shipping
  • FedEx International Priority
  • UPS Ground
  • UPS Worldwide Express
  • USPS Retail Ground
  • USPS Priority Mail Express

Also, apart from that, I want customers to have a Free Shipping for Order Weight above 100 lbs.

Hence, the following rules would provide the desired results in this case. Please make sure you have created shipping rules based on your shipping requirements.

Multi-Carrier Shipping Rules

Note: If you have not set up shipping rules, you will not be able to get any shipping rates on the cart page.

Show Method Groups

This option helps in grouping different shipping methods. It allows you to display multiple shipping methods, one for each group, on the cart and checkout page.

Once you enable this option, a new column will appear in the rule table. You can set a custom name for grouping the methods. Hence, if you want to display, say 3 different shipping rates, make sure there are three groups created and set up different rates. The plugin will display 3 shipping options on the cart page based on the conditions. A screenshot of the updated rule table is shown below:

The Recipient is Residential Address

This option allows you to identify the address as a residence, instead of a business address.
This option is useful in the case of FedEx. Specifying the address as Residencial is liable for extra charges. Read more about this in FedEx website.

AND Logic

This option allows you to set up shipping rules for multiple shipping classes and product categories. The plugin allows store owners to create a single shipping rule for multiple shipping classes and product category. Using the ‘And‘ Logic functionality, the plugin will let you create shipping rules in scenarios like,

  • Products from Shipping Class A is added to the cart.
  • Products from Shipping Class B is added to the cart.
  • Products from Shipping Class A or Shipping Class B is added to the cart.
  • Products from Shipping Class A as well as Shipping Class B is added to the cart.

The image below shows the option to enable the ‘And’ Logic for shipping calculation.

Enable-AND-logic-for-Shipping-Classes-and-Product-Category

Parcel Packing

This option allows you to define how items will be packed. This information will be used by the shipping carriers to calculate total shipping charges.

Parcel Packing
Parcel Packing

There are three choices:

  • Default: Pack items individually – This is the default setting, which enables the shipping carriers to pack items individually regardless of product weight and dimensions.
  • Recommended: Pack into boxes with weights and dimensions –  If packing items individually do not suit your business, then the recommended option is to define required box sizes, in terms of dimensions and volume under Box Sizes rule metric. All the cart items are packed into custom boxes defined in Box Sizes settings. Items not fitting into any of the defined box sizes will be packed individually. These settings appear as shown below:
    According to the requirement, you can add or remove the box dimensions. You can also enable or disable a particular box by selecting or deselecting checkbox under Enabled.
    Apart from custom boxes, the plugin also supports FedEx Standard Boxes. Hence, you can choose from various FedEx Standard Boxes and get shipping rates based on that.
    FedEx-Standard-Boxes-with-Custom-Boxes
  • Weight-based: Calculate shipping on the basis of total weight of the order – Calculates shipping rates based on the weight of the parcel.
    Once you select this option, two new options will be enabled; Max Package Weight and Packing Process.
Calculate shipping based on order weight
Calculate shipping based on order weight

The Max Package Weight option allows you to set the weight limit of one package. Once the limit is exceeded, a new parcel is added for other products.
The Packing Process option allows you to define how items should be packed. There are 3 possible choices with which you can – Pack heavier items first, Pack lighter items first or Pack purely divided by weight.

Packing Process
Packing Process

Tax Status

The Tax Status option allows you to charge taxes for the shipping rates. Select Taxable option if you want to tax the shipping rates. Remember to set tax calculations in your WooCommerce Tax settings. Else, select None option for not taxing the shipping rates.

Tax Status
Tax Status

Fallback Rate

If the shipping service you selected is not available in that country, the shipping rate will be calculated based on Fallback Rate. The rate is added for every unit of product that does not fall on any shipping service.

Fallback Rate
Fallback Rate

Fallback Rate On

This option helps in calculating the Fallback Rate based on two characteristics –

  • Per Unit Weight: Based on the weight of each item, the fallback rate is calculated.
  • Per Unit Quantity: Based on the number of items, the fallback rate is applied to each item regardless of its weight and dimension.
Fallback Rate On
Fallback Rate On

How does this work?

Now that you have understood the plugin configuration, you can check out how Multi-Carrier shipping plugin works.

Last Updated On November 28, 2018

3 thoughts on “How to setup Multi-Carrier Shipping Plugin for WooCommerce?

  1. JOSHUA says:

    Hi,
    For some reason my shipping always says $250. it does not matter what service i use, fedex, ups, usps.

  2. joe34 says:

    I’ve followed all the instructions, yet I do not get any shipping rates or methods in my cart.

    • Anindo
      Anindo says:

      Hi Joe,
      Can you enable the debug option in plugin settings page and then try to place an order? You will get a request and response. You will be able to make out the problem from that.
      If you are still not getting it, just raise a ticket to our support and provide us access so that we can quickly fix this.

Comments are closed.