uShop Shipping Setup
Admittedly, the shipping parameter is one of the more difficult
parameters to setup in the uShopOrder applets. However, once you understand the
format of the parameter, you will be able to setup almost any type of
Shipping Method/Calculation.
Shipping Name
The shipping name can be anything you want to call the shipping method. For example,
you can name the shipping method "UPS", "FED EX", or whatever you want to call it.
Calculation Method
The calculation method can be one of four values:
- "FLAT RATE" - If you want to specify a flat rate to charge for shipping.
- "BY_SUBTOTAL" - If you want to calculate shipping based on the product subtotal.
- "BY_QUANTITY" - If you want to calculate shipping based on the total quantity of items.
- "BY_WEIGHT" - If you want to calculate shipping based on the product weight. (If
you use "BY_WEIGHT" you should be sure to specify the "WEIGHT"
parameter in all of your product input applets.)
Shipping Table
The shipping table is a list of value=rate pairs separated by commas and can best
be described in an example.
Suppose you want to calculate shipping base on the subtotal and the shipping table is
specified as:
"10=FIM1.00,20=FIM2.00,30=FIM3.00,FIM4.00"
This table would be interpreted as: for orders with subtotals between FIM0.00 and FIM10.00, shipping
is FIM1.00, for orders with subtotals between FIM10.00 and FIM20.00, shipping is FIM2.00, for orders with
subtotals between FIM20.00 and FIM30.00, shipping is FIM3.00, and for all subtotals greater than FIM30.00,
shipping is FIM4.00.
If you were to use the same shipping table to calculate shipping based on weight, the table
would be interpreted as: for orders with weight totaling between 0 and 10, shipping is FIM1.00,
for orders with weight totaling between 10 and 20, shipping is FIM2.00, for orders with weight
totaling between 20 and 30, shipping is FIM3.00, and for all orders with weight totaling more
than 30, shipping is FIM4.00.
PUTTING IT ALL TOGETHER
The shipping parameter is made by putting the Shipping Name, Calculation Method, and Shipping
Table together in one comma separated string. As an example:
<PARAM NAME=shipping VALUE="UPS,BY_SUBTOTAL,20=FIM5.00,35=FIM7.00,50=FIM10.00,FIM15.00">
This shipping parameter would be interpreted as: Call this shipping method "UPS", Calculate the
shipping based on "SUBTOTAL", and for subtotals up to FIM20 charge FIM5.00 shipping, for subtotals up
to FIM35 charge FIM7.00 shipping, for subtotals up to FIM50 charge FIM10.00 shipping, and for subtotals
greater than FIM50 charge FIM15.00 shipping.
SPECIFYING MULTIPLE SHIPPING OPTIONS
You can specify multiple shipping methods/calculations by just separating each one with a semicolon
(;).
<PARAM NAME=shipping VALUE="UPS,BY_SUBTOTAL,20=FIM5.00,35=FIM7.00,50=FIM10.00,FIM15.00;
FED EX,BY_WEIGHT,10=FIM5.00,20=FIM10.00,FIM25.00;
US Air Mail,BY_QUANTITY,3=FIM3.00,6=FIM5.00,FIM7.50;
Over Night,FLAT_RATE,FIM20.00">
NOTE: DO NOT include a semicolon after the last shipping option.
