<HTML>
<HEAD>
<title> WebStore 400CS Shopping Cart - RDC Software - Database Item Price Shipping</title>
<META NAME="description" content="WebStore 400CS - a flexible, low cost, Perl shopping cart by RDC Software. Easy to install and customize. Online web store demonstrations and support documentation. Custom programming available.">
<META NAME="keywords" content="shopping cart,Shopping Cart,SHOPPING CART,perl webstore,Perl Webstore,WebStore,WEBSTORE,webstores,Webstores,WebStores,WEBSTORES,web-store,Web-store,Web-Store,WEB-STORE,web-stores,Web-stores,Web-Stores,WEB-STORES,storefront,Storefront,STOREFRONT,storefronts,Storefronts,STOREFRONTS,store-front,Store-Front,STORE-FRONT,store-fronts,Store-Fronts,STORE-FRONTS,on-line shop,On-line Shop,ON-LINE SHOP,online store,Online Store,ONLINE STORE,virtual mall,Virtual Mall,VIRTUAL MALL,internet commerce,Internet Commerce,e-commerce,E-Commerce,frontpage,MS Frontpage,nt,NT server">
<META NAME="copyright" content="
Copyright (c) 1996 - 2002, RDC Software, http://www.ratite.com
Copyright notifications:
Single User License:  /Docs/Copyright_SingleUser.html
Server License:       /Docs/Copyright_Server.html
File contents can not be altered.">
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" ALINK="#FF0000" VLINK="#0000A0">



<DL>
  <DT><TABLE BORDER=0 WIDTH="100%" CELLPADDING=0 CELLSPACING=0>
      <TR><TD><FONT SIZE=2>
      <A HREF="index.shipping.html">Previous</A> |
      <A HREF="shipping.Dbase_Weight.html">Next</A>
      </FONT></TD>

      <TD ALIGN=right><FONT SIZE=2>
      Main Index: &nbsp;
      <A HREF="index.html" TARGET="_top">Frames</A> |
      <A HREF="index.docs.html" TARGET="_top">No Frames</A>
      </FONT></TD></TR>

      <TR><TD COLSPAN=2 ALIGN=right><FONT SIZE=2>
      Document: &nbsp;
      <A HREF="frames/frame.shipping.Dbase_Price.html" TARGET="_top">Frames</A> |
      <A HREF="shipping.Dbase_Price.html" TARGET="_top">No Frames</A>
      </FONT></TD></TR>
      </TABLE>


  <DT>&nbsp;
  <DT><CENTER><H3><B><I>Database Item Price Shipping</I></B></H3></CENTER>
  <DT>&nbsp;


  <DT><I>Database Item Price Shipping</I> costs are based on item shipping prices
      stored in the shipping field in <I>WebStore's</I> product database, outlet.data.
  <DT>&nbsp;
  <DT><I><A HREF="outlet.setup.html#SHIPPING" TARGET="w1">%SHIPPING</A></I> is a hash of arrays in <I>WebStore's</I> setup file,
      /Web_store/Databases/<I><A HREF="../Databases/outlet.setup" TARGET="w1" onClick="window.open('','w1','width=640,height=480,scrollbars,resizable,top=0,left=0')">outlet.setup</A></I>.
      listing all shipping variables.
  <DT>&nbsp;
  <DT><A HREF="#SHIPPING">%SHIPPING</A> arrays in this file are configured for
      <NOBR><I>Database Item Price Shipping</I>.</NOBR>


<!-- Shipping -->
  <DT><PRE>Example:  $SHIPPING<FONT COLOR="#DC143C">{1}</FONT><FONT COLOR="#0000CD">[2]</FONT>

 <FONT COLOR="#DC143C">{1}</FONT>  An array's KEY value. KEY values will be referenced by their
      numeric value in the explanations below (0, 1, 2, etc.).

 <FONT COLOR="#0000CD">[2]</FONT>  An array's element reference. Element numeric values will
      be spelled in the explanations below (zero, one, two, etc.)

      Specific <FONT COLOR="#DC143C">arrays</FONT> will be referenced as $SHIPPING<FONT COLOR="#DC143C">{1}</FONT>.

      A specific <FONT COLOR="#0000CD">element</FONT> within a specific <FONT COLOR="#DC143C">array</FONT> will be referenced
      as $SHIPPING<FONT COLOR="#DC143C">{1}</FONT><FONT COLOR="#0000CD">[2]</FONT>.</PRE>

      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 <I>WebStore</I>.
  <DT>&nbsp;
  <DT>Numeric array KEYS allow the <I>Webstore</I> script to sort the shipping methods
      in ascending order for printing to the client's web browser.
  <DT>&nbsp;
  <DT>Arrays 0 and 3 - 9 are reserved and can not be used.
  <DT>&nbsp;

  <DT><A NAME="SHIPPING"></A><PRE><B>%SHIPPING = (

	<FONT COLOR="#008080"><A NAME="array_1"></A># Determines type of shipping
	# Database Field, Handling, Free Shipping</FONT>
	'<A HREF="#array1">1</A>' => ['2',   '',   ''],


	<FONT COLOR="#008080"><A NAME="array_2"># </A>Domestic Shipping</FONT>
	'<A HREF="#array2">2</A>' => ['319',  '10','11','12','13'],


	<FONT COLOR="#008080"><A NAME="array_10"># </A>Shipping Methods
	# 10  UPS Ground or Priority Mail:  Add  $0.00 to Shipping Subtotal
	# 11  2nd Day Air:                  Add $10.00 to Shipping Subtotal
	# 12  Standard Next Day Air:        Add $18.00 to Shipping Subtotal
	# 13  Alaska & Hawaii:              Add  $5.00 to Shipping Subtotal
	# 14  Canadian Orders:              $10.00 plus 17% of order's subtotal
	# 15  International Orders:         $20.00 plus  8% of order's subtotal</FONT>

	'<A HREF="#array10">10</A>' => ['UPS Ground or Priority Mail'],
	'11' => ['2nd Day Air',                 '10.00'],
	'12' => ['Standard Next Day Air',       '18.00'],
	<FONT COLOR="#008080"># State Specific Shipping Method</FONT>
	'13' => ['Alaska &amp; Hawaii',             '5.00',  '',    '<A HREF="#array13">11:21</A>'],
	<FONT COLOR="#008080"># Country Specific Shipping Method</FONT>
	'14' => ['Canadian Orders',             '10.00', '.17', '<A HREF="#array14">132</A>'],
	'15' => ['International Orders',        '20.00', '.08', ''],

); <FONT COLOR="#008080"># DO NOT REMOVE - terminates %SHIPPING</FONT></B></PRE>
  <DT>&nbsp;


  <!-- Array 1 - $SHIPPING{1} -->
  <DT><A NAME="array1"></A><PRE><B>Array 1 - <A HREF="#array_1">$SHIPPING{1}</A></B></PRE>
  <DT>$SHIPPING{1} must exist in <A HREF="#SHIPPING">%SHIPPING</A>.
      If $SHIPPING{1} is removed or the numeric value of it's KEY (1)
      is altered, shipping is disabled in <I>WebStore</I>.
  <DT>&nbsp;
  <DT>$SHIPPING{1} consists of the following elements:<PRE><B>
 <FONT COLOR="#008080">KEY     zero  one     two</FONT>
 '1' => ['2',  '3.50', '150.00'],</B></PRE>

  <DT><TABLE BORDER=0 WIDTH="100%" CELLPADDING=0 CELLSPACING=4>
      <TR><TD>zero</TD>
          <TD>&nbsp;&nbsp;</TD>
          <TD>Database Shipping Field</TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>Element zero is the item shipping price field in the store's
              database, outlet.data. Shipping is calculated using the dollar
              amounts (fixed decimal values) stored in the <I>Shipping</I> field.</TD></TR>

      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>The database <I>Shipping</I> field must be defined in element zero for
              <I>Database Item Price Shipping</I>.</TD></TR>
      <TR><TD COLSPAN=3>&nbsp;</TD></TR>


      <TR><TD>one</TD>
          <TD>&nbsp;&nbsp;</TD>
          <TD>Handling Charge</TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>Element one is the labor charge for packaging an order for shipment.</TD></TR>

      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>Setting element one = '' disables the addition of a handling charge.</TD></TR>

      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>Do not include a dollar sign or commas in element one.
              Element one is a fixed decimal number.</TD></TR>
      <TR><TD COLSPAN=3>&nbsp;</TD></TR>


      <TR><TD>two</TD>
          <TD>&nbsp;&nbsp;</TD>
          <TD>Free Shipping</TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>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.</TD></TR>

      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>Setting element two = '' disables free shipping checks, all orders
              pay shipping.</TD></TR>

      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>Do not include a dollar sign or commas in element two.
              Element two is a fixed decimal number.</TD></TR>
      </TABLE>


  <DT>&nbsp;
  <DT>&nbsp;
  <DT><CENTER><A HREF="#SHIPPING"><FONT SIZE=2>%SHIPPING</FONT><HR WIDTH="85%" NOSHADE SIZE=1></A></CENTER>
  <DT>&nbsp;


  <!-- Array 2 - $SHIPPING{2} - Domestic Shipping -->
  <DT><A NAME="array2"></A><PRE><B>Array 2 - <A HREF="#array_2">$SHIPPING{2}</A> - Domestic Shipping</B></PRE>
  <DT>$SHIPPING{2} must exist in <A HREF="#SHIPPING">%SHIPPING</A>.
      If $SHIPPING{2} is removed or the numeric value of it's KEY (2)
      is altered, shipping is disabled in <I>WebStore</I>.
  <DT>&nbsp;
  <DT>$SHIPPING{2} consists of the following elements:<PRE><B>
 <FONT COLOR="#008080">KEY     zero      one   two   three  four</FONT>
 '2' => ['319',    '10', '11', '12',  '13'],</B></PRE>

  <DT><TABLE BORDER=0 CELLPADDING=0 CELLSPACING=4>
      <TR><TD>zero</TD>
          <TD>&nbsp;&nbsp;</TD>
          <TD>Country Code</TD></TR>
      <TR><TD COLSPAN=2>&nbsp;</TD>
          <TD>Your 3 digit country code from %countries in
              <I><A HREF="../Databases/outlet.state_country.setup" TARGET="w1" onClick="window.open('','w1','width=640,height=480,scrollbars,resizable,top=0,left=0')">outlet.state_country.setup</A></I>.
              </TD></TR>
      <TR><TD COLSPAN=3>&nbsp;</TD></TR>


      <TR><TD COLSPAN=3>one, two, three, etc. &nbsp;&nbsp;&nbsp; Domestic Shipping Method KEYS</TD></TR>
      <TR><TD>&nbsp;</TD><TD>&nbsp;&nbsp;</TD>
          <TD>Elements one, two, three, etc. is a listing off all domestic
              (your country's) shipping method KEYS in %SHIPPING.</TD></TR>

      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>List as many domestic shipping methods as you require.</TD></TR>
      </TABLE>


      <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=4>
      <TR><TD COLSPAN=3>&nbsp;</TD></TR>
      <TR><TD COLSPAN=3 HEIGHT=3>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.</TD></TR>
      </TABLE>


  <DT>&nbsp;
  <DT>&nbsp;
  <DT><CENTER><A HREF="#SHIPPING"><FONT SIZE=2>%SHIPPING</FONT><HR WIDTH="85%" NOSHADE SIZE=1></A></CENTER>
  <DT>&nbsp;


  <!-- Arrays 10 - XX - Shipping Methods -->
  <DT><A NAME="array10"></A><PRE><B>Arrays 10 - XX <A HREF="#array_10">$SHIPPING{10}</A> - Shipping Methods</B></PRE>
  <DT>$SHIPPING{10} must exist in <A HREF="#SHIPPING">%SHIPPING</A>.
      If $SHIPPING{10} is removed or the numeric value of it's KEY (10)
      is altered, shipping is disabled in <I>WebStore</I>.
  <DT>&nbsp;
  <DT>$SHIPPING{10} is the first shipping method array.
  <DT>&nbsp;
  <DT>The default shipping method used by <I>WebStore</I> is defined in $SHIPPING{10}.
  <DT>&nbsp;
  <DT>$SHIPPING{10} remains the shipping method until the client selects an
      alternative shipping method.
  <DT>&nbsp;
  <DT>Each shipping method array (10, 11, 12, etc.) consists of a maximum of
      four elements:<PRE><B>
 <FONT COLOR="#008080">KEY     zero                           one  two  three</FONT>
'10' => ['UPS Ground or Priority Mail', '',  '',  ''],</B></PRE>

  <DT><TABLE BORDER=0 WIDTH="100%" CELLPADDING=0 CELLSPACING=4>
      <TR><TD>zero</TD>
          <TD>&nbsp;&nbsp;</TD>
          <TD>Shipping Label</TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>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.</TD></TR>
      <TR><TD COLSPAN=3>&nbsp;</TD></TR>


      <TR><TD>one</TD>
          <TD>&nbsp;&nbsp;</TD>
          <TD>Add Value</TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>Additional charges added to shipping costs (surcharge, etc.).</TD></TR>

      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>When a value exists in element one of the selected shipping method,
              element one's value is added to the shipping subtotal which was
              obtained by adding the database shipping field prices for items
              ordered by the client.</TD></TR>

      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>Do not include a dollar sign or commas in element one.
              Element one is a fixed decimal number.</TD></TR>
      <TR><TD COLSPAN=3>&nbsp;</TD></TR>


      <TR><TD>two</TD>
          <TD>&nbsp;&nbsp;</TD>
          <TD>Multiply Value</TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>The <I>Multiply Value</I> takes precedence over the shipping subtotal
              value and any value present in element one <NOBR>(<I>Add Value</I>)</NOBR> of the
              shipping method.</TD></TR>

      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>When a value exists in element two, the shipping subtotal is
              discarded. The order's subtotal is multiplied by the decimal value
              present in element two to obtain the order's shipping cost. If a
              value is present in element one, element one's value is added to the
              shipping cost product, producing the order's shipping subtotal.</TD></TR>

      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD>Do not include a dollar sign or commas in element two.
              Element two is a fixed decimal number.</TD></TR>
      <TR><TD COLSPAN=3>&nbsp;</TD></TR>


      <TR><TD>three</TD>
          <TD>&nbsp;&nbsp;</TD>
          <TD>Country or State(s) Specific Shipping Method</TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD><PRE>

<A NAME="array14">'</A>14' => ['Canadian Orders', '10.00', '.17', '<A HREF="#SHIPPING">132</A>'],</PRE>
              For country-specific shipping methods, list the country's 3 digit
              code from %countries in
              <I><A HREF="../Databases/outlet.state_country.setup" TARGET="w1" onClick="window.open('','w1','width=640,height=480,scrollbars,resizable,top=0,left=0')">outlet.state_country.setup</A></I>
              in element three. Only one country code may be listed in element three
              for a country-specific shipping method.</TD></TR>



      <!-- SPACER -->
      <TR><TD COLSPAN=3 HEIGHT=3></TD></TR>
      <TR><TD COLSPAN=2></TD>
          <TD><PRE>

<A NAME="array13">'</A>13' => ['Alaska &amp; Hawaii', '5.00', '', '<A HREF="#SHIPPING">11:21</A>'],</PRE>
              For state-specific shipping methods, list state 2 digit
              codes from %states in
              <I><A HREF="../Databases/outlet.state_country.setup" TARGET="w1" onClick="window.open('','w1','width=640,height=480,scrollbars,resizable,top=0,left=0')">outlet.state_country.setup</A></I>
              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.</TD></TR>
      </TABLE>


  <DT>&nbsp;
  <DT>&nbsp;
  <DT><CENTER><FONT SIZE=2><A HREF="#SHIPPING">%SHIPPING</A> | <A HREF="#top">Top of Page</A></FONT><HR WIDTH="85%" NOSHADE SIZE=1></CENTER>
  <DT>&nbsp;
  <DT>&nbsp;


<SCRIPT LANGUAGE="JavaScript" src="js.page_trailer.js"></SCRIPT>
</DL>


 

</BODY>
</HTML>
