Difference between revisions of "Ecommerce Cart"

Revision as of 19:32, 22 October 2015

The ecommerce cart creates an online catalog and order process that integrates with the Invoice Manager. See the Invoice Manager documentation for most terms, roles and settings.

Terms

Catalog 

The list of items which may be purchased online

Order Process 

The series of steps taken to purchase the items selected.

People Record 

A record in the system that identifies one person. Each person can have three addresses -- primary address, billing address, and shipping address

Order 

(aka invoice, receipt) The document that represents a charge to the account. it is an order before it is charged (billed), an invoice when it is charged but not paid, and a receipt when it is paid.

Roles

Customer 

The people record of the individual using the ecommerce cart.

Account 

The entity charged for the order. If the customer has an account set in their Billing tab, that account is charged. if they do not, a new account is created, set in their Billing tab, charged, and the customer is set as the primary contract and billing contact.

Account Primary Contact 

The people record of the individual to be the primary contact for an account. See ecommerce for more details.

Account Billing Contact 

The people record of the individual to be the billing contact for an account. Account notifications are sent to the billing contact. See ecommerce for more details.

Settings

Use Ecommerce Settings, installed with the Invoice Manager to handle most online purchase settings.

Catalog

1. Catalog Listing Columns: This is the number of columns displayed when many items are listed out, such as search results and when an entire category is selected.
2. Catalog Listing Items: This is the number of items displayed per page.
3. Catalog Item Sort Order: How items are sorted on the catalog; options include: By Alpha Sort Order Field, By Alpha Sort Order Then Oldest First, By Date, By Date Reverse and By Name
4. Allow Prices in Catalog: When checked, pricing is displayed with an item in the catalog. Pricing is required to allow ordering.
5. "Retail Price" Caption: This is for comparison only. Leave blank if you do not need this.
6. "Regular Price" Caption: This is the normal price for the item when the buyer is not eligible for a sale or group discount.
7. Allow Custom Prices: When checked, items with a 'custom price' will display the custom pricing.
8. "Custom Price" Caption: When Allow custom prices is checked, this caption is used to identify the custom price.
9. "Sale Price" Caption: When an item includes a sale price, and is marked on sale, this is the caption that displays with the sale price.
10. "Your Price" Caption: The lowest possible price is calculated for each item, based on regular price, sales price and any Group Discounts. This caption is used to display that price.
11. "Manufactured By Caption: When included, this caption precedes the name of the source of this item, as selected for each item.
12. Catalog Thumbnail Width: This is the width of all thumbnail images displayed in the catalog.
13. Catalog Image Width: This is the width of all images that are not thumbnails displayed in the catalog.
14. Catalog Text: Provides a place to edit copy content in the catalog home, search tab, account tab, order list, account select list and add account tab.

Checkout

Checkout settings control the process of purchasing the items in a cart. If you will be using PayPal or an online credit card processor, see the settings below. Configure your online payment processor with Payment Process Settings.

1. Email from-address for order receipt: This is the email address the appears as the 'From Address' on receipts sent to customers.
2. Price Level Free Shipping: When allowed, orders over the Free Shipping Price Level will be given free shipping. The total price is before tax and shipping calculations, but includes all other discounts. Free shipping applies only to those shipping methods with 'Free Shipping at a Price Level' checked.

Accepting PayPal Payments

With PayPal Express checkout, your visitors will see a PalPal link that takes them to the PayPal site to process charges. After the purchase is complete, they return to your site. To use PayPal, you must create a PayPal account on the PayPal site and update these fields.

1. Allow Payment by PayPal: Check this box if you want to use PayPal Express checkout.
2. PayPal Business Name: When you create your PayPal seller account, this is the username they assign to you.
3. PayPal Post URL: The PayPal Post URL below should be one of the following:
   1. for testing - https://www.sandbox.paypal.com/cgi-bin/webscr
   2. for production - https://www.paypal.com/cgi-bin/webscr

Shipping

Shipping options are configured through the ecommerce settings page.

Group Policies

Use Group Policies to apply special discounts and privileges available to only those people in specific groups. There are two kinds of Group Discounts, Custom Price Discount and Percentage Discount. When Allow Custom Price is checked, members of that group will be eligible for the 'custom price' in any item. When a non-zero Percentage Discount is entered below, anyone in that group receives that discount off of the 'Regular Price'. This discount does not apply to 'Sales Price' or 'Custom Price'. The final price for each item, labeled with the caption 'Your Price', will be the lowest of the calculated price for each pricing strategy.

1. Block Contact Update Group: If a group is selected, anyone logged in and in this group will not be able to update their contact information. Use this setting to protect user settings that may be controlled by another source such as a synchonization from another database.
2. All groups in the system are listed here with the option to enter a % discount, to check the "Allow Custom Price" option and to check the "Allow Ordering" option (which applies to items with Order Button Mode set to Group Policy).

Sales Tax

Sales tax will be automatically included on the order based on the state of the shipping address. Individual state sales tax rates are set in the record for the state. The checkout process calculates the tax required but it is up to you to handle all state tax filings. You have the option to edit state tax rates here.

Inventory Management

Use Inventory Management to notify you when an items quantity is low. For each item, enter the Inventory on hand, and Inventory low. Each time an item is purchased, the quantity on hand is decreased. When the quantity is below the Inventory Low number, a notification is sent by email.

1. Allow Inventory Management: Enables this feature on the website.
2. Inventory Notification Email: Enter the email address for the person who should be notified of items with a low quantity on hand.

Purchase Process

The series of steps taken to purchase an order online.

Step 1: Catalog Shopping

The customer can add items to their shopping cart using the order button for each item. They can add items on the catalog, but remove and modify their cart in the Order Review.

The customer does does not need to be logged in, although if items have discounts available, they will not show until the customer authenticates.

Step 2: Order Review

The customer can modify the items in their order. No tax or shipping information is available.

Step 3: Authentication

If the customer already has a user identity on the website, they can log-in. If you do not, they have to create a user identity by entering email, username, password, first name and last name.

There are a few restrictions when creating a user identity

• The email address must be valid, and unique in the system
• The username must be unique in the system and meet the website's security settings

If the user has already created an order, creating a user identity will update with this contact information.

If the customer logs into a current user identity, and that user already has an order started, the two orders will be merged.

Step 4: Contact and Shipping

Step 5: Purchase

Step 6: Receipt

Template Design and Implementation

Managing design is accomplished with a layout records. One layout record includes all the html required for the catalog, and another includes all the html required for the order process.

Catalog Layout

The catalog requires two layouts

• CatalogList
• CatalogDetails

The system populates the layouts by identifying elements based on class names. For example, to create a region that populates with the itemName, add this to your layout:

<span class="itemName"></span>

This is a list of possible item values that can be included:

<span class="itemThumbnail"></span>
<span class="itemImage"></span>
<span class="itemName"></span>
<span class="itemOverview"></span>
<span class="itemAvailability"></span>
<span class="itemCategory"></span>
<span class="itemMoreInfoLink"></span>
<span class="itemYourPrice"></span>
<span class="itemOptions"></span>
<span class="itemOrderButton"></span>
<span class="item"></span>

To conditionally include markup that will be removed if a field is not available, add the suffix 'Block' to the class name. For example, if an item has no name, this markup would remove the caption:

<span class="itemNameBlock">Name: <span class="itemName"></span></span>

The screens and required elements are listed here:

• catalogList - This screen lists the appropriate items and the item categories. Each item in the item is wrapped in an element with class repeaterItem. The list of items is wrapped in an element with class repeaterList

<div id="catalogList" style="display:none;">
    <ul class="repeaterList">
        <li class="repeaterItem">
        </li>
    </ul>
</div>

• catalogDetail - This screen shows the details of an item.

<div id="catalogDetails" style="display:none;">
    <!-- your catalog details screen layout -->
</div>

Order Process Layout

tbd