Previous | Next Main Index:   Frames | No Frames
Document:   Frames | No Frames
 

Fixed Rate and Percentage Shipping

 
Fixed Rate and Percentage Shipping costs are based on the order's subtotal.
 
%SHIPPING is a hash of arrays in WebStore's setup file, /Web_store/Databases/outlet.setup. listing all shipping variables.
 
%SHIPPING arrays in this file are configured for Fixed Rate and Percentage Shipping.
Example:  $SHIPPING{1}[2]

 {1}  An array's KEY value. KEY values will be referenced by their
      numeric value in the explanations below (0, 1, 2, etc.).

 [2]  An array's element reference. Element numeric values will
      be spelled in the explanations below (zero, one, two, etc.)

      Specific arrays will be referenced as $SHIPPING{1}.

      A specific element within a specific array will be referenced
      as $SHIPPING{1}[2].
Arrays 1, 2, and 10 must exist in %SHIPPING. If any of these arrays are not present in %SHIPPING or the value of their KEY (1, 2, 10) is altered, shipping is disabled in WebStore.
 
Numeric array KEYS allow the Webstore script to sort the shipping methods in ascending order for printing to the client's web browser.
 
Arrays 0 and 3 - 9 are reserved and can not be used.
 
%SHIPPING = (

	# Determines type of shipping
	# Database Field, Handling Charge, Free Shipping, Fixed Shipping
	'1' => ['',    '',   '',   '125.00'],


	# Domestic Shipping
	'2' => ['319',  '10','11','12'],


	# Shipping Methods
	#                                  Fixed Rate   Percentage
	'10' => ['USA - Regular',          '9.95',      '.09'],
	'11' => ['USA - Overnight',        '24.95',     '.20'],
	# State Specific Shipping Method
	'12' => ['USA - Alaska & Hawaii',  '13.95',     '.14',  '11:21'],
	# Country Specific Shipping Method
	'13' => ['Canada',                 '14.95',     '.15',  '132'],
	'14' => ['International',          '24.95',     '.20'],

); # DO NOT REMOVE - terminates %SHIPPING
 
Array 1 - $SHIPPING{1}
$SHIPPING{1} must exist in %SHIPPING. If $SHIPPING{1} is removed or the numeric value of it's KEY (1) is altered, shipping is disabled in WebStore.
 
$SHIPPING{1} consists of the following elements:

 KEY     zero  one     two       three
 '1' => ['',   '3.50', '150.00', '125.00'],
zero    Database Shipping Field
Element zero is not used for Fixed Rate and Percentage Shipping and must be set to ''.
 
one    Handling Charge
Element one is the labor charge for packaging an order for shipment.
Setting element one = '' disables the addition of a handling charge.
Do not include a dollar sign or commas in element one. Element one is a fixed decimal number.
 
two    Free Shipping
When the value of an order's subtotal is greater than the value listed in element two, no shipping or handling is charged for the order. The shipping drop down select element is not printed to the client's web browser.
Setting element two = '' disables free shipping checks, all orders pay shipping.
Do not include a dollar sign or commas in element two. Element two is a fixed decimal number.
 
three    Fixed Shipping Value
When an order's subtotal is equal to or less than the dollar value listed in element three, shipping is equal to the dollar value listed in element one (fixed rate) of the client-selected shipping method.
When an order's subtotal is greater than the dollar value listed in element three, calculate shipping by multiplying the order's subtotal by the decimal point value (percentage) listed in element two of the client-selected shipping method.
Setting element three = '' enables percentage shipping calculations for all orders regardless of the order's subtotal.
Do not include a dollar sign or commas in element three. Element three is a fixed decimal number.
 
 
%SHIPPING
 
Array 2 - $SHIPPING{2} - Domestic Shipping
$SHIPPING{2} must exist in %SHIPPING. If $SHIPPING{2} is removed or the numeric value of it's KEY (2) is altered, shipping is disabled in WebStore.
 
$SHIPPING{2} consists of the following elements:

 KEY     zero    one   two   three four
 '2' => ['319',  '10', '11', '12'],
zero    Country Code
  Your 3 digit country code from %countries in outlet.state_country.setup.
 
one, two, three, etc.     Domestic Shipping Method KEYS
    Elements one, two, three, etc. is a listing off all domestic (your country's) shipping method KEYS in %SHIPPING.
List as many domestic shipping methods as you require.
 
Your 3 digit country code in element zero and the domestic shipping methods listed in elements one, two, three, etc. are used to determine if the client has chosen a shipping method which applies to their country of residence.
 
 
%SHIPPING
 
Arrays 10 - XX $SHIPPING{10} - Shipping Methods
$SHIPPING{10} must exist in %SHIPPING. If $SHIPPING{10} is removed or the numeric value of it's KEY (10) is altered, shipping is disabled in WebStore.
 
$SHIPPING{10} is the first shipping method array.
 
The default shipping method used by WebStore is defined in $SHIPPING{10}.
 
$SHIPPING{10} remains the shipping method until the client selects an alternative shipping method.
 
Each shipping method array (10, 11, 12, etc.) consists of a maximum of four elements.
 
$SHIPPING{10} consists of the following elements:

 KEY      zero             one     two    three
 '10' => ['USA - Regular', '9.95', '.09', ''],
zero    Shipping Label
The shipping label used in the shipping drop down select element on the order form HTML page, confirmation of order HTML page, and e-mail messages.
 
one    Fixed Shipping Value
When an order's subtotal is less than or equal to the value of $SHIPPING{1}[3], fixed shipping value above, shipping is equal to the dollar value listed in element one.
Do not include dollar signs or commas in element one. Element one is a fixed decimal number.
 
two    Percentage Shipping Value
When an order's subtotal is greater than the value of $SHIPPING{1}[3], fixed shipping value above, calculate shipping by multiplying the order's subtotal by the decimal point value (percentage) listed in element two.
Do not include a dollar sign or commas in element two. Element two is a fixed decimal number.
 
three    Country or State(s) Specific Shipping Method

'13' => ['Canadia', '14.95', '.15', '132'],
For country-specific shipping methods, list the country's 3 digit code from %countries in outlet.state_country.setup in element three. Only one country code may be listed in element three for a country-specific shipping method.

'12' => ['Alaska & Hawaii', '13.95', '.14', '11:21'],
For state-specific shipping methods, list state 2 digit codes from %states in outlet.state_country.setup in element three. More than one state code may be listed in element three for a state-specific shipping method. Colon delimit multiple state codes.
 
%SHIPPING | Top of Page