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
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. 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 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
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 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 and view proof of delivery.
Installation Instructions
Prerequisites
Prerequisites before installing our Collivery.net Extension:
- OpenCart Version: 3.0.3.1
- 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.
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.
- Collivery.net’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 Collivery.net 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 collivery.net
- 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 Collivery.net - 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.
Setup
Step 1 : Download and upload
First, you download the zip archive containing the module files here, This is for opencart 3.0.3.1.
Now, go to your browser and navigate to your OpenCart site administration backend. In the "Extensions" menu select
"Installer" and upload "collivery.ocmod.zip".
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 Collivery.net
Step 4 : Edit Collivery.net
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 Collivery.net shipping extensions and then click on "uninstall". Next navigate to "Extensions" menu select "Modifications", delete the modification file for Collivery.net and refresh the cache. Please note that this will reload ALL the ocmod files that are listed.
Configuration
To configure navigate to "Shipping" in your admin back office,
search for the Collivery.net shipping extension and then click on "Edit".
Here you will enter in your Collivery.net 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 Collivery.net 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.