Advanced Interfaces

Multiple Item Purchases

If you want to allow your customers to purchase more than one item at a time, you can do it by setting up a form on your site with items. Each item must have the following information: Desc, Price, Taxable. If you're using EZ Ship you need to add: weight. If you're using UPS for your shipping, you need to add Package. If the packaging is your own packaging, you need to add: Length, Width, Height. You can also add InsuredValue if you're using UPS shipping.

Click here for the details of Multiple Item Purchases

Adding Options to your Items

Frequently, people want to add options like color, size, and etc. to their selections. This is relatively easy to do. The only challenge is if it affects the SKU that results from the options selected. For example, if a black item SKU is b123 and a red item SKU is r123 you'll have more programming to do to make that happen.

Essentially, each item is set up as a form within your web page. So, if you have ten items on the page you'll have ten forms with the appropriate information in each form.

Click here for the details of Options

Multiple Item Purchase Details

Here's sample input elements - 

Required For All:
<input name="Desc1" type="hidden" value="Deluxe Sattelite tuner">
<input name="Price1" type="hidden" value="249.95">
<input name="taxable1" type="hidden" value="Yes">
Notice that each element has the number 1 after it. Every item, and it's associated information must have a number after each element 1, 2, 3, ...20. That's how eCOMpal figures out what each element is.

Optional for all:
Quantity<input type="text" name="Quan1" size="5"> - This can be a user input field
<input name="sku1" type="hidden" value="dst123"> - SKU is for your fulfillment house or updating QuickBooks.
<input name="schedule1" type="hidden" value="A"> - for a discount schedule

Required for all shipping:
<input name="weight1" type="hidden" value="25">

Required for UPS Shipping:
<input name="package1" type="hidden" value="02">

Required for UPS if packaging is your own:
<input name="length1" type="hidden" value="20">
<input name="height1" type="hidden" value="30">
<input name="width1" type="hidden" value="15">

Optional for UPS:
<input name="insuredvalue1" type="hidden" value=<250">

Here's a sample page with multiple item order capability. Take a look at the source to see how this uses the elements discussed above. You can use it as a model for your pages.

Adding Options to your items Detail

It's all based on a fairly simple piece of Javascript that you add to the header of your web page.

function showData(formid)
{
var addr="http://ww2.asafeweb.com/order.asp?userid=1002&continue=http://www.mysite.com"
for (var i=0; i < document.forms.length; i++)
{
if (document.forms[i].name=='form'+formid)
{
addr=addr+document.forms[i].LinkAddr.value;
if (document.forms[i].Option1!=null)
{
addr=addr+"&option1="+document.forms[i].Option1.value;
}
if (document.forms[i].Option2!=null)
{
addr=addr+"&option2="+document.forms[i].Option2.value;
}
if (document.forms[i].Quantity!=null)
{
addr=addr+"&quan="+document.forms[i].Quantity.value;
}
}
}
// NOTE - if you want to see the results without going to the shopping cart,
// just remove the // in the next line and add // to the beginning of the next line.
// Just REMEMBER to switch it back when you want to run for real!
// alert("addr="+addr);
window.location.href=addr;
}
</script>

Note: Change the www.mysite.com to your web address and the UserId=1002 to your user id. It wont work if you don't!!!

The field LinkAddr must be a hidden field in each of your forms. It contains all the information about the item being ordered: Desc, Price, Taxable, Weight, Schedule, SKU, Package, Length, Width, Height.

Don't forget that you must NOT use spaces between words in your descriptions. Use a Plus Sign(+) instead. For example - The+best+item+in+the+world. 

The spelling and capitalization of the form items like Option1, Quantity, etc. must be the same in your form and in the Javascipt. If it's not, it won't work! Javascript is very fussy.

Here's a sample page with options that illustrates how it's done. You can use it as a model for your pages.