WooCommerce Shipping Module

Download

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
   • Prerequisites
   • Disclaimer
   • Setup
   • Pre-configuration recommendations
   • MDS Collivery Shipping configuration
   • Free Shipping configuration
   • Shipping Zones Configuration
3. Usage Examples
   • Shop Integration (Client)
   • Admin Interfaces

Overview

The installation of the Collivery.net 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 Collivery.net 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 Collivery.net 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 Collivery.net.
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

Prerequisites before installing our Collivery.net Extension:

• PHP Version 7.4 To 8.0
• WordPress Version: From 5.1 To 6.1.1
• WooCommerce Version: From 5.1 To 6.9.4
• Collivery.net Shipping Module for WooCommerce

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.

Disclaimer

• Collivery.net provides the following plugins as a service to our clients.
• The responsibility to ensure that the integration is working correctly rests with the client.
• Collivery.net 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 Collivery.net responsible for errors.

Notice:

• 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.
  

Setup

Installation is as simple:

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

Pre-configuration recommendations

In your backend go to WooCommerce Settings.

In the general settings in WooCommerce.

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

In the Shipping tab select 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.

MDS Collivery Shipping configuration

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

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).

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.

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 online@yourdomain.co.za or shop@yourdomain.co.za this will allow you to easily identify which waybills were created by your store and those by a human logging into Collivery.net.
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.

8. The suffix of the order number if present
9. 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.
10. Round Up the shipping cost, so instead of the shipping cost being R123.43 it will be R124
11. 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.
12. Include MDS Risk Cover with each order
13. 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

14. Exclude non-deliverable items from shipping calculation such as Virtual
15. Exclude non-deliverable items from shipping calculation such as Downloadable
16. Free delivery mode (explained below)
17. If you would like the waybill to be automatically generated when a order goes into the Processing status
18. 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 Collivery.net 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
• 
• Free delivery
• 
• 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
• 
• 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

Click on

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

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 and select MDS Collivery Shipping and then on

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

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

Options 1,2,3,4 are repeated for each service

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.

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 Collivery.net 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
• 
• You will then be taken to a page where you can review the details of the waybill.
• 
• Click Get Quote to see the pricing and/or Accept/Dispatch to generate a waybill.
• 
• To view your history of waybills go to WooCommerce > MDS Confirmed.
• 
• 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
• 
• 

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.