Shoppers do NOT have to sign in to check ship rates.
When the Check Ship Rates link is clicked, a pop-up window is displayed, which contains a
      streamlined user interface for checking and comparing all configured shipping carriers and
      methods.
When checking rates for a specific product, any weight sensitive product attributes are
      automatically presented to the shopper, who can in turn check shipping prices for each
      attribute.
City, state, postal code, and country are the only information the shopper has to provide prior
      to checking rates.
The shopper only has to enter the above information once, and Streamlined Shipper™
      remembers her information for subsequent checks.
All configured shipping carriers and methods are neatly displayed in one radio-button list.
You can specify how you want the list sorted prior to retrieving the rates.
When a Check Rates button is clicked, the corresponding results are returned, with the rates
      appended to the right of each choice respectively, sorted by price.
Required fields are validated at the client via JavaScript, so that the shopper does not have to
      wait for the page to reload to discover his mistake.
Streamlined Shipper™ is fully compatible with all StoreFront™ 6.x configuration options and
      shipping methods (product, value and carrier based).

Installation
1) Implementation.
    a) Extract the zipped files from SRS2_x_x.zip to a temporary folder.
i) The files are organized into folders, which correspond to the website folder in which the file belongs,
the StoreFront™ type (SE or AE & XE), and the StoreFront™ version. For example:
ii) Note: You can determine your current StoreFront™ version by looking at the version information
inside the AssemblyInfo.vb file located within your web root.
b) Upload the following files (Note: No recompile is necessary for this installation).
i) Root folder:
(1) ShipRateShopper.aspx
(2) ShipRateShopper.aspx.js
ii) Bin Folder:
(1) StoreFront™ sites are configured differently depending on the web host. Some sites only have a root/bin folder, and other sites have both a root/bin folder and a root/ssl/bin folder.
(a) Root/bin folder only:
(i) Upload the following files from the unzipped bin folder to the root/bin folder of your
website:
1. PENDX.dll
2. PENDX_SRS.dll
(b) Root/bin folder and root/ssl/bin folder:
(i) Upload the following files from the unzipped bin folder to both the root/bin folder and
the root/ssl/bin folder of your website:
1. PENDX.dll
2. PENDX_SRS.dll
iii) Root/SSL Folder:
(1) Upload the following folder from the unzipped SSL folder to the root/ssl folder of your website:
(a) Management
c) Open the Streamlined Shipper™ Admin page.
i) Open a web browser and navigate to your StoreFront™ Merchant Tools page. Using the path that is in
the address bar of your browser, navigate to PENDX_SRSadmin.aspx.
ii) After the Admin page successfully loads in your browser, Streamlined Shipper™ is fully functional.
iii) You can perform the following actions from the Admin page:
(1) Generate your license key.
(2) Sort the carrier shipping methods.
d) Add Streamlined Shipper™ entries to the Web.Config file.
i) StoreFront™ sites are configured differently depending on the web host. Some sites only have a
root/Web.Config file, and other sites have both a root/Web.Config file and a root/ssl/Web.Config file.
(1) root/Web.Config file only:
(a) Add the entry to the root/Web.Config file.
(2) Both root/Web.Config file and root/ssl/Web.Config file:
(a) Add the entry to the root/Web.Config file.
(b) Also Add the entry to the root/ssl/Web.Config file.
ii) Add the following Web.Config Entry immediately above the <system.web> tag. (Note: If you already have an <appSettings> section in your Web.Config file, then just add the two <add> tags to the existing
<appSettings> section):
<appSettings>
<add key="PENDX.SRS.Installed" value="True" />
<add key="PENDX.SRS.License.Key" value="Trial" />
</appSettings>
iii) If you have already generated your license key, replace "Trial" (above) with "yourLicenseKey". You must do this within 5 days of your installation (Trial Period).
e) Copy and paste the following JavaScript definition (in bold below), replacing YourSite.??? with your actual
URL, as follows:
i) In an ASP.Net Control (file ending in .ascx). The preferred method is to add this JavaScript definition to
one control that is included in every StoreFront™ page, such as
web/CommonControls/TopBanner.ascx as follows:
(1) Paste the tag towards the top of the page, immediately following the registration tag(s). For
Example (TopBanner.ascx):
<%@ Control Language="vb" EnableViewState = False AutoEventWireup="false"
Codebehind="TopBanner.ascx.vb" Inherits="StoreFront.StoreFront.TopBanner"
TargetSchema="http://schemas.microsoft.com/intellisense/nav4-0" %>
<script language="javascript" src="http://YourSite.???/ShipRateShopper.aspx.js">
</script>
<asp:Label id="StoreName" runat="server" CssClass="TopBanner">StoreName</asp:Label>
<asp:Image id="StoreImage" runat="server" Visible="False"></asp:Image>
ii) In an ASP.Net Page (file ending in .aspx) or an HTML Page (files ending in .html or .htm)
(1) Immediately following the <Body> tag. For Example:
<body id="BodyTag" runat="server" class="GeneralPage">
<script language="javascript" src="http://YourSite.???/ShipRateShopper.aspx.js">
</script>
f) Copy and paste the Check Ship Rates hyperlink according to the target page as follows:
i) Search results:
(1) Determine the search results template that you selected in the Catalog Design (Template 1, 2 or 3).
(2) Find the corresponding control in the controls folder of your web-root:
(a) SearchTemplate1.ascx
(b) SearchTemplate2.ascx
(c) SearchTemplate3.ascx
(3) Using a Text or HTML Editor, paste the following tag wherever you want the link to be displayed
within the page, replacing YourSite.??? with your actuall URL:
<a
href=’http://YourSite.???/ShipRateShopper.aspx?ProductCode=<%#DataBinder.Eval(Cont
ainer.DataItem,"ProductCode")%>’ target="_blank" onclick="javascript:var hWin =
PENDX_PopUp(’http://YourSite.???/ShipRateShopper.aspx?ProductCode=<%#DataBinder
.Eval(Container.DataItem,"ProductCode")%>’, ’450’, ’366’,
’TOOLBAR=no,scrollbars=yes,resizable=yes,location=no’); hWin.focus(); return
false;">Check Ship Rates</a>
ii) Product Detail:
(1) Determine the product detail template that you selected in the Catalog Design (Template 1 or 2).
(2) Find the corresponding control in the controls folder of your web-root:
(a) ProductDetail1.ascx
(b) ProductDetail2.ascx
(3) Using a Text or HTML Editor, paste the following tag wherever you want the link to be displayed within the page, replacing YourSite.??? with your actuall URL:
<a href=’http://YourSite.???/ShipRateShopper.aspx?ProductCode=<%#
DataBinder.Eval(Product,"ProductCode") %>’ target="_blank" onclick="javascript:var
hWin = PENDX_PopUp(’http://YourSite.???/ShipRateShopper.aspx?ProductCode=<%#
DataBinder.Eval(Product,"ProductCode") %>’, ’450’, ’366’,
’TOOLBAR=no,scrollbars=yes,resizable=yes,location=no’); hWin.focus(); return
false;">Check Ship Rates</a>
iii) Product Bot or Any Other Page:
(1) When inserting the Check Ship Rates link into a Product Bot or any other page, you will need to
manually specify which products shipping rates are being checked, as follows:
(a) Replace both occurrences of <%#DataBinder.Eval( ,"ProductCode")%> with the actual
Product Code (the value of database field-name Code, not UID). For Example:
(b) Using a product with Product Code demo-product, the link would look like this:
<a href=’http://YourSite.???/ShipRateShopper.aspx?ProductCode=demo-product’
target="_blank" onclick="javascript:var hWin =
PENDX_PopUp(’http://YourSite.???/ShipRateShopper.aspx?ProductCode=demoPage
product’, ’450’, ’366’, ’TOOLBAR=no,scrollbars=yes,resizable=yes,location=no’);
hWin.focus(); return false;">Check Ship Rates</a>
iv) Checking ship rates for the entire shopping cart:
(1) Remove the ?ProductCode= query-string variable as follows:
<a href=’http://YourSite.???/ShipRateShopper.aspx target="_blank"
onclick="javascript:var hWin =
PENDX_PopUp(’http://YourSite.???/ShipRateShopper.aspx, ’450’, ’366’,
’TOOLBAR=no,scrollbars=yes,resizable=yes,location=no’); hWin.focus(); return
false;">Check Ship Rates</a>
g) Licensing Streamlined Shipper™.
i) Open Streamlined Shipper™ Admin page as described in sections c.i and c.ii above.
ii) Enter your email address, password and order number in the supplied fields, and then click the
Generate License Key button.
iii) Modify PENDX.SRS.License.Key in your web.config file(s), replacing the word Trial with your
newly generated license key.
(1) Important: License keys are specific to the SiteURL (case sensitive) as defined within
StoreFront™. If you ever change the SiteURL, you will need to reset
PENDX.SRS.License.Key back to Trial within your web.config file(s) and then
generate a new license key in Streamlined Shipper™ Admin page. Once you have
generated your new license key you can then reset PENDX.SRS.License.Key to the value
of your new license key.
2) Configuration Notes.
a) Streamlined Shipper™ automatically adds the following tables and views to your StoreFront™ 6
database, which are required for Streamlined Shipper™ to work:
i) Tables
(1) PENDX_Shipping
ii) Views
(1) PENDX_ShippingView
b) Important: Streamlined Shipper™ v2.0.5.1 incorporates changes to the above tables and views. If you are updating from an earlier v2.0 release, you will need to perform the following steps:
i) Within your web.config file(s), set key="PENDX.SRS.Installed" value="Update"
(1) Do this after uploading the new Streamlined Shipper™ files and before loading the Ship-Rate
Shopper™ Admin page.
ii) Load Streamlined Shipper™ Admin page.
(1) Once Streamlined Shipper™ Admin page successfully loads the update is complete.
iii) Within your web.config file(s), reset key="PENDX.SRS.Installed" value="True"
c) Important: If and only if you use Streamlined Shipper™ custom shipping methods feature (see Optional Features section 1), and you are updating from Streamlined Shipper™ v2.0.1.2 or earlier, then you will need to delete your existing PENDX_ShipMethods table and recreate it using the updated script or MS Access table. The data in that table will be lost, so be sure to save the data so that you can easily re-add it to the updated table.
d) The SRS2_x_x.zip file contains a text file named CopyAndPaste.txt, which includes all the things in this user guide that need to be copied and pasted. Often times, the correct format is not retained when copying and pasting from a PDF file, so we recommend using the CopyAndPaste.txt file.
e) You can adjust the size of the pop-up window by modifying the existing values within the above tags (’450’, ’366’), which correspond to pixel height and width.
i) You may also need to adjust the table height within the ShipRateShopper.aspx file.
f) The colors in the pop-up window represent whatever is defined within StoreFront™ for TopSubBanner, LeftColumn, RightColumn and Footer.
g) If you are configuring StoreFront™ shipping for the first time, dont forget to specify the Ship From Address. Carrier-based rates will fail if no Ship-From address is specified.
h) Carrier based rates will not be returned for items with zero (0) weight. Make sure that all of your product weights are defined if you are using carrier based shipping.
i) If you have specified that Free_Ship_By_Product="True" (See Parameter Definitions) then:
i) Regardless of the configured ship method, if a products ship price is defined as 0 (zero), that product will be treated as Free Shipping product.
This gives you the ability to run free shipping promotions on an individual product basis.

Parameter Definitions
The following parameters can be added to the <PENDX:SRSProperties> tag in the ShipRateShopper.aspx page. For example:
<PENDX:SRSProperties Default_State="Not Applicable" id="ccUserProperties" runat="server">
The values specified below represent the default values that will be used if the parameters were not specified.

1) Default_State="Not Applicable"
a) Specifies which state will automatically be selected in the State/Province dropdown lists.
b) This value must match (case sensitive) a state within the SelectState table of the StoreFront™ database.
c) To disable this option, set the value to "none".

2) Default_Country="United States"
a) Specifies which country will automatically be selected in the Country dropdown lists.
b) This value must match (case sensitive) a country within the SelectCountry table of the StoreFront™ database.
c) To disable this option, set the value to "none".

3) Standard_Shipping_Label="Best-Way Ground"
a) Specifies the label that will be used for non carrier-based standard shipping (product-based or value-based)

4) Free_Shipping_Label="Free"
a) Specifies the label that will be used when a shoppers cart qualifies for free-shipping.

5) UPS_Residential = "true"
a) This applies to StoreFront™ versions 6.1.1 and above, and it specifies whether UPS will calculate residential rates rather than commercial rates.

6) Adjust_Weights="false"
a) *FEDEX rate servers will not return a rate for cart items that have a total weight (item * quantity) of less than 1 pound. When Adjust_Weights="true", Streamlined Shipper™ will **automatically adjust the weight of individual cart items weighing less than 1 pound, so that the total weight (item * quantity) = 1 pound. If you do not have FEDEX enabled, or you have no products in your database that way less than 1 pound, set Adjust_Weights="false", and this step will be skipped. Note: Regardless of the value of Adjust_Weights, this step will not be performed for UPS rates because UPS handles this automatically.
*This will also work with any other rate server that will not handle weights les than 1 pound.
**Item weights are not permanently changed. This is only for purposes of acquiring ship rates.

7) Shipping_Base_Rate=""
a) This applies to carrier-based rates, and it allows you to specify a base carrier rate that must always be present.
b) The rate specified must be identical (case sensitive) to a value that is marked as active in the Shipping table.
c) If the carrier results do not include the value specified in Shipping_Base_Rate, backup shipping will be added to the list of carrier results. The idea being what if the carrier results only contain expensive, air shipping choices. This is possible if your active shipping methods were UPS Ground, FEDEX 2day, FEDEX Express Saver, and FEDEX Overnight. If the UPS server were down, your only choices would be the expensive FEDEX Air choices.
d) Use caution with this parameter. If Shipping_Base_Rate="UPS Ground" and your shopper lives in Hawaii, UPS Ground will not be returned, because you cant ship ground to Hawaii. In this scenario, you would not want backup (ground) shipping to be added to the carrier results.

8) Email_Errors="true"
a) This option allows any Streamlined Shipper™ errors that occur (fatal or non-fatal) to be emailed to PENDX Corporation in real time. This allows PENDX to proactively address unforeseen problems and distribute the appropriate patches and updates. In case of an error, the following information will be sent:
i) Your Store Name and URL.
ii) The URL of the page that immediately preceding the error.
iii) The error description.
b) Please leave this option set to "true", as it is a very valuable debugging tool. If you have privacy concerns regarding this option, please email us at service@pendx.com. We employ strong measures to protect the privacy of our customers.

9) Base_Carrier_Rates="03;1010;Parcel;FDXGD92"
a) This specifies which carrier rates will not be displayed if the order qualifies for free shipping. The values separated by semi-colons represent entries in the Shipping Table of the StoreFront™ database (the uid column). The default values specify all of the ground carrier methods. Therefore if the order qualifies for free shipping, only the expedited carrier methods will be displayed along with the free shipping option.

10) Base_Custom_Rates="1"
a) This option only applies if Custom_Ship="true".
b) This specifies which custom rates will not be displayed if the order qualifies for free shipping. The values separated by semi-colons represent entries in the PENDX_ShipMethods Table of the StoreFront™ database (the keyID column). The default value specifies first entry in the table.

11) Incremental_Premium="[Premium Shipping amount as specified in Merchant Tools]"
a) This applies to the Premium Shipping option, which is available if you are using Product or Value based shipping (as defined in Merchant Tools).
b) The incremental rate is applied when multiple quantities of the same item are added to the cart. The Premium amount will be applied to the first item, and the amount specified for Incremental_Premium will be added for each additional quantity of the same item.

12) Premium_Calc="order"
a) This applies to the Premium Shipping option, which is available if you are using Product or Value based shipping (as defined in Merchant Tools).
b) The Premium amount can be calculated per order or per cart item. Valid values for the parameter are:
i) "order" (default)
ii) "item"

13) Free_Ship_By_Product="false"
a) Setting this parameter to "true" allows you to specify free shipping per individual product by setting the Ship Price of the respective product(s) to zero (0) within the Products/Fulfillment section of Merchant Tools.

14) Custom_Ship="false"
a) If you have configured PENDX Custom Shipping methods (see Optional Features section 1), set this value to "true".

15) AlterXcarrierResults="false"
a) Setting this parameter to true allows you to alter the extended carrier results that are returned by the USPS International and FreightQuote carrier methods. Optional Features section 2 must be completed prior to activating this feature.

16) Backup_Shipping_Message
a) This parameter allows you to change the message that is displayed when backup shipping methods are displayed.

17) ShipCalcA_Minimum
a) This parameter allows you to change the minimum product ship-price that must be exceeded prior to the product ship price being added to the value-based rate, when using custom shipping calculation method A (see Optional Features section 3). The default is the shipping minimum as specified in StoreFront™ Merchant Tools.

18) Show_SFCarrierBackup="true"
a) Setting this parameter to false will prevent the standard StoreFront™ backup shipping methods from being displayed to the shopper. You must first define custom backup shipping methods to replace the standard StoreFront™ methods (see Optional Features section 3).

Optional Features
1) Define Custom Shipping Methods. Streamlined Shipper™ allows you to optionally define an unlimited number of custom shipping methods that can stand alone or co-exist with StoreFront™s carrier-based shipping methods. Any or all of the custom shipping methods, when combined with StoreFront™ carrier-based shipping, can be used to increase (or replace) the number and type of backup shipping options available to the shopper when carrier rates cannot be retrieved. To specify that a particular custom shipping method should only be available as a backup choice, include the keyword [BACKUP] (including the brackets) in the description.

To configure custom shipping methods, complete the following steps:
a) Add the PENDX_ShipMethods table to your StoreFront™ database as follows:
i) MS Access:
(1) Open your database in Microsoft Access™ and click on Tables in the left navigation bar.
(2) Right click in the white space of the Microsoft Access™ window and select Import from the
pop-up menu.
(3) Browse to the location of the unzipped Streamlined Shipper™ files and select the CustomShip.mdb
database.
(4) Select the PENDX_ShipMethods table and click the OK button. The PENDX_ShipMethods table
has now been added to your database.
ii) MS SQL Server
(1) Connect to your database with SQL Server Enterprise manger or the SQL query tool of your
choice.
(2) Execute the SQL script contained in the PENDX_ShipMethods.sql file, which was unzipped with
Streamlined Shipper™ files. The PENDX_ShipMethods table has now been added to your
database.
iii) From within Streamlined Shipper™ Admin page, add new records to the PENDX_ShipMethods
table as follows:
iv) Description
(1) This is the description of the custom shipping method, e.g. Custom Ground.
(a) To specify that a particular custom shipping method should only be available as a backup
choice, include the keyword [BACKUP] (including the brackets) in the description as follows:
(i) Custom Ground[BACKUP]
(b) To completely replace the standard StoreFront™ backup shipping methods set
Show_SFCarrierBackup="false" in the <PENDX:SC> tag (see Parameter Definitions 18).
v) SFCarrierCode
(1) This field is optional and allows you to associate a StoreFront™ carrier code with the custom
shipping method. Association with a valid StoreFront™ carrier allows the order tracking feature to
work with the custom method.
vi) Type
(1) This specifies how the shipping rate should be calculated as follows:
(a) F = Fixed rate per item
(b) O = Flat rate per order
(c) P = Product based (the value specified for Ship Price in the Products/Fulfillment section of Merchant Tools)
(d) V = Value based (as specified in the value-based shipping table within Shipping/Value Shipping of Merchant Tools).
(e) A = Value + Product based
(i) This calculation begins with value-based and then adds the respective product(s) ship
price to the value-based amount, as long as the respective product(s) ship price exceeds a
certain minimum.
1. The minimum can be defined with the ShipCalcA_Minimum parameter. The default
is the shipping minimum as specified in StoreFront™ Merchant Tools.
(f) W = Fixed Rate for the first item
(i) This calculation charges a fixed rate for the first item in the cart and then adds the
incremental rate for all additional items in the cart.
vii) Rate
(1) This is the rate for the shipping method.
(a) For Types P, V and A, this value is added to the product or value rate specified in the shipping
section of Merchant Tools.
viii) Incremental Rate
(1) This value is used for quantities greater than 1 of an individual product.
(a) Example: If you wanted the first product to be $10 and each additional quantity of the same
product to be $2, you would specify Rate and IncrementalRate as follows:
(i) Rate = 10
(ii) IncrementalRate = 2
(b) For calculation type P (Product based), setting the incremental rate to -1 will cause the
incremental rate to equal the product ship price.
ix) LocationConstraint
(1) This specifies the type of location constraint applied to this shipping method as follows (see
Optional Features section 4 in the Streamlined Checkout™ user guide):
(a) N = (None) no geographical constraints apply (default)
(b) I = (Include) only allow shipping to locations that are specified in the
PENDX_LocationConstraints table.
(c) E = (Exclude) do not allow shipping to locations that are specified in the
PENDX_LocationConstraints table.
x) ConstraintType
(1) This specifies which value will be used to check the location constraint (see Optional Features
section 4 in the Streamlined Checkout™ user guide) as follows:
(a) 1 = Postal Code
(b) 2 = State (default)
(c) 3 = Country
xi) IsActive
(1) This specifies whether or not the method is active.
(a) MS Access
(i) True = active, False = inactive
(b) SQL Server
(i) 1 = active, 0 = inactive
xii) SortOrder
(1) A value from 0 to 255 that specifies the order of the shipping method within the shipping methods
list displayed to the shopper. The default vale is 255.
b) Set Custom_Ship="true" in the <PENDX:SC> tag (See Parameter Definitions number 14).
2) Alter Extended Carrier Results. This feature allows you to alter the extended carrier results that are returned by the StoreFront™ USPS International and FreightQuote carrier methods. You can alter the price and descriptions, or you can eliminate one or more results from the list of shipping methods presented to the shopper. To activate this feature, complete the following steps:
a) Add the AlterXcarrierResults table to your StoreFront™ database as follows:
i) MS Access:
(1) Open your database in Microsoft Access™ and click on Tables in the left navigation bar.
(2) Right click in the white space of the Microsoft Access™ window and select Import from the
pop-up menu.
(3) Browse to the location of the unzipped Streamlined Shipper™ files and select the CustomShip.mdb database.
(4) Select the AlterXcarrierResults table and click the OK button. The AlterXcarrierResults table has
now been added to your database.
ii) MS SQL Server
(1) Connect to your database with SQL Server Enterprise manger or the SQL query tool of your
choice.
(2) Execute the SQL script contained in the AlterXcarrierResults.sql file, which was unzipped with
Streamlined Shipper™ files. The AlterXcarrierResults table has now been added to your
database.
b) Add new records as necessary to the AlterXcarrierResults table as follows:
i) CarrierResult
(1) This is the description of the extended result that you want to alter. This value must exactly match (case sensitive) the result as returned in the Shipping Methods list in the Order Information page (excluding the price preceded by one space). The best way to ensure an exact match is to copy the description from the HTML source by clicking the View Source menu item from within your
web browser.
(a) When the Check Rates button is clicked from within the Order Information page, the price
preceded by one space is appended to the respective descriptions. When copying the shipping
method description from your browsers HTML source view, remember to exclude the price
and the one space that precedes the price.
ii) DisplayName
(1) This value is optional and allows you to change the description that is displayed to the shopper. If you do not wish to change the description, leave this value blank or null.
iii) AdjustType
(1) This value defines how the result should be altered as follows:
(a) P
(i) Adjust the rate by adding the specified percentage. For example: if the returned rate were
$20 and you specified 20 in the AdjustAmount column (column iv below), the price
displayed would be $24 (20 + (20 *(20/100)). Specifying a negative value in the
AdjustAmount column (column iv below) will subtract the percentage.
(b) D
(i) Adjust the rate by adding the specified dollar amount. For Example: if the returned rate
were $20 and you specified 5 in the AdjustAmount column (column iv below), the price
displayed would be $25. Specifying a negative value in the AdjustAmount column
(column iv below) will subtract the dollar amount.
(c) X
(i) Exclude the result from the list of shipping methods displayed to the shopper.
iv) AdjustAmount
(1) The decimal amount to adjust the rate by. This value represents either a percentage or a dollar
amount depending on the value of AdjustType as defined above.

Digital Beach

 Digital Beach provides advanced Ecommerce and Internet Marketing services to a wide range of companies from small merchants to medium and large corporate clients.

Digital Beach has been delivering Streamlined Checkout™ with the StoreFront™ cart as part of an overall eCommerce solution to online merchants since both products appeared on the market some three years ago.  Nearly two years ago, we decided we liked the product so much, we bought the company.
More about Digital Beach