Copyright © 2001, William Weiland
Charge fees within an order for such things as special packaging, artistic setup, or any miscellaneous charge that needs to be applied and is not an actual product. Multiple fees allowed per store and per product; assigned through admin.
If this is an upgrade, see the note at the bottom of the master install document index
1) In admin, click Add Modules link (fig 2)
2) Click the file upload button
3) Browse to find the miscfee.mvc file on your hard drive and upload (fig 3)
4) Click Add to add it to the domain
5) Then in admin click on the plus to the left of Stores
6) Click the plus to the left of your store name
7) Click on the word Utilities under your store (fig 4)
8) Check the box next to Miscellaneous Fee
9) Click Update
10) Click on System Extension Configuration link (fig 5)
11) Check the box next to Miscellaneous Fee
12) Click Update
This section applies if you are upgrading from Merchant 4.x to 5.x. In your Merchant 4.x you need to be running the most current version of miscellaneous fees as it includes an export feature so that you can create a flat file of your products' miscellaneous fees.
1) Export the Merchant 4.x miscellaneous fees to a flat file from the module's admin screen
2) Use the 5.x import module (miscimpt.mvc) to import those miscellaneous fees into your Merchant 5.x store
In the Utility Configuration screen you will establish your store's fees. Most inputs are self explanatory.
* The ship to location options should be left blank unless they are specifically needed
* You can include specific locations by starting the line with a +
* You can exclude specific locations by starting the line with a -
* Use the location code for states and countries, e.g. FL and US respectively
* You can enter a string of codes up to 254 characters, each code separated with a | and the line ending with a |
* Example: +US|CA|MX| will apply the fee for United States, Canada, and Mexico only
* Example: -FL|GA|MS|AL| will NOT apply the fee for Florida, Georgia, Mississippi, and Alabama but will apply it for all other locations unless excluded or included in the other location options
* You can combine location options, e.g. just US but not the states FL and GA
In each Product Editing Screen you can select the Miscellaneous Fee tab. When you select the tab, all possible fees in your store (as were entered in the Utility Configuration) will appear. You can assign one or more fees to the individual product.
You can import the fees and their related products from a flat file using the optional miscimpt.mvc module. The format is very specific.
1) The Fee section begins with #Fees. Then each line below that contains values for the fee's fields, each separated with a ^ character delimiter. The fields are:
id - number required but not used (any number will do)
label - fee name
type - 1 = all orders, 2 = once per applicable order, 3 = each applicable product
charge - amount of fee
taxes - taxable 1 = yes, 0 = no
state - state codes (see module's admin screen for format)
zip - zip codes (see module's admin screen for format)
country - country codes (see module's admin screen for format)
range - use ranges (1 = yes, 0 = no
low - low range
high - high range
attr - attribute restriction (see module's admin screen for format)
2) The Product section begins with #Products and contains the product code and fee label, separated with the ^ character.
Example flat file:
#Fees
1^Framing^3^20.00^1^^^^0^0.00^0.00^
2^Fragile Packaging^2^10.00^0^+FL^-33468^+US^0^0.00^0.00^
3^Hazardous Materials Handling^3^95.00^0^^^^0^0.00^0.00^
6^Online Docs^2^0.00^0^^^^0^0.00^0.00^
8^Special Discount^1^-10.00^1^^^^1^300.00^999999.00^
#Products
1AA00083^Online Docs
1AA00900^Online Docs
Leave the last line blank.
Q: I have a fee called "Handling". It is applied correctly in the basket until I click continue on the shipping/payment selection page. Then it disappears and the charge is removed. What is happening?
A: Miva created a built in module for shipping rules and handling fees. When you go from the shipping/payment selection page to the payment page, the built in module erases any charges called "Handling". The bug has been reported. But until Miva fixes it, you will need to change a miscellaneous fee called "Handling" to something else, e.g. Handling Charge.
Q: I tried to use the module for adding a fee to any order with a subtotal of less than $25, but it is not working. I configured one fee, for All Orders, Charge 3.50, Country +NL, Use subtotal range 0-25 and the box is checked. It is not assigned to any specific product. Fee does not appear on the last checkout screen.
A: The location codes require a | between each code and an additional | at the end of the line. Also, be sure you are using either the + or - at the beginning of the line of codes to designate whether they are include or exclude.
