MarketShip

Click here to purchase MarketShip!

Minimum Requirements

MarketShip requires PHP 5.6+, WooCommerce 3.0.0+, and one of the following plugins:

  • Dokan 2.6.0+
  • WC Vendors 2.0.0+ and WC Vendors Pro 1.5.4+

Installing MarketShip

To install MarketShip:

  1. Log into your WordPress site.
  2. Go to Plugins > Add New.
  3. At the top of the screen, click Upload Plugin.
  4. Select the .zip file sent to you in your Purchase Confirmation email. You have two options:
    1. Click Browse. Find and select the plugin .zip file.
    2. Drag and drop the .zip file onto the Upload Plugin screen.*
  5. Click Install Now.
  6. When the installation completes, click Activate.

* Drag and drop will only work if your browser supports it!

Activating Your License

To benefit from future updates to MarketShip, you must activate your license key. To do so:

  1. Log into your WordPress site.
  2. Go to Plugins.
  3. Find the row for MarketShip.
  4. Click activate license.
  5. Enter your license key, which was delivered along with your download.
  6. Click Activate.

Getting Started

This section describes the initial setup steps for MarketShip. You must complete these steps or vendors won’t be able to connect their Shippo accounts to calculate live shipping rates and print shipping labels.

Step 1: Obtaining a Client ID

MarketShip leverages Shippo’s OAuth Connection Flow to enable vendors to connect their Shippo accounts with the click of a button. In order for this feature to work correctly, you must obtain a Shippo Client ID and Client Secret and enter these values on the MarketShip settings page.

To get started, simply send an email to partnerships@goshippo.com with the following information:

Item Description
Company Name Your company’s name. This is presented to the user when they connect their Shippo account to your marketplace.
Callback URL The URL vendors are redirected to after they connect their Shippo account. This is your WordPress site URL followed by /shippo-oauth-redirect.
Contact Email Your email address.

For your convenience, we’ve created a template you can copy and paste to quickly draft this message:

Hi,

I need OAuth Credentials for my marketplace. I’ve included all requisite information below.

  • Company Name – <your company name>
  • Callback URL – <your website URL>/shippo-oauth-redirect
  • Contact Email – <your email address>

Please let me know if you need anything else.

Thanks,

<your name>

Here’s an example of what the template should look like when complete:

Hi,

I need OAuth Credentials for my marketplace. I’ve included all requisite information below.

  • Company Name – Super Market
  • Callback URL – https://example.com/shippo-oauth-redirect
  • Contact Email – hello@example.com

Please let me know if you need anything else.

Thanks,

John

Once your email is sent, you should receive a response within 24-48 hours. At that point you can proceed to Step 2.

Step 2: Update MarketShip Settings

Navigate to WooCommerce > Settings > Shipping > MarketShip and paste your Client ID and Client Secret into their respective fields.

Enabled Shipping Methods allows you to enable/disable the available shipping methods for your vendors.

Once you are done configuring Marketship, don’t forget to click Save changes!

Hint

You can use the Enable/Disable checkbox to quickly enable or disable all MarketShip functionality.

 

Shipping Products

MarketShip includes several flexible shipping methods for your vendors. This section describes how vendors can use these shipping methods to ship their products.

Configuring Shipping Methods

Vendors can configure the shipping methods for their store on the vendor shipping settings page. The settings page is located under Settings > Shipping in the vendor dashboard.

From here, vendors can choose a Default Shipping Method for their products.

If a shipping method has store level settings, a Configure button will appear next to the method description. Clicking this button will open the settings page for the selected shipping method.

Please consult the MarketShip Shipping Methods section of this document for a description of the MarketShip shipping methods and their settings.

The Live Rates, Flat Rate, and Free Shipping methods are built in to MarketShip and will be present for all users. Additional shipping methods may appear based on the marketplace plugin installed.

Choosing the Shipping Method for a Product

With MarketShip, vendors can select a single shipping method for each of their products. The product shipping method can be set using the Shipping Method dropdown on the add/edit product screen. For Dokan users this can be found under Shipping and Tax, whereas for WC Vendors users it is located under the Shipping tab.

Choosing a shipping method for a product

By default, all products use the Default Shipping Method configured at the store level. The shipping method can be changed by unchecking Use Default.

If a shipping method has product level settings, new settings fields will appear when that method is selected. Continue reading to learn about the product level settings for each MarketShip shipping method.

MarketShip Shipping Methods

This section describes the MarketShip shipping methods and documents their product and store level settings (if any).

Live Rates

The Live Rates shipping method calculates shipping rates from the carriers enabled in the vendor’s Shippo account. It’s a great option for vendors who want to provide accurate, real time shipping quotes to their customers at checkout.

Heads up!

The Live Rates method must be setup if a vendor wishes to use the label printing feature.

Store Level Settings

The Live Rates method has a number of store level settings, depicted in the screenshot below.

Live Rates method settings

The settings are:

Live Rates

Controls whether the Live Rates method is enabled or not.

Shippo Account

Allows vendors to quickly connect or disconnect their Shippo account using Shippo’s OAuth Flow. Vendors must connect an account for the Live Rates method to function properly.

Packing Strategy

In order to provide accurate shipping quotes, the Live Rates method must pack the vendor’s items into one or more boxes. This option allows the vendor to control how their items are packed. There are two choices:

  • Pack items individually – Pack each item separately into the smallest box that can fit it.
  • Pack items together – Pack items into one or more boxes using the BoxPacker algorithm.

Pack items together will generally yield the most accurate shipping rates, but Pack items individually may be more appropriate for certain vendors.

Boxes

In order to pack the vendor’s items at checkout, Live Rates needs to know the boxes the vendor will be using for shipping. The vendor can manage their shipping boxes in this section.

To add a new box, simply click Add Box. For your convenience, you can either select from a predefined box template or choose to enter a custom box. Please note that when entering a custom box you should enter the box’s outer dimensions. The inner dimensions will be estimated automatically.

Adding a box in MarketShip

To edit or delete a box, click the pencil icon or trash icon, respectively, next to that box in the Boxes table.

Usable Box Volume

By default, MarketShip will only use 85% of a box’s inner volume for packing. This is to account for extra space occupied by packing materials, instruction manuals, and so on. Developers can increase or decrease the usable box volume with the marketship_usable_box_volume filter.

Too Large Items

Currently items that are too large to pack into the configured boxes will be skipped. Vendors should take care to ensure that they have configured appropriately sized boxes for all of their products.

Product Level Settings

None.

Flat Rate

The Flat Rate method allows vendors to set a flat shipping rate for each country and state they ship to. It’s great for vendors who want to offer simple flat shipping rates and reuse those rates across multiple products.

Store Level Settings

None.

Product Level Settings

The Flat Rate method has a number of product level settings as depicted in the screenshot below.

Flat Rate shipping method settings

The settings are as follows:

Shipping Profile

Shipping Profiles provide a way for vendors to reuse shipping rates for items with similar shipping requirements. The vendor can either choose an existing shipping profile or select Add new profile to create a new one. If an existing profile is selected, the rates defined in that profile will be used for the product.

Profile Name

Allows vendors to set the shipping profile name when adding a new profile.

Calculation Method

Controls how the entered shipping costs are applied to calculate the shipping rate. There are two choices:

  • Apply rate once per product – When selected, the entered shipping cost will be applied only once for the product. In the example above, the shipping rate will be calculated as $5 for a customer in the U.S., even if the quantity purchased is greater than 1.
  • Apply rate once per quantity – When selected, the entered shipping cost is applied once per quantity purchased. In the example above, the shipping rate will be calculated as $15 if a customer in the U.S. purchases 3 of the product.

Maximum Charge

Allows vendors to set a maximum shipping charge for the product. Useful when combined with the Apply rate once per quantity calculation method.

Shipping Rates

This is where vendors enter the per-product or per-quantity shipping cost for each country they ship to. Country level rates can be overridden for individual states, and there’s a convenient Everywhere Else option that can be used when the shipping cost is the same in all but a few countries or states.

Vendors must enter at least one shipping rate for the Flat Rate method to work properly.

Free Shipping

The Free Shipping method is very simple. When selected, shipping will not be charged for the product. It’s perfect for vendors who want to ship their products for free.

Store Level Settings

None.

Product Level Settings

None.

(Dokan Pro) Product Shipping

The Product Shipping method is registered when Dokan Pro is installed if the old Dokan Shipping method is enabled under WooCommerce > Settings > Shipping > Dokan Shipping. Its functionality and settings are identical to the old Dokan Shipping method.

Please consult the Old Dokan Shipping Method documentation for more information.

(Dokan Pro) Shipping Zones

The Shipping Zones method is registered when Dokan Pro is installed and the Vendor Shipping shipping method has been added to one or more WooCommerce Shipping Zones. Its functionality and settings are identical to those provided by Dokan Zone Wise Shipping.

Please consult the Dokan Zone Wise Shipping documentation for more information.

Note for Established Dokan Pro Marketplaces

MarketShip will set the Default Shipping Method for all vendors to either Product Shipping or Shipping Zones based on whether the vendor has the Old Dokan Shipping method enabled or not. This measure ensures that your checkout continues to function normally as vendors adopt the new shipping system.

(WC Vendors Pro) Seller Shipping

The Seller Shipping method is registered when WC Vendors Pro is installed. It is simply a MarketShip compatible version of the WC Vendors Pro Shipping System.

Table Rate Shipping

If you are also running Table Rate Shipping, it will appear as a shipping option to your vendors as well.

Printing Labels

Vendors who have enabled the Live Rates method can print shipping labels in multiple formats straight from their vendor dashboard. Here’s how that process works:

  1. Go to the Orders page in the vendor dashboard. Either select an order (Dokan) or hover over an order row and click the Shipping Labels link that appears (WC Vendors Pro). You will now see a list of shipping labels similar to this:

  1. To print a shipping label for your order:
    • Click Create new label
    • Enter the full address you’re shipping from, if it’s the first time printing a shipping label.
    • Verify the destination address.
    • Verify the packaging.
    • Select the desired shipping service (rate).
    • Select paper size (optional).
    • Buy & Print
  2. After clicking Buy & Print, label(s) are automatically opened in a print dialog.

Some browsers, like Firefox, don’t support automatic label printing. If you’re using one of these browsers, the label(s) will open in a new tab instead.

The Shipping Labels box will display the label(s) you purchased, and contains the tracking number for your shipment. The tracking number(s) will be included in the email sent to your customer when the order is marked “completed.”

You can also reprint your label or request a refund, if necessary.  Click the three ellipsis menu for the label to reveal these options.

Shortcodes

MarketShip comes with a [marketship_tracking_numbers] shortcode for displaying a table of tracking numbers for an order. The shortcode has two attributes:

  • order_id – Order ID (required)
  • table_class – Optional CSS class for the tracking numbers table. Default: marketship-table.

For example, you could use the following shortcode to output a table of tracking numbers for order 123:

[marketship_tracking_numbers order_id="123"]

Click here to purchase MarketShip!

Updated on July 28, 2019

Was this article helpful?

Related Articles