like twtr linkedin

Opencart 3

OpenCart 3 Shipping Module

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

Our OpenCart 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. And 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.

The installation of the MDS Collivery 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 but by default our demo account is used so that you may test your new plugin before going live.

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
    1. Prerequisites
    2. Disclaimer
    3. Setup
    4. Configuration
  3. Usage Examples
    1. Shop Integration (Client)
    2. Admin Interfaces
  4. Trouble Shooting Guide


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. By default the plugin uses our demo account so that you can test your new plugin before going live.
This plugin gives your OpenCart 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 Collivery through to us, 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 and view proof of delivery.

Installation Instructions


Prerequisites before installing our Extension:

  • OpenCart Version:
  • PHP Version 5.6 or above
  • PHP SoapClient enabled

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 OpenCart 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.
  •’s integration team will provide all assistance to the client in the integration process and, where possible, will provide technical support to the client.
  • This plugin only supports your primary address as listed with as a collection point during the checkout to display a quote for shoppers. Changing of collection addresses can only be done in the admin area.
  • This plugin does no unit conversion and works with the units cm - centimetre, kg - kilogram and the currency R - ZAR rand. Whatever specs we receive or send out will be in cm, kg or R regardless of the symbol unit that is printed out.
  • This plugin only allows for you to dispatch deliveries. To cancel deliveries you will have to log in to
  • This plugin requires javascript enabled in browsers to work.
  • This plugin requires specific non standard address fields to work. Current addresses will have to edited once so that they contain the correct fields of data.
  • Please ensure the - OpenCart Plugin you download and install is the correct plugin for your version of OpenCart. This is most important as OpenCart version updates are major updates and not backwards compatible.


Step 1 : Download and upload

First, you download the zip archive containing the module files here, This is for opencart

Now, go to your browser and navigate to your OpenCart site administration backend. In the "Extensions" menu select "Installer" and upload "".

Step 2 : Refresh Mods

Next navigate to "Extensions" menu select "Modifications" and refresh mods. Please note that this will reload ALL the ocmod files that are listed.

Step 3 : Install Plugin

Then, navigate to "Extensions -> Extensions", on the extension dropdown. Select "Shipping(Number)" Then click the green button to install

Step 4 : Edit

Now, click the blue button to edit the plugin

Step 5 : Configure Plugin and save

After clicking edit, You should see a screen that looks similar to the one below. Fill all the required fields and then enable the plugin to start using it

To uninstall navigate to "Shipping" in your admin back office, search for the shipping extensions and then click on "uninstall". Next navigate to "Extensions" menu select "Modifications", delete the modification file for and refresh the cache. Please note that this will reload ALL the ocmod files that are listed.


To configure navigate to "Shipping" in your admin back office, search for the shipping extension and then click on "Edit".
Here you will enter in your login details, as well as add a markup/handling fee for each service. You can also change the display title that will be used for displaying a quote during the checkout process and indicate if you would like risk cover enabled on your colliveries.

Usage Examples

Shop Integration (Client)

The shopper will check out as per usual. When selecting the delivery method the different services we offer will be displayed with your markup/handling fee already calculated if you specified one as well the display title that was configured in the admin section.

When saving or adding addresses the following fields must be completed otherwise the shipping fee returned may inaccurate or no shipping fee at all will be returned.

Admin Interfaces

After confirming the shipping address, the plugin will create a waybill at when it is set to "auto-create-waybill" on the admin and it will auto accept it its its set to "auto-accept-quote" as well

Uninstall Instructions

The plugin will remove all the installed files, please refresh mods after uninstalling

Trouble Shooting Guide

It is sometimes useful to uninstall and reinstall the plugin when facing issues.

Error: Undefined property: Proxy::addMdsTransactionTable
This usually occurs when the installation instructions were followed in the incorrect order, follow our uninstall guide and then follow the install guide again
MDS admin order tab or checkout delivery options not displaying.
Ensure that the files were uploaded to the correct folders, that the extension is enabled and mds.ocmod.xml was uploaded and cache refreshed.
Custom address fields not displaying.
Check if they are added in the admin custom field section. If they are not follow the uninstall and then install instructions.
Custom address field values are not being populated.
Upload mds.ocmod.xml_error_string and refresh the oc_mod cache.
Ensure that your soap serivice is working and that you have the correct MDS login details in the admin MDS extension configuration section.
Error: Undefined index or id.
Ensure the collection and delivery addresses have the necessary address fields saved as specified in the front-end usage section.
Error: Invalid information
Ensure the collection and delivery addresses have the necessary address fields saved as specified in the front-end usage section as well as the validity of the values saved.
Error: Authentication or Login
Please check your MDS login details
Error: Unable to connect or SOAP
Ensure your SOAP service is working and that your MDS login details are correct.
Error: Permissions
Contact your hosting provider to ensure the proper file access permissions are applied to the related files/directories in the error.
^ Top ^