like twtr linkedin


WooCommerce Shipping Module

Shipping is an important part of your eCommerce business, yet it’s certainly not the first you think of when planning your new business. And why should it be?

Our WooCommerce plugin allows you to seamlessly integrate your website with our shipping platform, allowing customers to get accurate prices for the shipping of their goods, upfront. With a click of a button, all their details will be added to our system, allowing you to rest peacefully at night, knowing your stock will arrive on time, every time.

Point your developer to the installation instructions below to get started, or email us at [Enable JavaScript to view email].

Table of Contents

  1. Overview
  2. Installation Instructions
  3. Usage Examples


The installation of the plugin is as easy as a few clicks of the mouse, once installed the plugin will only need you to enter your username and password and confirm the zone settings.
By default, the plugin uses our demo account so that you can test your new plugin before going live.
This plugin gives your WooCommerce store the ability to get prices from based on the dimensions and weight of the products added to your client’s cart. After the client paid, the plugin will send the details of the through to us automatically or allow you to do so manually in your backend, also allowing you to modify the particulars of the delivery before sending the delivery request to
Once the delivery is accepted, the delivery's details are saved in your database where you can access the delivery in order to track its status, display parcel images and proof of delivery.

Installation Instructions


Prerequisites before installing our Extension:

Make sure before installing this plugin that you make a full SQL database backup and a full backup of all your files. If for some reason something goes wrong, you will need this backup to get your website back to where it was before. Also, please note before updating your WordPress or WooCommerce version make sure you confirm with us that the plugin does support the new version.


  • provides the following plugins as a service to our clients.
  • The responsibility to ensure that the integration is working correctly rests with the client.
  • does not accept responsibility for any errors in pricing, addresses or any other part of the Collivery process which may not work correctly.
  • By downloading the attached plugins the clients accepts the above conditions and will not in any way hold responsible for errors.


  • The MDS API and all of its plugins do not support international deliveries, however you are able to set a fixed price using the plugin or have the other regions in other zones to use other shipping methods.


Installation is as simple:

  1. Download the plugin from our website
  2. Download WooCommerce
  3. Login to the admin backend of your WordPress site, on the left panel click on Plugins then click on Add New.
  4. Click on Upload Plugin. Click Choose File , navigate to where you downloaded the MDS Collivery Shipping plugin and select and open. Then select Install Now.
  5. Upload Plugin
  6. Once the plugin is installed it will ask you to activate it. Click on Activate Plugin.
  7. Installing Plugin
  8. Congratulations the plugin is now installed!!
  9. Plugin Installed

Pre-configuration recommendations

In your backend go to WooCommerce Settings.

WooCommerce Menu

In the general settings in WooCommerce.

  • Select No location by default in the Default customer location. The MDS Plugin does not work with geolocation.
  • WooCommerce General Settings

    In the Shipping tab select Shipping Options.

    WooCommerce Shipping Options

  • Please make sure the Enable the shipping calculator on the basket page is disabled.
  • You can also select the Hide shipping costs until an address is entered setting which assist any confusion if the shoppers address does not match any zones created.

  • WooCommerce General Settings 2

    MDS Collivery Shipping configuration

    Navigate to the MDS Collivery shipping plugin page. WooCommerce - > Settings.

    WooCommerce Menu

    Click on Shipping, then just below where you clicked on Shipping click on MDS Collivery shipping (Please don’t click on the one in the zones, we’ll get to those settings just now).

    Navigate to MDS Plugin Settings

    Here is where the main configuration of the plugin is set
    Before you get worried the different services are set in the zones which are further below but do not skip ahead yet.

    MDS Plugin Settings 1
    1. Is used when you are having issues with the plugin, perhaps there have been price changes or new cities or suburbs loaded onto the system and you would like to retrieve them.
    2. When you are having issues with the plugin please download error logs and email them to [Enable JavaScript to view email].
    3. Enable or disable the plugin.
    4. Your MDS Collivery user name, it is strongly recommended that you create an alias for the user who is in charge of the shop perhaps or this will allow you to easily identify which waybills were created by your store and those by a human logging into
    5. Your password associated with the username in (4).
    6. If you would like the description of the products to be added to the special instructions of the waybill so they appear when the waybill is printed.
    7. If you would like the order number to be added to the special instructions of the waybill so they appear when the waybill is printed as well.
    MDS Plugin Settings 2
    1. The suffix of the order number if present
    2. If you would like the customer's notes to be added to the special instructions of the waybill so they appear when the waybill is printed as well.
    3. Round Up the shipping cost, so instead of the shipping cost being R123.43 it will be R124
    4. If Woocommerce is setup to add VAT onto the shipping cost then you should uncheck this box to use the exclusive amount, this way VAT will only be applied once. If you are not adding VAT onto the shipping cost using Woocommerce then always use the inclusive amount. This option only affects the price displayed on your checkout page, MDS Collivery will always bill you the inclusive amount.
    5. Include MDS Risk Cover with each order
    6. By default MDS covers the up to R1000 on each waybill that does not have risk cover enabled. Please also bear in mind that MDS will on completion of a successful claim pay back the cost of an item, so perhaps your cart amount needs to be R1250 if your mark-up on your goods is 25%
      Please note there are some exclusions to risk cover as detailed in our Terms and Conditions
    MDS Plugin Settings 3
    1. Exclude non-deliverable items from shipping calculation such as Virtual
    2. Exclude non-deliverable items from shipping calculation such as Downloadable
    3. Free delivery mode (explained below)
    4. If you would like the waybill to be automatically generated when a order goes into the Processing status
    5. Select the statuses that will trigger Automatic MDS Processing(Hold CTLR to select multiple)
    6. If you would like waybills added to be accepted, so if you have (17) enabled and/or (18) disabled you can technically never need to log into your Wordpress site to action waybills, they will always bee added to our system and you can log into to accept once you are ready for the collection to take place

    Free Shipping configuration

    There are three options available for you to add more functionality to your shipping settings, free delivery mode.

    • No free deliveries
    • No Free Shipping
    • Free delivery
    • Free Shipping
      1. The Wording on checkout that will display
      2. The minimum cart amount needed for free shipping to apply
      3. Any roles where free shipping will not apply
      4. Enable if you would only like free shipping to apply to local deliveries
    • Discounted delivery fee
    • Discounted Shipping
      1. The percentage discount you would like to apply to the shipping
      2. The minimum amount of the cart before discount is applied
      3. Any roles where discounted shipping will not apply

    Setting up Zones

    Navigate to Shipping Zones. WooCommerce -> Settings - > Shipping

    WooCommerce Menu
    WooCommerce Zones

    Click on WooCommerce Add Zone

    Give the zone a name, then select a region for the zone.

    WooCommerce New Zone Settings

  • The recommended procedure is to add one zone for the whole of the South Africa Region, you can however add multiple zones for which there maybe different regions and in each of those regions you can apply different settings. However we strongly recommend on first configuration to only have one zone. When the plugin is working you can come back and split up the zones if you would only like to apply certain services to certain zones.
  • You can NOW also add non South African zones however waybills will not be generated
    The service's fixed rate for that zone will be used as the shipping cost so make sure its correct for that zone
  • Once you have selected the region click on Add shipping method grey and select MDS Collivery Shipping and then on Add shipping method blue

    Add shipping method list

    Now that the MDS Collivery shipping method has been added to the zone you can now edit it.

    List of added shipping methods

    In the settings of the zone instance of MDS Collivery shipping you can:

    Options 1,2,3,4 are repeated for each service Edit shipping method
    1. Enable or disable services
    2. The fixed amount for this service should you wish not to display the actual shipping costs
    3. Change the percentage mark-up on the shipping costs (this has been put in place to add safe guard if the dimensions sent to MDS Collivery are not the same as the physical shipment, once your shopper has checked you may find it difficult to recoup price changes and it also adds an extra income).
    4. Change the wording that will appear on the checkout page next to the shipping cost.
    5. Select the service that will be used on Free shipping.
    6. Select the service that will be used on Free shipping when it is free local only.

    With the ability of using zones, you can have different settings for different areas.

    Usage Examples

    Shop Integration (Client)

    Once your shopper has filled in the address details the shipping prices will display below, depending in which zone the shopper falls in they will be priced accordingly.

    Example Checkout page

    Shop Integration (Admin interface)

    Once your shopper has placed the order the order will be available to process in your backend. With automated waybill processing, waybills are processed when an order goes into “Processing” this usually occurs when the payment has been received. If you have automated processing enabled and your order goes into processing it will generate and MDS Collivery waybill. If you also have Auto accept enabled the waybill will also be accepted and we will then dispatch a driver to collect. If you do not have auto accept enabled, you will need to log into your overview to accept the waybill.

    If an order is On hold and you have automated processing enabled and you are ready for collection you can change the status to processing and it will generate a waybill and if auto accepted they waybill will be accepted.

    If you have not enabled automated processing:

    • Open the order, in the order actions select the action Confirm MDS Shipping and click update or Accept button
    • Order actions list
    • You will then be taken to a page where you can review the details of the waybill.
    • Confirm MDS Shipping
    • Click Get Quote to see the pricing and/or Accept/Dispatch to generate a waybill.
    • Added MDS Shipping
    • To view your history of waybills go to WooCommerce > MDS Confirmed.
    • Confirmed MDS Shipping
    • Click on a waybill to view the details, open waybill pdf and POD pdf (when POD is available).
    • To Link an already generated waybill to the order, usually from international orders. Type in the waybill number to link
    • Link International Waybill
    • Linking International waybill

    If you encounter any issue please do not hesitate to email us [Enable JavaScript to view email]. If possible please attach your error logs from the Download Error Logs button in the MDS Collivery Shipping main config.

    ^ Top ^