24/7 Support: 800.608.6482

Get Started

Navigation


Advanced Shipping Manager

  1. Overview
  2. Setup & Configuration
  3. Product Level Settings
  4. Advanced Shipping Manager Back-end
  5. Importing & Exporting ASM Product Data

Overview

The Advanced Shipping Manager module (ASM) makes shipping rules easier to manage in your Miva store. It enables real-time shipping rates, hybrid shipping rates, and other complicated shipping rules via the Advanced Shipping Manager web service.

Setup & Configuration

Installation

  1. The Advanced Shipping Manager module can be downloaded from the Miva App Store here.
  2. Upload the module under Modules -> Add Modules.
  3. To make it live, the module needs to be installed on the store. Under Shipping Settings > Add/Remove Modules, choose install on the Advanced Shipping Module module.

Note: There are no Shipping Rules or Global Settings for this module in Miva. The only settings in Miva are at the Product level.

Configuration

After installing the module, there are two new tabs under Shipping Settings:

  • Advanced Shipping Manager Settings
  • Advanced Shipping Manager Methods

ASM Settings

  • Endpoint: The URL for the Advanced Shipping Manager web services page is automatically filled in.
  • Store ID: Your store ID is automatically filled in.

To test your connection to the ASM backend, click on the Test Connection button. A 'Connection Successful' dialog will pop up if your ASM connection is good.

ASM Methods

Before implementing ASM shipping methods on the Miva side, you have to configure the shipping methods in your ASM account. You can configure as many shipping methods as you require from the Shipping Rates tab in ASM (see ASM Shipping Rates). The shipping methods that you configure in ASM will appear on the Miva Advanced Shipping Manager Methods tab when customers select them during checkout.

Product Level Settings

Go to Catalog > Products > Edit Product: [Product Name] > Advanced Shipping Manager to set the shipping rules for ASM at the product level.

Module Options

Process As: This option allows you to control how product data gets sent to ASM. The default behavior is to treat it as a single product or variant. All other options apply to kits or multi-part variants. The available options are:

  • Single product or variant – Treat it as a single product or variant (default)
  • Kit sending master and part data – Include both the master product kit and all the parts in the kit
  • Kit sending only master data – Include only the master product (kit) data
  • Kit sending only part data – Include only the data for the parts that make up the kit

Product Variables

Dimensions: The three dimensions of the package in the order length, width, height. Each dimension should be separated by a space. Example: 20 10 4

Free Shipping Check this box to enable free shipping. There will be no charge for shipping if the customer selects the free-ship-method. For example, you could offer ground shipping for free and charge for air shipping.

Free Shipping Methods: There is a list of shipping methods in the Advanced Shipping Manager's backend. Enter the number of the shipping method that you want to use when an item has Free Shipping set to Yes.

Ship Alone Check this box if this item must be shipped alone (i.e. you cannot ship other items in the same package). Other items in the same order will be calculated in a separate package.

Flat Ship Rates: Each shipping method is defined on a separate line with a blank line between methods. The number before the equal sign is the method number. The number after the equal sign is the shipping rate. Methods that are not defined will continue to charge by the rule that matches the destination.

Example

1=15.00

2=19.99

3=25.50

Origin Zip: The origin zip code for the item. This zip code will be used to calculate the shipping cost of the item. If other items in the cart have a different origin zip code, the shipping cost for those items will be calculated in a separate package.

Number of Boxes: Specifies the number of packages that the item requires. If a large item requires more than one box to ship, all boxes will be calculated using the Ship Alone rule. Each package will include only one item.

Multi Box Weights: If the item has more than one box, enter the weight of each box here separated by spaces. Example: 50 40 55

Multi Box Dimensions: If the item has more than one box, enter the dimensions of each box here. Each box's dimensions goes on a separate line with a blank line in between each. The length/width/height dimensions for each box should be separated by spaces.

Example

20 20 50

25 30 50

25 35 50

Invalid Ship Methods: In some cases, certain shipping methods cannot be used with certain items. This variable allows you to specify the shipping methods excluded for this item. Enter the shipping method numbers (from the ASM backend) that are invalid for this item. Separate each shippping method number with a space. Example: 2 4 5

Markup: Markup or down shipping rates for a specific item. The value is a flat dollar amount. Example: 1.99

Global Free Ship Exclusion Check this box to exclude the item from a site-wide free shipping promotion. Regardless of how other items are handled, this item will always be charged for shipping, even when the threshold for free shipping has been reached.

Exclude States: Exclude this item from shipping to certain states. Separate each state abbreviation with a space. Example: AK HI NY

Exclude Countries: Exclude this item from shipping to certain countries. Separate each country abbreviation with a space. Example: AF RU TR

Optional Add-Ons

Item Points: ASM offers a point system to indicate box sizes as an alternative to setting dimensions. You can assign points to each product in your store to expedite shipping requirements. For example, five 10 point items can fit into a 50 point box. But a 60 point item or combination of items that add up to 60 points will require a larger box or multiple boxes. For information on ASM's box point system, see Box Size Point System.

Multiple Box Points: This field specifies the point value of each box when shipping in multiple boxes. Enter the point value for each box separated by spaces. For example: 700 650 1320. See Box Size Point System for an explanation of ASM's point system.

Bundled Quantity: ASM offers a bundling feature to set shipping rates for bundled items that are also sold individually. For example, wine glasses might be sold in packs of 12 or sold individually. The bundled rate would apply to the 12-pack. If a customer ordered 14 wine glasses, they would receive the bundled rate for 12 and the individual rate for 2. This field indicates the quantity threshold for bundled items. For more information on ASM's Bundled Item Shipping feature, see Bundled Item Shipping.

Bundled Weight: This field indicates the weight value used when the Bundled Quantity threshold is reached.

Bundled Dimensions: This field indicates the dimensions used when the Bundled Quantity threshold is reached. The dimensions length, width and height should be entered with a space between each. Example: 10 22 30

Bundled Points: This field indicates the point value used when the Bundled Quantity threshold is reached.

Process Time: This field indicates the processing time between when an order is placed and when it is shipped. It can be a flat number or a range (e.g. 4, 3-5).

Hazmat Check this box if the item includes hazardous materials. An additional shipping fee can be added to the shipping rule for hazmat items.

Optional Weight Points: This field allows you to add weight, dimensions or points (if enabled) to product variants. For example, if a product is available in different sizes (small, medium, large) with different weights or dimensions, the Optional Weight Points feature automatically calculates the difference in shipping rates. For more information on this ASM option, see Weights or Points for Items Option.

Custom Data

These variables are reserved for advanced customization. Contact ASM for more information.

Advanced Shipping Manager Back-end

Before you use ASM shipping methods in the Miva admin, you must first create shipping rules on the ASM side. You can also set markup rates and get shipping cost estimates here. For detailed information on these settings, refer to your ASM documentation.

ASM Summary Page

ASM Shipping Rates Page

ASM Markups Page

Importing & Exporting ASM Product Data

The custom fields that the ASM module adds as product variables can be imported and exported via Data Management.

Export Data

From Data Management > Import/Export > Export Products To Flat File, select all the custom fields that begin with "ASM".

Click Export. The resultant .CSV file will contain the ASM fields in the following table. The first column shows the export fields (the column headers in the CSV file). The second column shows the corresponding field names from the Advanced Shipping Manager tab on the Edit Product page. The third column shows the section on the Edit Product page where the field can be found.

Export Product Fields Product Custom Fields Product Page Section
ASM_BUNDLED_DIMENSIONS Bundled Dimensions Optional Add-Ons
ASM_BUNDLED_POINTS Bundled Points Optional Add-Ons
ASM_BUNDLED_QUANTITY Bundled Quantity Optional Add-Ons
ASM_BUNDLED_WEIGHT Bundled Weight Optional Add-Ons
ASM_CUSTOM1 Custom 1 Custom Data
ASM_CUSTOM2 Custom 2 Custom Data
ASM_CUSTOM3 Custom 3 Custom Data
ASM_CUSTOM4 Custom 4 Custom Data
ASM_CUSTOM5 Custom 5 Custom Data
ASM_DIMENSIONS Dimensions Product Variables
ASM_EXCLUDE_COUNTRIES Exclude Countries Product Variables
ASM_EXCLUDE_STATES Exclude States Product Variables
ASM_FLAT_SHIP_RATES Flat Ship Rates Prodcut Variables
ASM_FREE_SHIPPING Free Shipping Product Variables
ASM_FREE_SHIPPING_METHODS Free Shipping Methods Product Variables
ASM_GLOBAL_FREE_SHIP_EXCLUSION Global Free Ship Exclusion Product Variables
ASM_HAZMAT Hazmat Optional Add-Ons
ASM_INVALID_SHIP_METHODS Invalid Ship Methods Optional Add-Ons
ASM_ITEM_POINTS Item Points Optional Add-Ons
ASM_MARKUP Markup Product Variables
ASM_MULTI_BOX_DIMENSIONS Multi Box Dimensions Product Variables
ASM_MULTI_BOX_WEIGHTS Multi Box Weights Product Variables
ASM_MULTIPLE_BOX_POINTS Multiple Box Points Optional Add-Ons
ASM_NUMBER_OF_BOXES Number of Boxes Product Variables
ASM_OPTIONS_WEIGHT_POINTS Option Weight Points Optional Add-Ons
ASM_ORIGIN_ZIP Origin Zip Product Variables
ASM_PROCESS_AS Process As Module Options
ASM_PROCESS_TIME Process Time Optional Add-Ons
ASM_SHIP_ALONE Ship Alone Product Variables

Import Data

A quick way to populate the ASM fields for a lot of products at once is to first export, then fill in the data in the CSV file and import it back into your store.

Go to Data Management > Import/Export > Add/Update Products from CSV to import the new product settings. The updates to ASM settings can be seen in Products > Edit Product: [Product Name] > Advanced Shipping Manager.

This website uses cookies to identify visitors, track visitors to our website, store login session information and to remember your user preferences. By continuing to use this site you agree to our use of cookies. Learn More.

This website uses cookies. By continuing to use this site you agree to our use of cookies. Learn More.

Accept

Copyright © 1997 – 2019 Miva©, Miva Merchant©, MivaPay©, MivaCon© Miva, Inc. All Rights Reserved.