Opencart Marketplace Advanced Custom Shipping

Installation of Opencart Marketplace Advanced Custom Shipping for Opencart is very simple. After extracting the zip file, choose your Opencart Version Folder and in that, you will find folders admin, catalog, and ocmod. Now, copy the admin and catalog folders into the root directory of your Opencart website. Please view the screenshot below for better understanding.

Once you have copied the folders in the previous step, then login to admin and from the main menu go to Extensions->Extension installer and upload the XML file –  wkadvancecustomshipping.ocmod.xml. The XML file can be found inside the ocmod folder of the downloaded zip. Please choose the correct Opencart Version Folder.

After uploading the wkadvancecustomshipping.ocmod.xml file, go to the Extensions > Modification and click on refresh field.

After that in Admin panel go to System -> Users -> Usergroup and edit ‘Administrator’ and click on select all for both Access and Modify Permission and save it.

After that navigate to Extensions -> Shipping-> Opencart Marketplace Advance Custom Shipping. Now click on the edit button to edit the module.

This Opencart Marketplace Advanced Custom Shipping module supports multiple languages so this section will describe how to make the module work in different languages. Please check this link for language translation.

After the successful installation of the module, the admin will navigate to Extensions->Shipping->Marketplace Advanced Custom Shipping and tap the edit button to configure the module for use.

Here the admin can:

• Enable/Disable the module.
• Select the Seller Allowed Category(Flat Rate, Per Item, Post Code, Price, Quantity, Total, Weight, & Volume) by which the seller can create the charges.
• Set the Seller Allowed Rules(Round, Adjust, Maximum, Minimum, Zone, City, Country, Post-Code, and Currency) which can be used by the sellers to apply rules on the charges.
• Set “Seller Override” to Enabled/Disabled(If no shipping charge has been made by the seller and the Override option is set to “Enabled” then the sellers shipping cost will be calculated on the basis of the admin’s shipping formula).
• Select the Tax Class as required.
• Select the Length Class(Whatever option you select, the length of the product will be converted into that).
• Select the Weight Class(In this weight class, the weight of the cart will be converted).
• Set the Sort Order for the shipping module.

After the configuration of the module, the admin will tap the save button to save the configuration.

• Flat Rate
  With this option, the seller can set Flat Rate for his shipping.
• Per Item
  With this option, the seller can set Per Item shipping cost.
• Post Code
  With this option, the seller can set the shipping cost by using the zip code of customer.
• Price
  With this option, the seller can set the shipping cost by using total cost of products without tax in the seller cart.
• Quantity
  With this option, the seller can set the shipping cost by using the total quantity of products in the seller cart.
• Total
  With this option, the seller can set the shipping cost by using the total cost of products with tax in the seller cart.
• Weight
  With this option, the seller can set the shipping cost by using the total weight of products in the seller cart.
• Volume
  With this option, the seller can set the shipping cost by using the volume of product in the seller cart.

• Round
  The round will change the amount by which shipping charge will be calculated.

          Round has three options to select from –

• To the Nearest
• Down to the Nearest 
• Up to the Nearest
  
  For Example – 1
• To the nearest(Value nearest to the integer value is selected), Cost=7, Round=3

In this case, 7/3 = 2.33 => . 33 < . 5 => 2

• Down to the Nearest(Value nearest to lower integer value), Cost=7, Round=3

In this case, 7/3 = 2.33 => . 33 > . 5 => 2

• Up to the Nearest (Value Nearest to the Upper integer value ), Cost=7, Round=3

In this case, 7/3 = 2.33 => . 33 < . 5 => 3

        For Example – 2

• To the nearest(Value nearest to the integer value), Cost=8, Round=3

In this case, 8/3 = 2.66 => . 66 > . 5 => 3

• Down to the Nearest(Value nearest to lower integer value), Cost=8, Round=3

In this case, 8/3 = 2.66 => . 66 > . 5 => 2

• Up to the Nearest (Value Nearest to the Upper integer value ), Cost=8, Round=3

In this case, 8/3 = 2.66 => . 66 > . 5 => 3

• Adjust
  This will allow the seller to adjust shipping amount after shipping calculation of that charge.

Here you can select with-in two options:

1. Final Charge
2. Sub Charge

• Maximum
  This will be the maximum amount that seller can charge from the customer.
  For example; The shipping charge is $80 and the seller has maximum amount to $50, then shipping charge will be 50$.
• Minimum
  This will be the minimum amount that seller can charge from the customer.
  For Example; If the shipping charge is calculated $30 and the seller has set the minimum amount to be charged as $50 then the shipping cost will change to $50.
• Zone 
  Here the seller can select the Zone as  – Is or Is Not.
• City
  Here the seller can select the City as  – Is or Is Not.
• Country
  Here the seller can select the Country as  – Is or Is Not.
• Post Code
  Here the seller can select the Post Code as  – Is or Is Not.
• Currency
  Here the seller can select the Currency as  – Is or Is Not.

After the successful installation of the module, the sellers will find two menu options under their account panel to manage their shipping  –

• Advance Shipping List
• Charge Combination

After clicking on the “Advance shipping List” menu option another page opens up and here you can find a list of all the shipping charges.

Here, the seller can add a new charge, delete a charge, and can edit any previously created charges. To create a new charge, click on the “Add” button.

After clicking the add button, another page opens up where the seller has to input the Charge Name, Choose Shipping Charge Type(From the allowed charge types allowed by the admin), input the Price Per Item (according to the shipping charge type selected the seller). After this, the seller will click on the “Rule” button to define the rules that will be applicable to this configuration.

Clicking on the “Rule” button will bring up the option to select how the rules will be applicable for the current configuration.

The seller can select from the below-mentioned rule options –

Adjust –

• Round
• Adjust
• Maximum
• Minimum

Location –

• Zone
• City
• Country
• Post Code

Order –

• Currency

After setting up the rules applicable for this configurations setting, click the “Save” button to save the charge list.

Under this menu option, the sellers will be able to set the charge combination/charge formula that will be applicable on the shipping charges to generate the final shipping price.

To add a new charge formula click the “Add” button as per the snapshot below.

Note: Always remember that the number of left brackets used should equal the number of closing brackets. Also, remember to use the comma separator for separating the charge list Ids.

Also, a formula gets applied according to the sort order of the formula.

Formula Example:     max(sum(5,6,7),avg(5,6,7)) [The numbers here signify the Charge list IDs].

When Buyer will place an order of seller’s product, the buyer can see Advanced Custom Shipping under the shipping methods like the below screenshot.

Buyers will be able to see the selected shipping method again at “Order Review” section, and then the buyer can tap on “Confirm Order” button to complete their order.

After the invoice gets generated, the customers can also see the selected shipping method for the ordered products under Order History ->View Order page as shown below in the snapshot.

After the installation of the module is complete the admin will see “Advanced Shipping” menu option on the admin side panel with two sub-menus –  Charge list and Formula List.

The admin can set the configuration for himself or for the Marketplace sellers.

Under this sub-menu option, the admin will find all “Charge list” of the marketplace sellers that they have created under their own account panel. Here the admin can edit/delete any charge list, approve/disapprove the charge list of any marketplace seller.

The admin can also add the charge list for himself and the marketplace sellers.

Note: After the charge list has been added, it has to be approved by the admin first. Else, the charge list won’t appear under the charge list menu option in the seller panel.

To add a charge list for himself, the admin will click on the “Admin” button visible on the top right-hand side. After clicking the button, another page opens up where the admin can add his own charge list as shown below in the snapshot.

Here the admin will:

• Enter the Charge Name that is easily recognizable.
• Set the Status as Enabled/Disable as required.
• Choose the Shipping Charge Type from the drop-down.
• Select the Country for which the shipping type will apply.
• Click here to upload the CSV file.
• Select the Uploaded CSV table type as Fixed or Range.
• Select the Separator for the file.

Now click the save button on the top right-hand side to save this CSV file. After saving the file you can see another page to map the CSV values. After selecting the corresponding values click the save button to save the charge list.

To add the charge list for the marketplace sellers click on the “add” button at the top right-hand side of the charge list page. Now, another page to add the seller charge list will open as shown below in the snapshot.

Here for the seller, the admin will –

• Select the Seller Name.
• Enter the Charge Name.
• Set the Status of the charge list as Enabled or Disabled.
• Choose the Shipping Charge Type from the drop-down option.
• Enter the value for the Flat Rate and select it as Fixed or Percentage.
• Admin will set the rule to apply by tapping the Rule button.

Lastly, the admin will click the save button to save the configuration for the seller.

Admin can easily add the Formula list for his own usage. To do so click on the “Admin” button on the “Formula list”  page as shown below in the snapshot.

After this, another page opens up where the admin will fill and select the required fields. After filling all the data click the save button to save the formulas as shown below in the snapshot.

Admin can also add the Formula list for the marketplace sellers. To do so click on the add button on the “Formula List”  page as shown below in the snapshot.

After this, another page opens up where the admin will fill and select the required fields as shown below in the snapshot.

After configuring the setting, the admin will click the save button to save the charge list for the selected marketplace seller.

Sellers will also be able to see the shipping method being used for their orders by going to account ->order history->order information as per the screen shot below.

The shipping method name used can be seen in the order invoice as well as shown below in the snapshot.

That’s all for the Opencart Advanced Custom Shipping module still have any issue feel free to add a ticket and let us know your views to make the module better at webkul.uvdesk.com.