You can host multiple catalogs on your site. What I like most about this feature
is the "Business Partner" web site setup.
You can be the business that hosts all the products and services for your friends, family,
and business partners without any additional costs.
To configure a single or multiple cart setup,
please make the following entry in your web.config file under the configuration section.
The web.config file is located in the root of your web site. This references the catalogs.config file where all the configuration data is located.
AppSettings in web.config file
In the catalogs.config file, enter in one or more shopping cart configurations.
Each configuration will create a new row in the SampleCatalog.aspx file.
You can enter in as many carts as you can maintain. Remember that each cart has only one associated
XML price file.
Catalogs.Config File
Catalogs.Config File Breakdown
Whatever suffix you decide to use in the key names for each shopping cart, make sure they are consistent. The shopping cart
software uses this suffix to group the configuration items together.
xmlpricefile
This is the XML Price File or Catalog file that runs the shopping cart.
maincart
This configuration entry identifies the default cart to use when multiple carts are configured. This allows the cart to
find products in the main cart from external links to the catalog.
How to link to a product in the main cart when the cartid = 5:
Name of Product
Name of Product
How to link to a product NOT in the main cart when the cartid = 7. The cpf value must match
the key name for the shopping cart:
Name of Product
Name of Product
catalogimages
This configuration entry identifies the location of the product images.
catalogname
This is the name of the catalog that appears on the SampleCatalogs.aspx web page.
catalogimagedisplay
This configuration entry identifies the image representing the catalog on the SampleCatalogs.aspx web page
catalogdesc
This configuration entry identifies the catalog description on the SampleCatalogs.aspx web page
maxrelatedproducts
This configuration entry identifies the maximum number of related products that can be listed
for any given product
website
This configuration entry identifies the web page to return to after the customer has purchased your products
on the PayPal site.
showmappricing
This configuration entry identifies whether or not MAP pricing is used on your site. Review the Price File for a detailed
explanation of MAP pricing.
paypalemail
This configuration entry identifies the email address associated with the PayPal business account that receives payments.
correspondence_email
This configuration entry identifies the email address associated with the intergrated payment solution. Orders are sent to this
email address after a customer purchase. It is also used in the 'reply to' for the order confirmation to the customer.
pricemarkup
This configuration entry identifies the percentage markup on each product item. .20 means 20% markup.
gallerviewitemsacross
This configuration entry identifies the number of products in a single row when products results are displayed in
gallery view.
itemsperpage
This configuration entry identifies the number of products listed on each page for a given search result.
listviewimagewidth
This configuration entry identifies the width of product images that appear in the search results page.
galleryviewimageheight
This configuration entry identifies the height of product images that appear in the gallery view search results.
environment
This configuration entry allows you to configure your cart for integrate payment solutions in test mode.
Internet Sales Tax
taxrate
This is the sales tax you will collect for your shopping cart. It is a percentage of the cart subtotal. You are required to collect
sales taxes on items shipped to destinations in the same state as the
commercial location of your business. .0725 means a 7.25% sales tax rate.
Please refer to this article, Collecting Sales Tax Over The Internet,
for a more in-depth explanation about collecting internet sales
taxes.
There are 3 options for setting the appropriate sales tax:
- 0 - Use this value to indicated all sales tax calculations will be performed on the PayPal site. PayPal has an option to
build a sales tax rate table by state and territory. If you are a non-profit, set this value to 0.
- .0725 - example of a sales tax rate of 7.25%. This is a global setting. All sales will be taxed.
- useratetable - Use this setting when you want to handle the sales tax on your site.
Use the enclosed file: InternetSalesTaxRateTable.txt to set the rate by state. In this file, remove all states that do not apply.
If you use this option, you must also set the 'shipping_integrated' option to 'yes'
//uses customized PayPal Sales Tax Rate Tables
//Global sales tax for all purchases. Not recommended but possible
//uses a text file with sales tax rates by state. Use in cases where multiple states are involved
Shipping
You have 3 options for shipping:
- Fixed ship cost per sale. Approx cost estimate.
- Percent ship cost per sale. Guarantees a percentage coverage of cost but still an estimate
- Integrated shipping with USPS, UPS, Fedex.
Listed below are the configuration settings to apply a ship method to your shopping cart
fixedshipcost
A single fixed shipping cost per cart subtotal
Cart Subtotal + Fixed Shipping Cost = Cart Total
// Set to 0 if you are NOT using a fixed shipping charge approach
percentshipcost
Cart subtotal is multiplied by the percent to obtain shipping cost
Cart subtotal + (Cart subtotal x percent) = Cart Total
// Set to 0 if you are NOT using a percentage based shipping charge approach
shipping_integrated
This configuration entry indicates that your shopping cart solution will integrate with shipping rate calculators onsite. We currently
support USPS, Fedex, and UPS as shipping options for hosted accounts only or if you host your product catalog on Discountasp.net. If you have your own site, you will need to purchase the third-party
shipping software for your site. We use nSoftware as our shipping integration software. By setting this option to 'yes', you must also
set one of the 3 shippers to 'yes' as indicated below. In addition, each carrier requires you to set up accounts for billing purposes. You can find the account registration
links on the Account Setup Links page. Please review our Shipping Options page for detailed information on shipping options.
Typical carrier settings
These configuration entries are required for the carriers if the 'shipping_integrated' value is set to 'yes'.